Resolução ONVIF no Home Assistant: RTSP, eventos e Reolink

9 de maio de 2026

Resolução de problemas de ONVIF no Home Assistant: RTSP, eventos e Reolink LinknLink

Configurar uma câmara ONVIF no Home Assistant parece simples até a primeira transmissão falhar, o evento de movimento nunca ser acionado ou uma câmara Reolink aparecer num sítio mas não noutro.

Isto resolução de problemas Este guia destina-se a utilizadores que já experimentaram a configuração básica e precisam de ir mais além: o que verificar quando a deteção funciona, mas o vídeo não, como o RTSP se articula com o ONVIF, quando é preferível usar a integração nativa da Reolink e como um gateway local do Home Assistant pode manter a privacidade e a resiliência das automatizações das câmaras.

Introdução: a deteção ONVIF é apenas o primeiro ponto de verificação

O Home Assistant pode detetar uma câmara ONVIF e, ainda assim, não conseguir proporcionar um funcionamento utilizável da câmara. A deteção confirma que o dispositivo está acessível e anuncia serviços ONVIF. Não garante que o perfil de transmissão correto, o serviço de eventos, o nome de utilizador, a palavra-passe e a rota de rede estejam prontos para a automatização.

Esta distinção é importante porque muitos utilizadores ficam pelo nível errado. Removem e voltam a adicionar a integração quando o verdadeiro problema está num caminho RTSP. Recriam automatizações quando os eventos ONVIF estão desativados na interface web da câmara. Culpam o Home Assistant quando a câmara está isolada numa rede de convidados.

Use este guia como uma lista de verificação: primeiro a rede, depois as definições da câmara, em terceiro lugar a integração com o Home Assistant e, por fim, a lógica de automação.

Solução 1: Confirme que a câmara está acessível na rede local

Comece pelo básico. O equipamento onde está instalado o Home Assistant e a câmara têm de estar em segmentos de rede que consigam comunicar entre si. Se a câmara estiver numa rede Wi-Fi para convidados, numa VLAN sem encaminhamento ou numa sub-rede bloqueada por regras de firewall, a deteção por ONVIF pode ser irregular e as transmissões de vídeo podem falhar.

Confirme o endereço IP da câmara no router ou na aplicação da câmara.
Abra a interface web da câmara a partir da mesma rede em que se encontra o Home Assistant.
Configure uma reserva de IP fixo para que o endereço da câmara não mude após reiniciar.
Desative o isolamento da rede de convidados para a câmara ou crie uma regra de firewall controlada.

Sempre que possível, mantenha as câmaras, os sensores e as centrais de controlo remoto na mesma rede local de confiança. Isto simplifica bastante a deteção de dispositivos e a resolução de problemas de automatização, sem limitar os passos de diagnóstico a um único modelo de gateway.

Verifique as portas ONVIF e RTSP antes de alterar a integração

Os números das portas não são universais entre modelos de câmaras. Se um resultado de pesquisa ou um guia do fabricante mencionar 8899, 8000 ou outra porta, encare esse número como um valor a verificar, em vez de um valor predefinido a copiar. Consulte a documentação da câmara e as respetivas definições locais e, em seguida, confirme que a porta ONVIF ou RTSP selecionada está acessível a partir do Home Assistant. Reutilizar uma porta de outro modelo pode fazer com que a deteção pareça inconsistente ou deixar a transmissão indisponível.

Utilize uma conta dedicada para a câmara com as permissões necessárias à integração e teste a transmissão após qualquer alteração de portas ou credenciais. Mantenha o acesso à câmara numa rede local de confiança ou através de uma ligação remota devidamente protegida; não exponha as portas da câmara diretamente à Internet pública.

Solução 2: Separar o controlo ONVIF do vídeo RTSP

ONVIF e RTSP funcionam frequentemente em conjunto, mas não são a mesma coisa. O ONVIF ajuda o Home Assistant a descobrir as funcionalidades da câmara e, por vezes, a receber eventos. O RTSP é normalmente o meio pelo qual o vídeo é transmitido. Uma câmara pode responder a pedidos ONVIF mesmo que a transmissão RTSP esteja desativada, protegida por palavra-passe ou configurada com um codec com o qual o Home Assistant não lida bem.

Verifique as definições de transmissão na interface Web da câmara. Ative o RTSP se a câmara exigir uma opção de ativação separada. Teste a transmissão num leitor local antes de alterar as definições do Home Assistant. Se a câmara disponibilizar várias transmissões, utilize a transmissão secundária de menor resolução nos painéis e reserve a transmissão principal para gravação ou análise pormenorizada.

Para visualizar transmissões e controlos num ecrã, planeie o painel de câmaras locais com ONVIF e RTSP com base no caminho funcional do fluxo de vídeo, em vez de depender apenas da descoberta ONVIF.

O erro mais comum é usar uma definição da câmara disponível apenas na aplicação e presumir que o Home Assistant a pode herdar. A automatização local de câmaras requer acesso local ao fluxo de vídeo.

Correção 3: Reolink via ONVIF vs integração nativa da Reolink

As câmaras Reolink colocam frequentemente uma escolha. A integração nativa da Reolink pode disponibilizar funcionalidades específicas das câmaras e facilitar a utilização de entidades como a deteção de movimento, a deteção de pessoas ou os controlos da sirene. O ONVIF é útil quando pretende uma forma normalizada de integrar câmaras ou quando precisa de comparar o comportamento entre diferentes marcas.

Não encare isto como uma questão de lealdade. Encare-o como uma questão de fluxo de trabalho. Se a integração nativa disponibilizar as entidades de que precisa e funcionar localmente na medida necessária para a sua configuração, utilize-a. Se a opção nativa não disponibilizar um fluxo ou evento de que precisa, teste ONVIF e RTSP diretamente.

Em casas com câmaras de diferentes modelos, documente a configuração que funciona para cada câmara. Um modelo Reolink pode comportar-se de forma diferente de outro, pois o firmware, as definições de transmissão e o suporte a eventos variam.

Correção 4: Os eventos de movimento não são o mesmo que automatizações úteis

Muitas pesquisas sobre resolução de problemas com ONVIF devem-se ao facto de os eventos de movimento não aparecerem no Home Assistant. Comece por verificar se a deteção de movimento está ativada na própria câmara. Algumas câmaras exigem que os eventos ONVIF, a deteção inteligente ou a saída de alarme sejam ativados separadamente da transmissão de vídeo.

Quando os eventos começarem a aparecer, decida se devem acionar diretamente as automações. A deteção de movimento das câmaras pode gerar demasiados alertas no exterior e ser demasiado lenta no interior. Para automatizar cada divisão, combine a informação das câmaras com sensores dedicados, como Sensores de presença LinknLink. Para controlar eletrodomésticos, encaminhe a ação através do Home Assistant e de hubs de controlo remoto, como eRemote HA.

Para divisões onde o movimento detetado pela câmara não deve ser o único acionador, combine a via da câmara com o Modelo de automatização de divisões para o Home Assistant para que os sensores, o controlo por IR/RF e o contexto fornecido pelas câmaras funcionem em conjunto.

A melhor abordagem organiza-se em camadas: eventos das câmaras para contextualizar a segurança, sensores de presença para detetar a ocupação das divisões e Home Assistant como camada local de regras.

Solução 5: Utilize com cuidado os caminhos de gravação local e de notificação

Um fluxo de trabalho local com câmaras deve manter o sinal principal dentro de casa. Isso não significa que todas as notificações tenham de ser locais, mas a transmissão da câmara, o acionamento de eventos e a regra de automatização devem continuar a funcionar mesmo quando a nuvem de um fornecedor está lenta.

Se gravar clipes, confirme os requisitos de armazenamento antes de ativar a gravação contínua. Se enviar notificações, ajuste a automatização para evitar a fadiga causada pelo excesso de alertas. Uma configuração de câmaras fiável não é a que tem mais acionadores. É a que envia menos alertas, mas mais relevantes.

Como se integra numa configuração atual do Home Assistant

A ligação da câmara vem primeiro: câmara → ONVIF / RTSP → Home Assistant. Depois de a câmara estar integrada e as respetivas entidades serem fiáveis, HomeClaw é o atual sucessor da LinknLink para a função de gateway local do Home Assistant, acrescentando IA local e capacidades de AI Agent às automatizações. Não disponibiliza descoberta ONVIF nem conversão RTSP; estas continuam a fazer parte da integração entre a câmara e o Home Assistant.

Siga uma sequência de diagnóstico objetiva: confirme primeiro o funcionamento da câmara e da transmissão e só depois adicione sensores de presença ou dispositivos IR/RF, caso contribuam para a automação global da divisão.

Quando os eventos da câmara passarem a integrar uma lógica mais abrangente da divisão, utilize esta lista de verificação em conjunto com Automações de poupança de energia com Home Assistant para regras de ar condicionado e iluminação, e utilize o Guia do sensor de presença mmWave quando a deteção de movimento da câmara deve ser complementada por sensores dedicados à deteção de presença na divisão.

Diagnosticar problemas da câmara por camada

Um fluxo de trabalho de câmaras no Home Assistant tem vários pontos de verificação distintos. Considere a entidade de câmara do Home Assistant como uma camada de diagnóstico própria entre o fluxo RTSP e o painel: câmara/dispositivo → descoberta ONVIF → transmissão RTSP → entidade de câmara do Home Assistant → painel/interface.

Siga esta sequência para identificar a camada com falhas antes de alterar definições noutros locais. Um dispositivo detetado não implica automaticamente um fluxo de vídeo utilizável, e um fluxo de vídeo funcional não implica automaticamente uma entidade de câmara a funcionar corretamente no Home Assistant.

Ordem de resolução de problemas com base nas entidades

Câmara / rede: confirme a alimentação, o endereço, a acessibilidade na rede local e as credenciais.
Deteção ONVIF: confirme que o Home Assistant consegue identificar o dispositivo e disponibilizar os serviços esperados.
Fluxo RTSP: verifique o perfil exato do fluxo, as credenciais, o protocolo de transporte e a compatibilidade.
Entidade de câmara do Home Assistant: verifique a disponibilidade, os atributos e se a entidade disponibiliza uma transmissão em direto utilizável.
Painel de controlo / interface: verifique a entidade selecionada, o tipo de cartão e o modo de visualização apenas depois de as camadas inferiores estarem a funcionar.

Sintoma → Triagem da camada provável

Sintoma	Camada provável	Verificar primeiro
A câmara não é detetada	Deteção de câmaras/da rede ou via ONVIF	Endereço, acessibilidade, credenciais, suporte de integração e disponibilidade do serviço ONVIF.
A câmara é detetada, mas não aparece vídeo	Fluxo RTSP	Perfil exato da transmissão, URL, credenciais, caminho na rede local e compatibilidade de codecs.
O RTSP funciona externamente, mas a entidade de câmara do Home Assistant falha	Entidade de câmara do Home Assistant	Disponibilidade das entidades, atributos, mapeamento das integrações e fluxo disponibilizado ao Home Assistant.
A entidade da câmara existe, mas a apresentação no painel está incorreta	Painel de controlo/interface	Entidade selecionada, tipo de cartão, modo de visualização e estado de erro da interface.
A captura de imagem funciona, mas a transmissão em direto não	Fluxo RTSP ou entidade de câmara	Perfil de transmissão em direto, transporte, credenciais e se a entidade disponibiliza um fluxo em direto utilizável.

Lista de verificação de diagnóstico passo a passo

Confirme que a câmara e o gateway do Home Assistant estão em redes locais acessíveis entre si.
Reserve um endereço IP fixo para a câmara no router.
Ative ONVIF e RTSP na interface Web da câmara.
Teste o fluxo RTSP num leitor local antes de editar o Home Assistant.
Adicione a integração nativa se disponibilizar entidades mais adequadas ao modelo da sua câmara.
Adicione ONVIF como alternativa padrão e compare o comportamento dos eventos.
Crie uma automação simples e, depois, acrescente sensores e controlos de eletrodomésticos.

Perguntas frequentes

Porque é que a minha câmara ONVIF é detetada, mas não transmite vídeo no Home Assistant?

A deteção apenas comprova que o Home Assistant consegue identificar a câmara. A transmissão de vídeo continua a depender das credenciais RTSP, das definições de transmissão da câmara, da acessibilidade através da rede e de a câmara disponibilizar um perfil compatível.

A Reolink funciona melhor através de ONVIF ou da sua integração nativa?

Utilize a integração nativa da Reolink quando esta disponibilizar as entidades de que necessita. Utilize ONVIF ou RTSP como alternativa quando pretender uma ligação local à câmara mais normalizada ou precisar de diagnosticar problemas de transmissão.

O HomeClaw pode executar um fluxo de trabalho local com câmaras através do Home Assistant?

Sim. O HomeClaw é o atual sucessor da LinknLink para a função de gateway local do Home Assistant e pode acrescentar IA local ou assistência de um AI Agent depois de a câmara estar corretamente integrada. A deteção por ONVIF, a transmissão por RTSP, as credenciais e a compatibilidade da câmara continuam a ter de ser verificadas separadamente.

Porque é que os eventos de movimento ONVIF não acionam as automatizações?

Algumas câmaras têm os eventos ONVIF desativados por predefinição, disponibilizam a deteção de movimento apenas através de uma API do fabricante ou exigem configurações específicas para os eventos. Verifique a interface Web da câmara antes de refazer as automatizações do Home Assistant.

Devem as automações das câmaras depender da nuvem?

Não. As rotinas de segurança e de deteção de presença devem, sempre que possível, funcionar através da rede local, podendo depois ser complementadas com notificações opcionais através da nuvem.

Conclusão

A resolução de problemas de ONVIF no Home Assistant torna-se mais fácil quando deixa de encarar a câmara como uma única caixa negra. Verifique a rede, distinga ONVIF de RTSP, escolha a opção de integração adequada para Reolink e mantenha as automatizações das câmaras a funcionar localmente sempre que possível.

Ao criar uma nova base local para uma casa inteligente, mantenha a camada do Home Assistant responsável pela integração das câmaras; adicione sensores, painéis de controlo e dispositivos de controlo remoto apenas quando a ligação às câmaras estiver estável.