Programando os Eventos

Os eventos são a função principal para você que deseja programar funções para acontecerem em um determinado horário. Neles você pode programar suas playlists, blocos comerciais, comandos, entre outros.

Você pode visualizar os eventos indo na aba de "Eventos" na tela principal do Salamandra. Lá você encontrará os botões para operar os eventos.

Lista dos Próximos Eventos
Lista dos Próximos Eventos
  1. Tocar eventos atrasados - Caso tenham eventos com o status de "Atrasado", este botão poderá ser utilizado para iniciar os eventos.
  2. Descartar eventos atrasados - Caso tenham eventos com o status de "Atrasado", este botão poderá ser utilizados para excluí-los da fila.
  3. Ativar/desativar eventos - Este botão poderá ser utilizado para ativar ou desativar os eventos, para que eles não sejam disparados.
  4. Editor de Eventos - Este botão serve para abrir o Editor de Eventos, onde você criará sua programação.

Informação

Note que ao desativar e depois reativar, os eventos atrasados serão descartados por padrão. Você pode modificar esse comportamento nas configurações gerais.

Lista de Eventos

Para começar a editar os eventos, você deverá clicar no Editor de Eventos (4). Assim, se abrirá para você a listagem de eventos cadastrados.

Lista de Eventos
Lista de Eventos Cadastrados

Note que a listagem dos eventos tem 3 seções.

  1. Ações Gerais - Botões para Criar, Editar e Deletar um Evento, Salvar ou Cancelar as mudanças feitas nos cadastros e Abrir/Salvar o Cadastro de Eventos em um arquivo.
  2. Grupos de Eventos - É possível criar ou excluir Grupos de Eventos, para separá-los em grupos, como por exemplo: Comerciais, Playlists, etc. Grupos funcionam apenas ao salvar os eventos como .slsche.
  3. Listagem de Eventos - Aonde são listados os eventos que você tem cadastrado. Eventos expirados aparecerão em cinza.

Atenção

Os eventos são guardados e carregados de arquivos com as extensões .sche ou .slsche. Assim como as playlists, é necessário preservar o arquivo para manter os eventos funcionando no Salamandra.

Caso você delete o arquivo dos eventos no seu sistema, quando você abrir o Salamandra novamente, os eventos não estarão lá.

Após criar seus eventos, é necessário clicar no botão Confirmar para salvá-lo! Se você clicar no botão Cancelar, ou no botão de Fechar (X), todas as suas alterações serão perdidas.

Ao salvar da primeira vez, o Salamandra pedirá para escolher um caminho onde será salva a lista de eventos. Se você ignorar este salvamento, ao fechar o Salamandra, seus eventos irão se perder.

Para criar seu primeiro evento, clique no botão Adicionar.

Cadastro de Evento

Ao adicionar um novo evento, você verá a tela abaixo. Vamos explicar cada opção uma por uma.

Edição de Evento
Edição de Evento

Data e Hora

Data e Hora de Eventos
Data e Hora de Eventos

Em Data e Hora de Início você pode colocar a data e a hora onde o evento irá começar a tocar. É possível colocar uma data futura, caso você esteja programando agora um evento que sairá em um outro dia.

A opção de Imediato significa que o evento entrará no ar exatamente no horário agendado. isso quer dizer que qualquer faixa que esteja tocando será cortada para a entrada do evento! Se você deseja que a faixa toque até o final para que o evento entre após, não marque esta opção.

Eventos imediatos também disparam o Player caso este esteja parado. Eventos que não são imediatos não iniciam o player e aguardam a intervenção do usuário ou que um evento imediato faça o disparo.

Ativando a Data e Hora de Expiração você pode colocar a data e a hora onde aquele evento não estará mais em vigor, após esta data, o Salamandra considerará o evento como inativo.

Informação

Digamos que um evento tenha uma programação para tocar as 10h de 01/01/2025 e tenha a expiração para 11h de 01/01/2025, porém este evento tem uma duração de 3h, o que significa que ele tocará até as 13h.

O Salamandra não irá interromper o evento durante a sua execução. Os eventos que expiram enquanto eles ainda estão tocando continuarão até o fim normalmente. A expiração tem apenas a função de ser a data em que o Salamandra deixará de considerar este evento para colocar na fila de Próximos Eventos a serem executados pelo Player.

Horários

Quando marcamos Outros Horários, indicamos ao Salamandra que queremos que o evento toque em mais horários do que o configurado na parte de Data e Hora. No exemplo abaixo, temos marcados as horas 08h, 10h, 12h e 14h, serão nestes horários que o evento será disparado.

Outros Horários
Opção de Outros Horários

Note que o horário original muda para --:00:00, isto significa que o evento tocará em todos os horários neste tempo: 08:00:00, 10:00:00, 12:00:00 e 14:00:00. Você pode colocar os minutos e segundos de acordo com o que desejar.

Se você precisa que o evento toque apenas em um único horário, não marque esta opção. O Salamandra então irá disparar o evento somente no horário definido na parte de Data e Hora.

Dias da Semana

A opção Dias da Semana, torna o agendamento do evento recorrente nos dias da semana selecionados. No exemplo abaixo, temos marcados os dias de Segunda a Sexta, o evento então será disparado quando estiver nestes dias da semana.

Dias da Semana
Opção de Dias da Semana

Quando você marca esta opção, você indica ao Salamandra que deseja que o evento toque em mais dias do que só o configurado em Data e Hora de Início. Caso você deseje que o evento toque apenas naquele dia específico, não marque esta opção.

Se não houver uma Data de Expiração definida para o evento, com a opção de Dias da Semana ativo, ele ficará agendado até que seja desativado manualmente.

Opções Avançadas

Ao clicar nas Opções avançadas, você verá o menu abaixo. Essa opções não são para todos os eventos, mas para eventos especiais que você deseja colocar recorrente em um único dia de todo mês ou um período específico do mês.

Opções Avançadas
Opções Avançadas de Programação

Ao ativar a opção de "Qualquer Ano", você verá que a parte que representa o ano ficará com a forma "____". Isso significa que o ano será dinâmico.

No exemplo abaixo, no ano de 2025, o Salamandra interpretará para este evento o início dele como 01/12/2025, em 2026, 01/12/2026, e assim por diante.

Opções Avançadas
Opção "Qualquer Ano" ativada.

A opção funciona do mesmo modo para a data de expiração, possibilitando que você possa combinar uma Data de Início e de Expiração. Um exemplo de uso seriam datas comemorativas como Natal e Ano Novo, para programar mensagens ou vinhetas especiais.

Com essa opção você poderia fazer um evento como abaixo, programado de 01/12/---- a 26/12/----. Assim, não haveria a necessidade de todo ano editar os eventos para atualizar as datas para um novo ano.

Opções Avançadas
Opção "Qualquer Ano" ativada na Expiração.

A opção de "Qualquer mês" funciona do mesmo modo, trabalhando com o mês. Esta opção também libera o "Dia especial do mês", para caso você queira fazer um evento relacionado aos três últimos dias do mês.

Opções Avançadas
Opção "Qualquer Mês"

Caso você não use a opção de dia especial do mês e agende para o dia 31, por exemplo, o evento não rodará em meses que são de 30 ou 28 dias. Se você deseja que toque no último dia do mês, independente do mês, terá que usar a opção de "Último dia do mês".

É possível também combinar as opções de "Qualquer mês" e "Qualquer ano". A combinação é apenas necessária se você desejar colocar uma Data de Expiração, mas ainda assim deseje que os eventos também rodem independente do ano.

Atenção

As opções avançadas necessitam de uma atenção especial ao serem programadas, para evitar confusões. De uma forma geral, elas não são necessárias para a maioria dos eventos, pois as opções normais do evento já farão a recorrência do evento e serão o suficiente para grande parte da sua programação.

Use estas opções para datas especiais, como programações para datas comemorativas fixas, como Dia das Mães, Natal ou Ano Novo, entre outros. As opções de "Qualquer Mês" também são interessantes para mensagens ou vinhetas especiais de início do mês, com você podendo criar um evento que inicie dia 01 e expire dia 05, por exemplo.

Tipo do Evento

Na opção de Tipo de Evento, você pode selecionar qual é o comando ou tipo de faixa que você deseja que o Salamandra execute no seu agendamento. Eles funcionam da mesma forma que os tipos de faixas da Playlist.

Tipo do Evento
Tipo do Evento
  1. Selecionar caminho do arquivo ou URL de stream da internet.
  2. Editar atributos para tipos de evento que os tem.

Ordenação e Prioridade

Ordem do Evento

A ordem do evento é um número que varia de 0 a 99, com todos os eventos começando com 50 por padrão. Se um ou mais eventos compartilharem exatamente o mesmo horário, essa é uma opção para customizar a ordem destes eventos de acordo com a sua necessidade.

Ordem do Evento
Opção "Ordem do Evento"

Observe o exemplo abaixo. Todos os eventos compartilham o mesmo horário, 10:45:00, com dois anúncios de mercado um seguido do outro. Por não ser interessante ter dois anunciantes do mesmo seguimento tão próximos, é possível utilizar a opção de Ordem do Evento para isso.

Exemplo de Ordenação dos Eventos
Exemplo de Ordenação dos Eventos

Podemos então pegar um dos mercados, neste caso o Mercado 24 Horas e modificar este valor para um valor menor, como 40. Após essa alteração, os eventos então serão reposicionados na fila de Próximos Eventos, ficando desta forma:

Exemplo de Mudança na Ordem dos Eventos
Exemplo de Mudança na Ordem dos Eventos

Assim conseguimos evitar que anúncios de concorrentes sejam anunciados um seguidos do outro, com um maior controle dos eventos. Essa opção pode ser utilizada também para ordenar comandos para o player que devam ser executados em uma ordem específica, entre outros.

Informação

É possível também arrastar os eventos na Lista de Eventos Cadastrados para que eles fiquem numa ordem desejada, porém, esta forma não é recomendada. Ao clicar no cabeçalho da lista (onde diz Hora, Modo, Prioridade, Arquivo, etc), você reordena os eventos, mudando a ordem que foi feita previamente.

Definir a ordem dos eventos pela lista significa que você não poderia utilizar esse recurso, por exemplo, para ordenar os eventos por ordem alfabética, o que tornaria mais fácil encontrar um evento pelo nome. Além disso, um clique acidental no cabeçalho da lista poderia desfazer a ordem previamente definida, causando uma ordenação indesejada.

Perceba que no exemplo acima o evento de Locução de Hora ainda continuou no topo. Isso é por ele ser um evento Imediato. Para eventos que tem exatamente o mesmo horário, a ordenação é definida na seguinte prioridade:

  1. Forma de disparo (Imediato ou Não).
  2. Ordem do Evento (ordem crescente).
  3. Posição na Lista de Eventos (de cima para baixo).

Prioridade do Evento

As prioridades do evento são uma ferramenta utilizada para descartar eventos automaticamente, quando um evento de menor prioridade estiver sendo executada. Por padrão, todos os eventos vem como Prioridade Baixa.

Ao estar executando um evento de prioridade alta, os outros eventos de prioridade baixa serão descartados. Eventos de prioridade igual não são descartados por outros eventos, apenas os com prioridade menor.

Prioridade do Evento
Opção "Prioridade do Evento"

Acompanhe o exemplo abaixo para um melhor entendimento. Temos um evento Mesa Redonda, que é um programa pré-gravado, agendado para entrar as 13:15. Perceba que também há um evento de Locução de Hora para o mesmo horário, ambos os eventos sendo Imediato.

Exemplo de Prioridade do Evento
Exemplo de Prioridade do Evento

Observe que o evento de Mesa Redonda está com um ícone vermelho ao lado, que indica sua prioridade como alta. Já os outros eventos estão com um ícone verde, que indica sua prioridade como baixa.

Isso significa que quando chegar nos horários dos eventos de prioridade baixa, caso o Mesa Redonda ainda esteja tocando, estes outros eventos serão automaticamente descartados.

Ou seja, se o Mesa Redonda tiver uma duração de 1h, tocando de 13:15 até 14:15, todos os eventos que surgirem nesse intervalo de tempo serão descartados de forma automática.

Caso as 14:00 seja incluido um outro evento também com prioridade alta na fila de Próximos Eventos, ele não será descartado, por ter a mesma prioridade alta. O novo evento irá aguardar ou interromper o Mesa Redonda, dependendo de ser um evento Imediato ou não.

Atenção

Em agendamentos rotineiros, é recomendado deixar sempre a prioridade como baixa. No geral, ao programar seus eventos, você terá uma ideia se eventos vão concorrer pelo mesmo horário ou não e poderá evitar essa situação.

O exemplo acima é apenas uma demonstração. No geral, se já é planejado em minha rádio ter um programa ou retransmissão entre as 13:15 e 14:15, não haveria a necessidade de eu criar outros eventos para o mesmo horário.

Essa opção pode ser interessante por exemplo, em um caso extraordinário. Digamos que você retransmita a Voz do Brasil as 19h, mas em um certo dia não tenha conseguido fazer isso e decida retransmitir gravada as 21h.

Você poderia apenas agendar um evento para as 21h com prioridade alta, assim não precisaria se preocupar em ativar/desativar os outros eventos que estariam nesse horário das 21h, já que eles seriam automaticamente ignorados.

Por situações como esta, é recomendado deixar a prioridade como baixa em todos seus eventos, reservando a prioridade alta apenas para estas situações extraordinárias.

Espera Máxima

Ao ativar a opção de Espera Máxima, você pode definir um tempo máximo em que o evento irá esperar para executar uma ação. Essa opção serve apenas para eventos não imediatos.

Espera Máxima
Espera Máxima

Por exemplo, caso o evento comece as 13:15, mas você deseje que ele entre no ar no máximo até as 13:20, é possível definir um tempo de 5 minutos para espera. Você poderá então escolher a ação do evento, para ele ser descartado, ou executar, interrompendo o que estiver no ar.

Nome do Evento

Por padrão, o Salamandra usará o nome do arquivo como nome do evento. Mas se você desejar criar um nome customizado, principalmente para URLs, é possível ativar essa opção e escrever o nome.

Nome do Evento
Nome do Evento

O nome escolhido também será o que irá aparecer na Lista de Eventos Cadastrados e na fila de Próximos Eventos.

Informação

O nome do evento servirá para exportação de metadados apenas se você estiver agendado um arquivo de áudio ou stream da internet. Caso você defina o nome de uma playlist, independente do formato, este nome não será exportado! A prioridade de exportação para metadados é do nome da faixa que está realmente sendo reproduzido pelo player.

Bloquear Controles

Junto ao nome do evento, também é possível ativar uma opção de Bloquear controles do player enquanto o evento estiver tocando. Ao ativar essa opção, caso o evento toque, os controles do player ficarão desativados para a operação manual.

Para ativar os controles novamente, é necessário usar o botão de cadeado nos controles da playlist.