Skip to content

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 curl e jq.

Crie um playout

  1. Abra Playout.
  2. 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:

  1. No painel Transmissão, clique em Abrir cartão do stream.
  2. Abra a aba Transcodificador e selecione a predefinição Escada padrão 1080/720/360 + AAC.
  3. 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.

  1. 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.
  2. 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'
    
  3. 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')
    
  4. Verifique se o asset está em um armazenamento disponível com journal legível. O comando relaciona storage_id do 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
    
  5. Leia o playout, salve seu ETag e prepare uma solicitação com o config completo:

    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
    
  6. 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

  1. Crie ou abra um bloco no editor.
  2. Em Retenção do slot (opcional), selecione um asset VOD. — igual à do canal — mantém para este bloco o filler geral do playout.
  3. 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

  1. No painel Transmissão, clique em Abrir cartão do stream e abra a aba Fontes.
  2. Verifique o protocolo playout e o identificador do playout. O link abaixo do identificador retorna ao editor.

A entrada do stream playout e o link de retorno ao editor

  1. Abra a aba Saída. Em Reprodução, localize Emitir um ticket de reprodução e clique em Emitir.
  2. 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