Pular para o conteúdo principal

Conecte o Home Assistant

Home Assistant é opcional. O Toposync pode ser usado de forma independente, mas conectar o Home Assistant permite posicionar entidades e estados dentro da composição.

Durante o alpha, comece com entidades não críticas e teste em um ambiente contido. Não use o Toposync como único caminho de controle para fechaduras, alarmes, portões, fluxos de emergência ou automações críticas.

Para que a integração é útil

Use a integração com Home Assistant quando quiser:

  • ver luzes, interruptores, sensores, covers e outras entidades na visualização espacial;
  • controlar dispositivos relacionados enquanto olha uma câmera ou área;
  • usar eventos visuais como contexto para notificações ou automações;
  • conectar inteligência de câmera com dispositivos já existentes no Home Assistant.

Comece com poucas entidades

Para o primeiro teste, adicione apenas algumas entidades:

  • uma luz;
  • um interruptor;
  • um sensor;
  • um cover, portão ou garagem, se for seguro testar;
  • uma entidade relacionada a câmera, se houver.

Isso facilita validar nomes, posicionamento e comportamento antes de adicionar uma instalação completa do Home Assistant.

Dicas de posicionamento

  • Posicione entidades perto do objeto ou área real que elas representam.
  • Use nomes claros que batam com o que você vê no Home Assistant.
  • Mantenha controles de dispositivos arriscados separados de testes casuais.
  • Verifique o comportamento diretamente no Home Assistant antes de confiar em um controle pelo Toposync.

Add-on do Home Assistant

Se você roda o Toposync como add-on do Home Assistant, o add-on pode usar execução supervisionada, ingress na sidebar e acesso interno à Home Assistant Core API.

Veja instalação do add-on do Home Assistant para detalhes de configuração.

Câmeras e Home Assistant Cloud

Há duas superfícies de câmera:

  • o player da sidebar do Toposync, usado para configurar e depurar o Toposync;
  • entidades nativas camera.* do Home Assistant, usadas por dashboards do Home Assistant e Home Assistant Cloud.

Para visualização de câmera amigável ao Cloud, publique a fonte da câmera no Toposync e use a integração customizada Toposync para que o Home Assistant crie entidades nativas de câmera. Não dependa de WebRTC direto dentro do iframe de ingress do Toposync como caminho de visualização remota.

Veja Entidades de câmera e Cloud.

Próximo: Adicione sua primeira câmera.