cardápio

🔎 Como integrar a câmera SONOFF ao Home Assistant?

1. Introdução

Este guia explica como integrar a câmera SONOFF ao Home Assistant usando o protocolo ONVIF . Com esta configuração, você poderá:

  • Veja o vídeo em tempo real no Home Assistant
  • Receba eventos de detecção de movimento e humanos
  • Configurar automação (por exemplo, acionar gravação quando movimento for detectado)

Antes de começar, certifique-se de que o firmware do seu dispositivo e a versão do aplicativo atendem aos requisitos de suporte ao ONVIF.

  • Câmera SONOFF CAM-PT2 com firmware ≥ v1.0.5
  • Câmera SONOFF CAM-S2 com firmware ≥ v1.1.5
  • Aplicativo eWeLink (versão ≥ v5.18.0) instalado no seu telefone

*Este tutorial usa a câmera SONOFF CAM-PT2 como exemplo.


2. O que você vai precisar

Para concluir essa integração, certifique-se de ter o seguinte:

Hardware e Software

  • Um dispositivo executando o Home Assistant (por exemplo, Raspberry Pi 4+, PC ou Docker)
  • Tanto a câmera quanto o Home Assistant estão na mesma rede local

Informações e acesso à conta

  • Sua câmera SONOFF foi adicionada ao aplicativo eWeLink
  • Função ONVIF/RTSP habilitada via:
    Configurações do dispositivo → Mais configurações → ONVIF/RTSP

Registre as seguintes informações:

  • Endereço IP da câmera
  • Porta ONVIF
  • Nome de usuário e senha (modificáveis)

下载.jpg

3. Emparelhe com o Home Assistant

Etapa 1: instalar a integração ONVIF

  1. Acesse o painel principal do Home Assistant.
  2. Navegue até: Configurações → Dispositivos e serviços → Adicionar integração

  1. Procure por ONVIF e selecione-o

  1. Clique em Enviar

Etapa 2: adicione a câmera

  1. Quando o CAM-PT2 for detectado, selecione-o e clique em Enviar

  1. Digite o nome de usuário e a senha do ONVIF

  1. Clique em Pular e Concluir

Agora você verá sua câmera no painel do Home Assistant, na aba Visão geral .


4. O que você pode fazer

4.1 Transmissão em tempo real

  • Assista ao vídeo ao vivo diretamente no Home Assistant
  • Ativar/desativar áudio

4.2 Status de detecção de movimento e humano

  • Detecção de movimento/humano como gatilhos de automação

4.3 Controle PTZ

  • Criar um novo painel

  • Editar o painel

  • Criar uma nova seção

  • No painel " Por Entidade ", marque as caixas dos sensores de detecção de movimento/pessoas da sua câmera e da entidade de fluxo MainStream. Em seguida, clique em " Adicionar ao Painel " para incluí-los no seu layout.

  • Na seção recém-criada, clique no ícone de edição (⋮) no canto superior direito e escolha “ Editar em YAML ” no menu.

  • Identifique o texto à esquerda de "_mainstream". Este texto representa o nome da sua câmera. Por exemplo, se a string da sua câmera for "cam_pt2_test_mainstream", o nome da câmera será "cam_pt2_test".

 type: grid
square: false
columns: 1
cards:
  - type: entities
    entities:
      - binary_sensor.<camera_name>_cell_motion_detection
      - binary_sensor.<camera_name>_motion_alarm
      - binary_sensor.<camera_name>_person_detection
  - type: picture-glance
    entities:
      - entity: camera.<camera_name>_mainstream
        tap_action:
          action: call-service
          service: onvif.ptz
          service_data:
            entity_id: camera.<camera_name>_mainstream
            pan: LEFT
            speed: 1
            distance: 0.3
            move_mode: ContinuousMove
        name: Pan Left
        show_state: false
        icon: mdi:arrow-left
        show_icon: true
      - entity: camera.<camera_name>_mainstream
        tap_action:
          action: call-service
          service: onvif.ptz
          service_data:
            entity_id: camera.<camera_name>_mainstream
            tilt: UP
            speed: 1
            distance: 0.3
            move_mode: ContinuousMove
        name: Tilt Up
        icon: mdi:arrow-up
      - entity: camera.<camera_name>_mainstream
        tap_action:
          action: call-service
          service: onvif.ptz
          service_data:
            entity_id: camera.<camera_name>_mainstream
            tilt: DOWN
            speed: 1
            distance: 0.3
            move_mode: ContinuousMove
        name: Tilt Down
        icon: mdi:arrow-down
      - entity: camera.<camera_name>_mainstream
        tap_action:
          action: call-service
          service: onvif.ptz
          service_data:
            entity_id: camera.<camera_name>_mainstream
            pan: RIGHT
            speed: 1
            distance: 0.3
            move_mode: ContinuousMove
        name: Pan Right
        icon: mdi:arrow-right
        show_icon: true
    camera_image: camera.<camera_name>_mainstream
    camera_view: live

Por exemplo:

 type: grid
square: false
columns: 1
cards:
  - type: entities
    entities:
      - binary_sensor.cam_pt2_test_cell_motion_detection
      - binary_sensor.cam_pt2_test_motion_alarm
      - binary_sensor.cam_pt2_test_person_detection
  - type: picture-glance
    entities:
      - entity: camera.cam_pt2_test_mainstream
        tap_action:
          action: call-service
          service: onvif.ptz
          service_data:
            entity_id: camera.cam_pt2_test_mainstream
            pan: LEFT
            speed: 1
            distance: 0.3
            move_mode: ContinuousMove
        name: Pan Left
        show_state: false
        icon: mdi:arrow-left
        show_icon: true
      - entity: camera.cam_pt2_test_mainstream
        tap_action:
          action: call-service
          service: onvif.ptz
          service_data:
            entity_id: camera.cam_pt2_test_mainstream
            tilt: UP
            speed: 1
            distance: 0.3
            move_mode: ContinuousMove
        name: Tilt Up
        icon: mdi:arrow-up
      - entity: camera.cam_pt2_test_mainstream
        tap_action:
          action: call-service
          service: onvif.ptz
          service_data:
            entity_id: camera.cam_pt2_test_mainstream
            tilt: DOWN
            speed: 1
            distance: 0.3
            move_mode: ContinuousMove
        name: Tilt Down
        icon: mdi:arrow-down
      - entity: camera.cam_pt2_test_mainstream
        tap_action:
          action: call-service
          service: onvif.ptz
          service_data:
            entity_id: camera.cam_pt2_test_mainstream
            pan: RIGHT
            speed: 1
            distance: 0.3
            move_mode: ContinuousMove
        name: Pan Right
        icon: mdi:arrow-right
        show_icon: true
    camera_image: camera.cam_pt2_test_mainstream
    camera_view: live

  • Após a substituição Com o nome da sua câmera, substitua completamente o código original pela versão modificada. Em seguida, clique em SALVAR e CONCLUÍDO para aplicar as alterações.

  • Neste ponto, você pode ver a transmissão ao vivo da câmera, bem como os botões de controle PTZ. Você pode usar esses botões para girar a câmera para cima, para baixo, para a esquerda e para a direita.

4.4 Automações

Crie automações usando eventos de câmera como gatilhos. Exemplo:

Quando o movimento é detectado:

  • Vá para Informações do dispositivo → + Adicionar automação → Usar dispositivo como gatilho

  • Selecione “Detecção de movimento iniciada”

  • Escolha uma ação:
    Câmera → Gravar , defina o caminho do arquivo como:
    /media/{{ now().strftime('%Y%m%d-%H%M%S') }}.mp4

  • Configurar duração e lookback
  • Clique em Salvar

Você pode então encontrar gravações em Mídia → Minha mídia .


5. Visão geral dos recursos

A câmera SONOFF suporta ONVIF e RTSP, permitindo fácil integração com o Home Assistant. Para ajudar você a entender as diferenças, fornecemos abaixo uma breve visão geral dos recursos.

CAM-PT2

Recurso

ONVIF

RTSP

Descoberta de dispositivos

×

Visualização ao vivo

Controle PTZ

É necessária configuração manual via script.

×

Notificação de Evento

Automação de gatilhos (movimento, humano)

×

 

CAM-S2

Recurso

ONVIF

RTSP

Descoberta de dispositivos

×

Visualização ao vivo

Notificação de Evento

Automação de gatilhos (movimento, humano)

×

 
Anterior
🔎 Como montar ERBS com SONOFF MINI-RBS
Próximo
🔎Como integrar a câmera SONOFF ao Scrypted?
última modificação: 2025-08-20