Diagnóstico do playout¶
Comece pelo sintoma observável e verifique a cadeia nesta ordem: grade salva → quadro de vídeo real → EPG → acesso do espectador. Uma resposta da API ou uma guia de programação correta, por si só, não comprova o que está no ar.
Você precisa de acesso de operador ao playout e ao stream dele, além de uma conta de assinante para a verificação final. Consulte Verifique o stream para obter o link HLS.
Você pode consultar o estado do playout pela management API. Defina o endereço da instalação, a conta do operador e o nome do stream; envie a senha somente por HTTPS:
BASE='https://catena.example.com'
API_USER='operator'
read -rsp 'Operator password: ' API_PASSWORD; echo
STREAM='playout_<id>'
curl -fsS -u "$API_USER:$API_PASSWORD" \
"$BASE/central/api-v4/streams/stats/$STREAM" |
jq '.input.playout'
Verifique health e problems na resposta e abra a seção correspondente.
Exibição e grade¶
O filler está no ar¶
- Sintoma: o filler do bloco, o filler geral ou barras de cor são exibidos em vez de um filme ou uma fonte ao vivo.
- Causas possíveis: nenhum bloco cobre o horário atual, o VOD terminou antes do fim do bloco ou o conteúdo está indisponível.
- Verificação: abra Playout e compare Agora e a seguir com a malha. Se não houver um bloco atual, verifique os limites dos blocos vizinhos. Se houver um bloco, verifique sua duração e a disponibilidade do asset. A solicitação de estado acima ajuda a distinguir um erro do asset de uma pausa na grade.
- Ação: para uma pausa, adicione ou mova um bloco e clique no botão geral Salvar como descrito em Monte uma grade de VOD. Se o VOD terminou naturalmente, deixe o filler até o próximo bloco ou altere a duração e o conteúdo do bloco. Para um erro do asset, vá para Conteúdo e fontes.
- Verificação do resultado: se você adicionou ou corrigiu um bloco, Agora o mostra, HLS ou WebTV mostra seu quadro e o EPG mostra seu programa. Se deixar o filler intencionalmente após o final natural do VOD, verifique se ele é reproduzido até o limite do próximo bloco e se o conteúdo do próximo bloco começa depois. Para uma fonte reparada,
healthdeve voltar aon_aireproblemsdeve ficar vazio.
O bloco está incorreto ou uma edição salva não aparece no ar¶
- Sintoma: o reprodutor mostra o programa anterior ou um bloco diferente daquele que você acabou de editar.
- Causas possíveis: você editou um bloco futuro, a edição continua apenas como rascunho, o horário do bloco está incorreto ou uma WebTV aberta mantém o EPG anterior.
- Verificação: compare Agora e a seguir com a malha e verifique o início e a duração do bloco. Depois de salvar a janela do bloco, verifique se o botão geral Salvar acima da malha foi concluído sem erros. Compare o EPG atualizado no cartão do canal com o quadro HLS real.
- Ação: clique no botão geral Salvar. Para um bloco futuro, aguarde seu início; para um horário incorreto, corrija os limites e salve novamente. Recarregue a WebTV aberta depois de editar o EPG. Não é necessário reiniciar o stream para aplicar a grade.
- Verificação do resultado: Agora, o EPG atualizado e o quadro de vídeo correspondem ao mesmo bloco. A edição de um bloco futuro aparece em seu programa, mas não altera a exibição atual antes do horário programado.
O filler geral não é salvo¶
- Sintoma: depois de selecionar Retenção do canal, o botão principal Salvar retorna HTTP 422 com «missing field
fps». - Causa possível: na versão verificada, o editor envia uma configuração de saída incompleta quando o filler geral é alterado. O salvamento da grade e do filler do bloco é um caminho separado que funciona.
- Verificação: abra o playout novamente e verifique se o filler geral anterior permaneceu inalterado. Não repita a mesma solicitação do editor.
- Ação: salve o
configexistente completo com apenasfilleralterado pela management API seguindo Defina o filler geral pela API. O procedimento preservafps, tamanho, áudio e os demais parâmetros e usaIf-Matchpara não sobrescrever a edição de outro operador. - Verificação do resultado: a resposta da API contém o novo
fillere os parâmetros de saída anteriores. Verifique o filler selecionado por HLS na próxima pausa da grade; não exclua o bloco atual apenas para testá-lo.
Conteúdo e fontes¶
Um arquivo VOD está indisponível¶
- Sintoma: um bloco VOD aparece em Agora, mas o filler está no ar; o estado do stream pode ser
degradedcom um erro do asset. - Causas possíveis: o arquivo ou o armazenamento está indisponível, o placement do asset não está pronto ou o Catena ainda não leu as informações do vídeo.
- Verificação: abra o asset em VOD → Catálogo. Verifique o status disponível, as faixas de vídeo e áudio em Media info, uma cópia pronta e um armazenamento disponível em Cópias. Execute a solicitação de estado do stream do início desta página.
- Ação: restaure o arquivo ou o armazenamento e aguarde até que o placement esteja pronto. Exclua o bloco com falha e clique no botão geral Salvar; depois recrie-o com o conteúdo, o início, a duração e os metadados anteriores e salve novamente para que o playout reabra o asset. Consulte Edite a exibição atual para a sequência de exclusão e recriação. Se o armazenamento estiver indisponível, use Diagnóstico do streamer e as informações sobre placement de VOD; não recrie o playout. Se não for possível restaurar o asset agora, substitua o conteúdo do bloco por outro VOD disponível e clique no botão geral Salvar.
- Verificação do resultado: o asset está disponível,
healthvolta aon_air, o erro do asset desaparece deproblemse uma nova HLS ou WebTV mostra o conteúdo do bloco em vez do filler.
Uma fonte ao vivo não é reproduzida¶
- Sintoma: um bloco ao vivo está salvo e aparece em Agora, mas o filler está no ar. O EPG pode mostrar o programa ao vivo correto ao mesmo tempo.
- Causas possíveis: a própria fonte ao vivo está indisponível ou se aplica a limitação da versão verificada: uma fonte que funciona pode não chegar à exibição do playout mesmo sem um erro do asset.
- Verificação: reproduza o stream ao vivo de origem independentemente do playout e inspecione suas entradas com Diagnóstico da fonte. Depois compare o quadro HLS real do playout e
problems. Não use o EPG como prova da exibição ao vivo. - Ação: se a fonte estiver indisponível, restaure sua entrada e aguarde até que o stream ao vivo seja reproduzido independentemente. Exclua o bloco ao vivo com falha e clique no botão geral Salvar; depois recrie-o com os parâmetros anteriores e salve a grade novamente. Se a fonte for reproduzida independentemente, mas o playout continuar mostrando o filler, substitua o bloco ao vivo por um asset VOD disponível e clique no botão geral Salvar como descrito em Adicione uma fonte ao vivo. Não há outra recuperação da exibição ao vivo verificada nesta versão.
- Verificação do resultado: o reprodutor mostra o quadro real, não apenas um evento EPG. Depois de mudar para VOD, verifique o conteúdo do novo bloco e o programa atualizado.
Guia de programação¶
A EPG está vazia¶
- Sintoma: o cartão do canal, WebTV ou XMLTV não mostra os programas atual e seguinte.
- Causas possíveis: o intervalo selecionado não tem um bloco, o evento foi excluído com seu bloco, o canal aponta para outro stream ou o assinante não tem acesso ao canal.
- Verificação: compare o intervalo com a grade salva. Verifique o programa e o campo Stream no cartão do canal e depois Canais disponíveis no cartão do assinante. As pausas entre blocos não criam eventos, e o próximo salvamento remove eventos que terminaram há mais de um dia.
- Ação: adicione ou restaure o bloco e clique no botão geral Salvar. Se o canal apontar para o stream incorreto, corrija o vínculo seguindo Crie o canal. Se apenas a guia do assinante estiver vazia, restaure a cadeia canal → pacote → assinatura em O canal não está visível para o espectador. Recarregue WebTV.
- Verificação do resultado: o cartão do canal mostra um programa com o título e o horário pretendidos; depois de recarregar WebTV ou fazer uma nova solicitação XMLTV, os mesmos dados aparecem.
A EPG está desatualizada ou contém dados incorretos¶
- Sintoma: um título, uma descrição, um horário ou a ordem dos programas não corresponde à última edição.
- Causas possíveis: a edição continua apenas como rascunho, o bloco contém campos salvos incorretos ou uma WebTV aberta mostra uma guia carregada anteriormente.
- Verificação: abra o bloco e compare seus campos salvos. Verifique o EPG atualizado no cartão do canal ou com uma nova solicitação XMLTV: se os dados já estiverem corretos lá, apenas a WebTV aberta está desatualizada.
- Ação: se o cartão atualizado do canal ou o XMLTV já mostrar os dados corretos, apenas recarregue a WebTV; não é necessária outra edição nem salvar a grade novamente. Se os campos salvos estiverem incorretos ou a edição ainda estiver no rascunho, corrija os campos do bloco, salve a janela e clique no botão geral Salvar seguindo Atualize a guia depois de uma edição. Atualize a página do console para o cartão do canal.
- Verificação do resultado: o cartão do canal atualizado, WebTV e XMLTV mostram o título, os limites e a descrição corrigidos. Temporada, Episódio e o pôster não são transferidos para o EPG; inclua o número do episódio no título se o espectador precisar dele.
A EPG está correta, mas o filler está no ar¶
- Sintoma: o programa atual da WebTV corresponde à grade enquanto o quadro de vídeo mostra o filler.
- Causa possível: o EPG reflete a intenção salva do operador, não o quadro real. Um VOD ou uma fonte ao vivo indisponível e a limitação da exibição ao vivo não precisam alterar o evento.
- Verificação: abra o link HLS direto e inspecione
healtheproblemsdo stream. Depois verifique o asset do bloco atual e a reprodução independente da fonte ao vivo. - Ação: siga Um arquivo VOD está indisponível ou Uma fonte ao vivo não é reproduzida. Se a fonte ao vivo funcionar independentemente, mas o playout continuar mostrando o filler, use a mudança verificada para VOD.
- Verificação do resultado: um novo reprodutor mostra o conteúdo do bloco atual. Se você selecionou VOD em vez da fonte ao vivo, o EPG também corresponde ao novo bloco depois de salvar e recarregar WebTV.
Acesso do espectador¶
A HLS direta funciona, mas o canal não está visível para o espectador¶
- Sintoma: o operador consegue assistir ao link direto do stream, enquanto WebTV informa No channels available ou omite o canal necessário.
- Causa possível: a HLS direta verifica o stream, não a publicação. O canal não está vinculado a este stream, não pertence a um pacote ou seu pacote não está nas assinaturas do assinante.
- Verificação: em Canais, verifique o nome exato do stream
playout_<id>; em Pacotes, verifique o conteúdo do pacote; no cartão do assinante, verifique Assinaturas e o bloco resultante Canais disponíveis. - Ação: restaure os três vínculos seguindo Publique o canal: canal → stream, canal → pacote, assinante → assinatura do pacote. Recarregue WebTV depois de alterá-los.
- Verificação do resultado: o canal aparece em Canais disponíveis e na WebTV, e o espectador vê seu quadro e programa atual. A assinatura determina os canais disponíveis; uma HLS direta funcional não a substitui.
O canal está visível, mas não é reproduzido¶
- Sintoma: o canal aparece na lista, mas o reprodutor informa um erro ou não inicia a reprodução.
- Causas possíveis: nenhum stream está atribuído ao canal, outro stream está atribuído ou a reprodução falha na sessão da WebTV embora o stream atribuído funcione.
- Verificação: leia a mensagem do reprodutor e verifique o campo Stream do canal. This channel has no broadcast configured significa que nenhum stream está atribuído. Compare o nome exato do stream atribuído com o
playout_<id>do playout necessário. Se o stream correto já estiver atribuído, não salve nem atribua novamente. Compare primeiro a HLS direta desse stream. - Ação: se o stream estiver ausente ou incorreto, atribua o correto seguindo Crie o canal e salve o canal. Se a HLS direta falhar com o stream correto já atribuído, vá para A HLS direta também não é reproduzida. Se a HLS direta for reproduzida, recarregue a WebTV ou abra uma nova sessão da WebTV em uma janela privada do navegador e entre novamente. Se o reprodutor continuar em silêncio sem mostrar um erro, continue com A HLS direta funciona, mas a WebTV permanece em silêncio sem um erro. Para uma mensagem explícita sobre limites de telas ou entrada do dispositivo, use O espectador relata que nada é reproduzido.
- Verificação do resultado: uma nova sessão da WebTV mostra o quadro do canal com som e o programa atual. Se a WebTV permanecer em silêncio, preserve para a escalada o resultado da HLS direta que já funciona; esse resultado não identifica a causa da falha do reprodutor.
A HLS direta funciona, mas a WebTV permanece em silêncio sem um erro¶
- Sintoma: o stream correto está atribuído e a HLS direta é reproduzida, mas uma nova sessão da WebTV não mostra vídeo nem um erro do reprodutor.
- Causa possível: as evidências limitam a falha à reprodução nesta sessão da WebTV, mas não identificam sua causa. Não deduza um defeito do playout, do transcodificador, da rede ou do navegador apenas por esse sintoma.
- Verificação: anote se recarregar a WebTV e abrir uma nova sessão mudou o resultado. Em um navegador de desktop, abra as ferramentas de desenvolvedor antes de recarregar. Salve erros e avisos do Console, solicitações com falha da Network e estados HTTP da página, dos manifestos HLS e dos segmentos de mídia. Não altere código, flags do navegador ou o stream. Se o dispositivo não oferecer essas ferramentas, registre essa limitação em vez de conectar um depurador.
- Ação: pare de alterar o playout, o transcodificador e a atribuição do canal somente por esse sintoma. Encaminhe ao administrador do serviço ou ao suporte o pacote abaixo; remova senhas, cookies, tokens de acesso e parâmetros secretos das solicitações.
-
Pacote para escalada:
-
A página exata da WebTV e a URL, sem credenciais nem tokens.
- O nome e a versão do navegador, além do dispositivo e do sistema operacional.
- O resultado da nova sessão, incluindo se a lista de canais e o guia de programação carregaram.
- As evidências do Console e da Network, ou uma nota de que o dispositivo não permite coletá-las.
-
O fato de que a HLS direta já funciona, incluindo o nome do stream e o programa reproduzido.
-
Verificação do resultado: se a WebTV começar a reproduzir, verifique imagem, som e programa atual. Se ela permanecer em silêncio, o pacote registra o resultado da nova sessão e a comparação com a HLS direta que já funciona sem inventar um diagnóstico.
A HLS direta também não é reproduzida¶
- Sintoma: o stream do playout não é reproduzido nem na WebTV nem pelo link direto; o manifesto principal pode conter apenas um cabeçalho sem variantes de qualidade.
- Causa possível: o playout fornece vídeo YUV não comprimido e áudio PCM, e nenhum transcodificador está configurado para um reprodutor HLS comum.
- Verificação: abra o manifesto principal e verifique se há variantes de qualidade. Na página do stream, abra Transcodificador e inspecione Pré-visualização: entrada → saída. Se um aviso relatar um erro do transcodificador, use o diagnóstico específico.
- Ação: configure o preset Escada padrão 1080/720/360 + AAC como descrito em Escolha a saída para os espectadores e salve o transcodificador.
- Verificação do resultado: o manifesto principal contém variantes de qualidade, o manifesto de uma variante contém segmentos de mídia e o reprodutor mostra o bloco atual com som. Depois verifique separadamente o acesso do assinante ao canal.
O que fazer a seguir¶
- Alteração do formato de origem — reinício seguro e verificações quando o Media info ou o tamanho do quadro não muda após a edição do formato, ou aparece um quadro verde.
- Exclusão do playout — consequências da exclusão irreversível e recuperação da publicação em outro stream.
- Grade de exibição — sequência de verificação do salvamento e dos avisos.
- Guia de programação do playout — verificações do EPG no cartão do canal, na WebTV e no XMLTV.
- Canal a partir de VOD — verificação completa da reprodução do assinante.