Configuração do playout¶
Use esta página para criar ou configurar um playout específico e seu stream de saída. Para percorrer todo o caminho dos arquivos VOD até a reprodução pelo assinante, siga Canal a partir de VOD.
Um playout reproduz blocos segundo a grade e envia a transmissão para um stream chamado playout_<id>. A grade controla o conteúdo; as configurações do stream controlam a codificação e a entrega.
O que preparar¶
- Acesso de operador a Playout, VOD e Streams.
- Vídeo com som para a grade. Um vídeo ou uma imagem JPEG pode servir de filler.
- Para o filler geral, acesso à management API e os utilitários
curlejq.
Crie um playout¶
- Abra Playout.
- Em Nome do novo playout, digite um nome e clique em Criar playout. O editor será aberto com uma grade vazia.
A Catena cria o stream playout_<id> e uma fonte de guia de programação junto com o playout. Não é necessário criar o stream nem vincular EPG separadamente. O <id> completo aparece no endereço do editor depois de #/playouts/.
Um novo playout recebe este formato de fonte padrão:
- 25 fps — frequência de quadros à qual o conteúdo é adaptado.
- 1920×1080 — tamanho do quadro de saída do playout.
- Mono, 48 kHz — distribuição e frequência do áudio.
- 8 bits — profundidade de cor.
Escolha a saída para os espectadores¶
O playout entrega vídeo YUV e áudio PCM sem compressão. Configure o transcodificador do stream automático para um reprodutor HLS comum:
- No painel Transmissão, clique em Abrir cartão do stream.
- Abra a aba Transcodificador e selecione a predefinição Escada padrão 1080/720/360 + AAC.
- Em Pré-visualização: entrada → saída, verifique se há três qualidades de vídeo e áudio AAC configurados; depois clique em Salvar.
Essa predefinição codifica a transmissão em H.264 e AAC e cria três qualidades para HLS. As outras configurações de entrega e arquivo também ficam na página do stream, não no editor do playout.
Como os parâmetros da fonte afetam a transmissão¶
O playout adapta todos os assets a um único formato de fonte. Ele dimensiona a imagem para o tamanho configurado e converte o áudio para a frequência e a distribuição configuradas. Isso não substitui o transcodificador: após a adaptação, o playout continua entregando quadros e áudio sem compressão.
Verifique a frequência de quadros dos assets¶
Se a frequência de quadros de um asset for diferente da frequência da fonte, o playout duplicará ou descartará quadros. A duração do bloco não muda, mas o movimento pode ficar menos fluido. Esse bloco recebe um aviso; o salvamento da grade não é bloqueado. Para obter movimento uniforme, use assets com a frequência de quadros do playout.
Onde o formato de fonte é configurado¶
As propriedades do formato de fonte ficam na aba Fontes do cartão do stream. O editor do playout serve para o nome, o filler e a grade. Para alterar o formato, use Altere o formato de origem: o procedimento exige desabilitar e reabilitar o stream.
Configure os fillers¶
Um filler cobre as pausas da grade e substitui o conteúdo quando um asset falha. A ordem de substituição é:
- Filler do bloco — aplica-se somente ao bloco selecionado.
- Filler do canal — filler geral do playout; é reproduzido se o bloco não tiver um filler próprio ou se não houver bloco no momento atual.
- Síntese de emergência — barras de cor com silêncio quando não há filler adequado configurado ou disponível.
Os fillers usam assets VOD: vídeo ou uma imagem JPEG estática. A imagem permanece na tela com silêncio. Um stream ao vivo não pode ser filler.
Defina o filler geral pela API¶
Na versão verificada, o console não salva Retenção do canal: o botão principal Salvar retorna HTTP 422 com «missing field fps» e a configuração não é aplicada. Não use esse caminho. O salvamento da grade e do filler do bloco funciona separadamente.
Você pode definir o filler geral pela management API. O PATCH deve conter o config completo com apenas filler alterado: enviar somente config.filler faz o servidor rejeitar a solicitação. Os comandos abaixo leem o documento atual e preservam todos os seus parâmetros, incluindo a grade e o formato de fonte.
- Envie um vídeo ou JPEG como um asset VOD separado e espere pelas informações do arquivo. Copie o identificador do playout no endereço do editor.
-
Defina o endereço da instalação, a conta do operador, o identificador do playout e a chave do asset. Envie a senha somente por HTTPS:
set -euo pipefail BASE='https://catena.example.com' API_USER='operator' read -rsp 'Operator password: ' API_PASSWORD; echo PLAYOUT_ID='<playout id>' ASSET_KEY='slates/technical' -
Localize o identificador do asset pela chave:
ASSET_ID=$(curl -fsS -u "$API_USER:$API_PASSWORD" --get \ --data-urlencode "name_prefix=$ASSET_KEY" \ --data-urlencode 'limit=1000' \ "$BASE/central/api-v4/vod/assets" | jq -er --arg key "$ASSET_KEY" '.assets[] | select(.key == $key) | .id') -
Verifique se o asset está em um armazenamento disponível com journal legível. O comando relaciona
storage_iddo placement do asset ao registro do armazenamento e falha se não houver armazenamento adequado. Nesse caso, espere até o VOD estar pronto e repita a verificação em vez de prosseguir para o PATCH:curl -fsS -u "$API_USER:$API_PASSWORD" \ -o filler-asset.json "$BASE/central/api-v4/vod/assets/$ASSET_ID" curl -fsS -u "$API_USER:$API_PASSWORD" \ -o vod-storages.json "$BASE/central/api-v4/vod/storages" jq -e --slurpfile storages vod-storages.json \ '.placements[]? as $placement | $storages[0].storages[]? | select(.id == $placement.storage_id and .status == "available" and .journal == "readable")' \ filler-asset.json >/dev/null -
Leia o playout, salve seu ETag e prepare uma solicitação com o
configcompleto:curl -fsS -u "$API_USER:$API_PASSWORD" \ -D playout.headers -o playout.json \ "$BASE/central/api-v4/playouts/$PLAYOUT_ID" ETAG=$(sed -n 's/^[Ee][Tt][Aa][Gg]:[[:space:]]*//p' playout.headers | tr -d '\r') if [[ -z "$ETAG" ]]; then echo 'ETag is missing; refusing to PATCH' >&2 exit 1 fi jq --arg filler "vod://$ASSET_ID" \ '{config: (.config + {filler: $filler})}' playout.json > playout-filler.json -
Envie a alteração com o ETag do documento lido:
curl -fsS -u "$API_USER:$API_PASSWORD" \ -X PATCH "$BASE/central/api-v4/playouts/$PLAYOUT_ID" \ -H "If-Match: $ETAG" \ -H 'Content-Type: application/merge-patch+json' \ --data-binary @playout-filler.json | jq '.playout.config'
Na resposta, filler deve conter vod://<asset id>, enquanto fps, size, sample_rate, audio e bit_depth devem manter os valores anteriores. Se o servidor retornar HTTP 412, outra sessão alterou o documento: leia-o novamente, revise a nova configuração e só então prepare a solicitação outra vez. Não reenvie o ETag antigo.
Em um novo playout sem blocos, o filler geral já deve estar no ar; verifique-o por HLS como descrito abaixo. Em um playout existente com um bloco atual, a resposta salva confirma a configuração, e a imagem do filler poderá ser vista na próxima pausa da grade. Não exclua o bloco atual apenas para testar.
Defina o filler de um bloco no console¶
- Crie ou abra um bloco no editor.
- Em Retenção do slot (opcional), selecione um asset VOD. — igual à do canal — mantém para este bloco o filler geral do playout.
- Clique em Criar slot ou Salvar na janela do bloco e depois no botão principal Salvar acima da malha. Não altere Retenção do canal ao mesmo tempo.
Abra o bloco novamente e verifique o asset selecionado. O painel Transmissão deve mostrar o título do bloco atual da grade salva.
Verifique o stream¶
- No painel Transmissão, clique em Abrir cartão do stream e abra a aba Fontes.
- Verifique o protocolo playout e o identificador do playout. O link abaixo do identificador retorna ao editor.

- Abra a aba Saída. Em Reprodução, localize Emitir um ticket de reprodução e clique em Emitir.
- Copie o endereço HLS / LL-HLS para um reprodutor HLS. Para inspecionar o manifesto, abra o endereço em uma nova aba do navegador.
O manifesto principal deve conter variantes de qualidade, e o manifesto de uma variante deve conter segmentos de mídia. O reprodutor deve mostrar o bloco atual com som; com uma grade vazia, deve mostrar o filler geral ou as barras de cor. Se a resposta contiver apenas o cabeçalho da playlist, verifique o transcodificador. Se o acesso falhar, emita um novo ticket.
Não use a pré-visualização JPEG do editor como verificação obrigatória: com a proteção de reprodução ativada, /playback/live-preview-jpeg/playout_<id> pode retornar HTTP 403 mesmo quando HLS funciona.
Guia de programação (EPG)¶
A fonte EPG é criada com o playout e já está vinculada ao stream. Os dados do bloco transferidos para o guia, sua atualização após editar e as verificações do resultado estão descritos em Guia de programação do playout.
Exclusão¶
A exclusão é irreversível. As consequências para o stream e a EPG, o procedimento e as verificações estão descritos em Exclua um playout.
O que vem depois¶
- Grade de exibição — adicione blocos e altere a grade atual.
- Canal a partir de VOD — publique o stream como canal e verifique-o como assinante.
- Transcodificação e MBR — escolha outra escada de qualidades para o stream.