Transmissões ao vivo
Transmissões ao vivo são a forma normal de ver fontes de câmera e saídas renderizadas de pipelines no Toposync.
Para fontes de câmera, o fluxo esperado é simples: habilite a transmissão na fonte, escolha o papel da fonte e deixe o Toposync criar a transmissão e o pipeline implícito.
Publique uma fonte
Nas configurações da câmera, habilite Transmitir esta fonte para cada fonte de vídeo que você quer visualizar.
Cada fonte publicada deve ter:
- um nome visível;
- um papel:
main,sub,zoomoucustom; - uma imagem ou fonte de stream funcionando;
- um pipeline implícito gerado pelo Toposync.
Se uma câmera tem múltiplos streams, publique os úteis separadamente. Por
exemplo, publique o stream de baixa resolução como sub e o stream de alta
resolução como main.
Variantes
Uma live view pode ter variantes. O viewer escolhe a melhor variante para o contexto atual:
- grid e miniaturas preferem
sub; - tela cheia prefere
main; - PTZ ou autotrack podem preferir
zoom; - saídas avançadas ou renderizadas podem usar
custom.
O seletor voltado ao usuário deve mostrar nomes como Principal, Baixa resolução, Zoom ou o seu rótulo customizado. IDs técnicos de output e engine paths são diagnóstico avançado.
Estados de reprodução
Estados comuns:
| Estado | Significado |
|---|---|
| Ao vivo | Há frame recente, writer selecionado e output saudável. |
| Aquecendo | A fonte ou publisher está iniciando. Um curto período de tela preta pode ser normal. |
| Sem pipeline | Nenhum pipeline ativo está alimentando esta transmissão. Reconcilie ou confira a publicação da fonte. |
| Stale | O último frame selecionado está antigo demais. A imagem não deve ser tratada como ao vivo. |
| Publisher parado | Existem frames, mas o publisher de mídia não está rodando para o output selecionado. |
| Fora do ar | A câmera/fonte está inacessível ou não há frame recente. |
Um processo rodando não basta para chamar um stream de ao vivo. O Toposync só deve mostrar ao vivo quando há frames reais e recentes.
Transportes
O Toposync pode usar vários transportes. Normalmente, deixe o modo em Auto.
| Transporte | Melhor uso | Latência |
|---|---|---|
| HLS | Reprodução mais estável em navegador, app e ingress do Home Assistant | Maior |
| MSE | Reprodução web fluida quando navegador e sidecar suportam | Menor que HLS |
| WebRTC | Baixa latência explícita ou interação PTZ | Menor |
| JSMpeg | Último recurso visual quando transportes melhores falham | Média |
HLS é a base estável. MSE pode ser preferido em dashboards web quando disponível. WebRTC não deve ser tratado como padrão para todos os tiles. JSMpeg é somente vídeo e baixa qualidade por definição.
RTSP não é um transporte de navegador. Ele é útil para Home Assistant Core, diagnóstico, VLC, Frigate ou outras ferramentas externas.
Depure um transporte
A tela de debug de streams pode abrir um transporte fixo por vez. Use essa tela quando precisar saber se HLS, MSE, WebRTC ou JSMpeg está falhando de forma independente.
A tela de debug não deve trocar de transporte silenciosamente. Alguns transportes podem falhar em alguns ambientes, e isso é esperado.
Solução de problemas
A câmera não mostra imagem
Confira se o snapshot da câmera funciona, depois confira se a fonte está publicada. Se a live view mostra Sem pipeline, reconcilie a publicação ou salve a fonte da câmera novamente para o Toposync recriar o pipeline implícito.
Começa preto e depois funciona
Um aquecimento curto pode ser normal enquanto fonte, publisher, playlist ou sidecar inicia. O estado deve estabilizar em Ao vivo. Se continuar preto, abra a tela de debug para o transporte ativo.
HLS funciona, mas WebRTC mostra aviso
Se o transporte ativo é HLS ou MSE e o vídeo está ao vivo, um aviso de WebRTC normalmente é só um aviso de baixa latência. Ele importa quando você pede WebRTC, PTZ ou baixa latência explicitamente.
Ingress do Home Assistant
Dentro da sidebar ou ingress do add-on Home Assistant, espere reprodução com HLS primeiro. WebRTC direto no navegador é sensível a mapeamento de portas do add-on e ao caminho de rede. Para Home Assistant Cloud, prefira a integração nativa de câmera do Home Assistant em vez de WebRTC direto dentro do iframe do Toposync.