Documentação para Locutores

1. Visão geral

O Play258 é um playout de rádio para emissão profissional: playlist, vinhetas, síntese de voz (TTS), integração com pedidos de música (pagos ou gratuitos) via backend, streaming (Icecast/Shoutcast) e relatórios de execução. Este guia foi escrito para locutores e operadores que usam o software no dia a dia.

Se esta documentação estiver desactualizada, contacte o administrador técnico da rádio.

2. Requisitos mínimos

3. Primeiro acesso e configuração

3.1 Activação da licença

Na primeira execução (ou se a licença tiver sido removida), o Play258 pede a activação com um token. O token é enviado por e-mail/SMS ao responsável da rádio. Introduza-o no formato PLAY-258-XXXX-XXXX-XXXX (23 caracteres). Após activar, a licença fica guardada no computador; em modo offline o software continua a funcionar durante o período de graça configurado (ex.: 32 dias), com avisos para reconectar.

3.2 Configurações da rádio

Abra Ficheiro → Configurações. As abas principais são:

• Rádio — Nome da rádio, sigla, NUIT, contactos (telefone, e-mail, redes sociais), frequência e logotipo.
• Classificação — Estrutura e classificação da rádio, línguas activas e blocos de spots por hora/língua.
• Localização — Endereço e coordenadas da rádio. A captura automática usa os serviços nativos do sistema operativo e, depois do primeiro envio bem-sucedido, deixa de reenviar automaticamente.
• Play258 — URL da API, activação de pedidos de música, palavra-chave e pasta de pedidos. Essencial para receber pedidos dos ouvintes.
• Notificações — Contactos para alertas de silêncio (off-air) e testes de SMS via backend.
• Sistema — Dispositivo de saída principal, Cue, visibilidade de abas, modo playlist leve e opções visuais/comportamentais da playlist.
• Streaming — Servidor (Icecast ou Shoutcast), host, porta, mount, utilizador e senha. A URL de reprodução para os ouvintes pode ser sincronizada com o backend.
• Logs — Pasta de logs e sincronização com o servidor.
• Sinal Horário — Activação, modo automático/manual, ducking e escolha do pacote de voz.

3.3 Importar relatórios Zara Radio

Em Ficheiro → Importar relatórios Zara Radio pode importar ficheiros .log do Zara Radio. Seleccione uma pasta (todos os .log na pasta são importados) ou ficheiros .log específicos. Durante a importação é mostrada uma barra de progresso; ao terminar, um resumo indica quantas linhas foram importadas e o intervalo de datas (por exemplo «X linhas de dia Y a dia Z»). Os logs são sincronizados com o backend após a importação.

Preencha pelo menos o nome da rádio e a URL da API para que pedidos e actualizações funcionem.

4. Interface principal

A janela do Play258 está organizada em:

• Barra de menu — Ficheiro (adicionar/abrir/guardar playlist, Catalogador, Importar relatórios Zara Radio, Configurações), Vinhetas (gerar TTS, adicionar/remover áudio, cores), Ajuda (esta documentação, actualizações).
• Barra de ferramentas — Botões Adicionar, Guardar e Abrir playlist; menu da Ordem de leitura (Manual, Sequencial, Aleatório, Repetir); botão de sinal horário (se activado); seletor de pacote do sinal horário; volume e Fundo; relógio e avisos; Configurações.
• Separadores (tabs) — Playlist (lista de reprodução e controles), Agendar (programação de spots/vinhetas), AI DJ (piloto automático), Play258 (pedidos de música), Logs, Comunicados.
• No separador Playlist: lista de faixas, botões Play/Stop, Pausar, Anterior/Próxima, Fundo, opção Auto Remover, grelha de 8 vinhetas, painel «A tocar» / «Próxima» / tempo restante e barra de progresso com onda.

5. Playlist e ficheiros

Adicionar músicas

• Menu — Ficheiro → Adicionar músicas ou botão Adicionar na barra: escolha ficheiros MP3, WAV ou OGG e são acrescentados ao fim da playlist.
• Arrastar e soltar — Arraste ficheiros ou pastas da área de trabalho para a lista da playlist.

Reordenar e editar

Arraste itens dentro da lista para mudar a ordem. Clique com o botão direito numa faixa para aceder ao menu de contexto: Mover para cima, Mover para baixo, Cue (pré-escuta noutra saída), Parar cue, remover da playlist, etc.

Duplo clique na playlist: a ação é configurável em Configurações → Sistema, no campo “Duplo clique na playlist”. Existem dois modos: Marcar como próxima (padrão recomendado, não interrompe a faixa atual) ou Tocar imediatamente.

Guardar e abrir playlist

• Guardar playlist — Ficheiro → Guardar playlist ou botão Guardar. Grava a lista actual (e a posição de reprodução) num ficheiro .playlist ou .json.
• Abrir playlist — Ficheiro → Abrir playlist ou botão Abrir. Carrega uma playlist guardada; pode substituir a actual ou acrescentar.

A playlist guardada inclui o estado (faixa actual, posição), para continuar mais tarde de onde parou.

Opções úteis da playlist

• Auto Remover — Quando activo, a faixa normal é removida da playlist depois de tocar.
• Modo playlist leve — Reduz cálculos visuais e metadados extra em máquinas mais fracas.
• Sugestão de correção de nomes — Ao adicionar ficheiros, o playout pode sugerir nomes mais legíveis quando encontra underscores ou sufixos estranhos no nome do ficheiro.

Sinal horário e eventos programados

Por baixo da faixa em execução, a playlist mostra linhas especiais: sinal horário (quando está próximo de tocar) e eventos programados (spots, vinhetas ou carimbos agendados). Estas linhas têm altura ligeiramente maior para melhor leitura.

6. Controles de reprodução

A barra de progresso mostra a onda e a posição na faixa; pode clicar ou arrastar para avançar/recuar (seek).

7. Modos de leitura

O botão Ordem na barra (ou menu associado) define como a playlist avança:

Para emissões contínuas com pedidos Play258, o modo Repetir continua a ser o mais recomendado.

7.1 Programação de publicidade (spots)

Os spots podem vir do sistema comercial (campanhas) ou ser uma lista simples configurada localmente no separador Agendar:

• Spots de campanha — São programados por dias da semana, datas e horários no sistema comercial. Para o locutor, a regra prática é:
  • Se vir apenas horas inteiras (por exemplo 9 ou 9,14,18), significa que a publicidade deve entrar nessa hora. Assim que a música anterior terminar dentro dessa hora, o Play258 lança o bloco de spots.
  • Se vir horários com minutos (por exemplo 9:45 ou 9:45,12:30), o Play258 tenta inserir o bloco o mais perto possível dessa hora. Se a música anterior for longa, o sistema aceita um atraso de até 7 minutos; depois disso, esse horário é ignorado nesse dia.
• Spots simples (lista local) — Continuam a obedecer ao campo “Spots a cada X músicas”: depois de X músicas tocadas, e se não houver uma campanha marcada para esse momento, o Play258 insere um spot dessa lista.

Resumindo: a publicidade de campanha tenta sempre respeitar a data e a hora programadas (com pequena tolerância por causa da música anterior). A publicidade simples continua a seguir o número de músicas definido pelo operador.

7.2 Fluxo de programação de eventos na emissão

Para o locutor, o fluxo prático de eventos no Play258 funciona assim:

Boa prática: antes de entrar no ar, confirme no separador Agendar se as vinhetas, carimbos e spots simples estão carregados e se a visualização dos eventos agendados está no modo mais confortável para o operador.

8. Vinhetas (Cartwall)

Oito botões de acesso rápido permitem tocar vinhetas (identificação, transições, etc.) sem parar a playlist.

Atribuir áudio

• Arrastar e soltar — Arraste um ficheiro de áudio para um dos 8 botões.
• Menu Vinhetas — Vinhetas → Adicionar áudio escolhe o botão e o ficheiro; Remover áudio limpa o botão.

Cor e comportamento

Clique com o botão direito num botão para aceder ao menu (remover, cor de fundo). Em Vinhetas → Cor do fundo pode definir a cor por botão (Vinheta 1 a 8). Enquanto uma vinheta toca, o botão indica progresso e pode piscar.

O nome do ficheiro atribuído aparece no botão (sem extensão, truncado com «…» se for longo); o tooltip mostra o caminho completo ao passar o rato.

Atalhos

As teclas 1 a 8 tocam as vinhetas 1 a 8, respetivamente (útil para não tirar as mãos do teclado).

9. Gerar vinhetas com TTS

O Play258 inclui síntese de voz (TTS) para gerar vinhetas a partir de texto.

• Em Vinhetas → Gerar vinheta (TTS) (ou botão na área de vinhetas) abre o diálogo.
• Escreva o texto, escolha a voz e o idioma e gere o áudio. O áudio pode ser atribuído directamente a um botão do cartwall.
• O sistema mantém cache local para reutilizar o mesmo texto sem voltar a sintetizar.
• Modelo personalizado (Piper) — Se tiver uma voz clonada, seleccione «Modelo personalizado» e o modelo instalado.
• Coqui TTS — Para voz clonada avançada, escolha o motor Coqui TTS e use um ficheiro WAV de referência.
• O botão Treinar voz abre um assistente para preparar e validar ficheiros de treino de voz.

10. Saída de áudio e Cue

• Em Ficheiro → Configurações, aba Sistema, escolha o dispositivo de saída principal (emissão) e, se existir mais do que um dispositivo, o Cue (pré-escuta, por exemplo auscultadores).
• O Cue permite ouvir uma faixa antes de ir para o ar: na playlist, clique com o botão direito na faixa e escolha Cue; para parar a pré-escuta, Parar cue ou atalho.
• Atalhos: Ctrl+Shift+C (iniciar cue da faixa seleccionada) e Ctrl+Shift+S (parar cue).

O Cue só está disponível se o sistema tiver mais de uma placa de áudio (ou dispositivo de saída) configurada.

11. Atalhos de teclado

12. Pedidos de música (pagos ou gratuitos)

Com a API e os pedidos activados nas configurações, os pedidos dos ouvintes (SMS, WhatsApp, etc.) entram no backend e são sincronizados com o playout.

• No separador Play258 pode ver a fila de pedidos com prioridade sobre a playlist normal.
• O botão Actualizar fila força uma consulta manual, mas o playout também faz polling automático durante o horário de serviço.
• Quando existe pedido pendente, ele toca antes da playlist normal. Se a fila de pedidos ficar vazia, o playout retoma a playlist normal na faixa seguinte correcta.
• O locutor deve garantir que a URL da API está correcta, que a pasta de pedidos está definida e que há ligação à internet para receber pedidos e enviar eventos (ex.: quando a música começou ou terminou).

Se a fila do servidor tiver músicas mas nenhuma entrar localmente, confirme a pasta de pedidos, sincronize o catálogo e verifique se os ficheiros existem localmente.

13. Streaming ao vivo

Em Ficheiro → Configurações → Streaming configure:

• Origem do stream — Pode transmitir apenas o ficheiro em reprodução ou a saída completa da placa de som.
• Dispositivo de captura — Quando usar a saída completa da mesa/placa, escolha a entrada correcta (ou cabo virtual).
• Tipo de servidor — Icecast ou Shoutcast.
• Servidor e porta — Endereço e porta do servidor de streaming.
• Mount (Icecast) — Ex.: /radio.mp3.
• Utilizador e senha — Credenciais da fonte (Icecast: source password; Shoutcast: stream password).
• URL de reprodução — Link que os ouvintes usam para ouvir o stream; pode ser sincronizada com o backend.

O streaming inicia automaticamente quando a reprodução está activa. Em caso de falha (rede ou servidor), o sistema tenta reconectar.

14. Now Playing (metadados)

O playout grava um ficheiro now_playing.json na pasta de dados do utilizador com a faixa actual (título, artista, duração, etc.). A localização típica é:

• macOS/Linux: ~/.playout/now_playing.json
• Windows: %APPDATA%\Play258\now_playing.json

Este ficheiro pode ser usado por sites, aplicações móveis ou telas de «a tocar» no estúdio.

15. Boas práticas

• Use o botão Fundo antes de falar ao vivo para baixar o volume da música.
• Evite saltar faixas em sequência muito rápida; a playlist e os pedidos ficam mais coerentes.
• Confirme as vinhetas (e o áudio do Cue) antes de entrar no ar.
• Mantenha a biblioteca organizada por pastas e use playlists guardadas para programas ou eventos.
• Verifique periodicamente a ligação à API e ao streaming durante a emissão.

16. Resolução de problemas

17. Suporte

Para suporte interno, contacte o administrador do sistema da rádio. Em caso de suporte técnico ao Play258, indique a versão do playout, o sistema operativo e uma descrição do que ocorreu (incluindo mensagens de erro, se houver).

Esta documentação está disponível também a partir do playout em Ajuda → Documentação para locutores.