Previews do canal¶

A lista de canais no app de um operador, o EPG e uma parede de monitoramento precisam de imagens: o que está no ar agora. Para isso existem os previews do canal — o streamer gera regularmente um quadro JPEG e o serve em um endereço estável. Configura-se no bloco Miniaturas da aba Processo.

Configure um preview¶

Pressione + Adicionar miniatura e escolha a Fonte:

• Quadro-chave do fluxo — o streamer gera JPEGs dos quadros-chave do canal. Campos: Trilha (a trilha de vídeo, normalmente v1), Largura e Altura (uma basta — a outra segue as proporções; a largura padrão é 320), A cada — com que frequência, em GOPs (gop — todo, 2gop — um sim, um não).
• Busca HTTP — o streamer não gera nada: busca periodicamente uma imagem pronta na URL de busca HTTP — prático com câmeras IP que servem um snapshot.

O interruptor Armazenar miniaturas no DVR grava além disso as miniaturas no arquivo — junto com a gravação do canal surge sua fita visual.

Um canal pode levar até dez trilhas de preview — uma pequena para a lista e uma maior para a ficha do canal, por exemplo.

Busque a imagem¶

O quadro fresco do canal é servido em:

/streaming/live-preview-jpeg/<nome-do-canal>

A resposta é um JPEG comum; uma interface cliente simplesmente o re-solicita na cadência que precisar:

Enquanto o canal não tem previews configurados, o endereço responde 404 — as miniaturas não se geram sozinhas, são um trabalho que precisa ser ligado.

Se não há imagem¶

• 404. Os previews não estão configurados, o canal não está no ar, ou o primeiro quadro-chave ainda não chegou — com A cada: 2gop e um GOP longo o primeiro quadro pode demorar dezenas de segundos.
• Há imagem mas congelou. A fonte do preview é uma busca HTTP e a câmera serve um snapshot em cache; verifique a URL da câmera diretamente.
• A trilha não é encontrada. O campo Trilha deve nomear uma trilha de vídeo existente do canal — veja o identificador dela no cartão de saúde da fonte (normalmente v1).