Pular para o conteúdo principal

Adicione sua primeira câmera

Adicione câmeras aos poucos. Uma câmera funcionando bem é mais útil que muitas câmeras configuradas pela metade.

Comece com uma câmera, valide snapshot e acesso ao stream, publique a fonte para transmissão ao vivo e depois posicione e mapeie a câmera na composição. Crie pipelines de eventos apenas depois que a transmissão estiver estável.

Se você ainda não tem uma câmera real pronta, use Teste sem uma câmera real primeiro. Ele fornece uma fonte RTSP sintética que exercita o mesmo fluxo de câmera manual e transmissão ao vivo sem adicionar comportamento de teste ao produto.

Antes de começar

Tenha estas informações disponíveis quando possível:

  • nome da câmera;
  • endereço IP ou hostname;
  • URL RTSP, se você já souber;
  • usuário e senha ONVIF, se a câmera suportar ONVIF;
  • se a câmera suporta PTZ;
  • onde a câmera está instalada fisicamente.

Use uma rede contida e evite expor credenciais de câmeras publicamente.

Descoberta ou configuração manual

O Toposync pode trabalhar com câmeras adicionadas manualmente e, quando suportado pela câmera e pela rede, descoberta ONVIF.

Use descoberta quando funcionar, mas não dependa dela para toda câmera. Alguns dispositivos, VLANs, redes Wi-Fi, roteadores ou configurações de câmera podem bloquear descoberta mesmo quando a câmera em si funciona.

Se a descoberta não encontrar a câmera, adicione manualmente com as informações que você já tem.

Primeira validação

Antes de criar pipelines, confirme o básico:

  1. A câmera foi salva com um nome claro.
  2. Snapshot ou acesso à imagem funciona.
  3. Pelo menos uma fonte de vídeo funciona se você instalou suporte a streaming.
  4. A fonte tem o papel certo: main, sub, zoom ou custom.
  5. Transmitir esta fonte está habilitado para as fontes que você quer ver.
  6. A live view aparece como ao vivo, aquecendo ou com um problema acionável claro.
  7. Controles PTZ funcionam apenas se a câmera suporta PTZ e as credenciais permitem.
  8. A câmera está posicionada perto do local real na composição.

Não ajuste configurações avançadas até esse primeiro ciclo funcionar.

Publique a fonte para transmissão ao vivo

Para visualização normal de câmera, não crie uma transmissão técnica manualmente. Publique a fonte da câmera e deixe o Toposync gerar a transmissão e o pipeline implícito contínuo.

Configuração inicial comum:

  • stream de baixa resolução como sub para tiles de grid;
  • stream de alta resolução como main para tela cheia;
  • stream PTZ/autotrack como zoom quando a câmera suporta.

Abra o dashboard e confirme que a câmera está visível. Um aquecimento curto é normal; um estado persistente de Sem pipeline ou Stale precisa de atenção.

Veja Transmissões ao vivo para estados de reprodução e transportes.

Posicione a câmera na composição

O posicionamento não precisa ser exato no primeiro dia. Ele deve ser bom o bastante para responder:

  • onde essa câmera está instalada?
  • qual área ela vê principalmente?
  • quais cômodos, portões, portas ou zonas externas aparecem?
  • quais eventos deveriam pertencer a essa câmera?

Depois de posicionar a câmera, revise suas áreas. Talvez você precise dividir ou renomear áreas com base no que a câmera realmente vê.

Mapeie a câmera quando precisar de contexto espacial

Mapeamento é opcional para transmissão ao vivo básica, mas é obrigatório para Visão 360 e para pipelines que usam posições de câmera para mundo.

Mapeie a câmera depois que a fonte e a live view estiverem estáveis. Comece com quatro pontos de canto, depois use pontos internos de refinamento apenas quando a imagem precisar de correção local.

Veja Mapeamento de câmeras para calibração e comportamento da Visão 360.

Crie pipelines depois

Depois que a transmissão ao vivo funcionar, crie pipelines para eventos e automação:

  • detecção de movimento ou objetos;
  • filtros por área;
  • imagens armazenadas ou recortes;
  • notificações;
  • ações no Home Assistant;
  • variantes ao vivo renderizadas com Transmitir vídeo.

Use Crie seus primeiros pipelines para o próximo passo.