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.
|
*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)
3. Emparelhe com o Home Assistant
Etapa 1: instalar a integração ONVIF
- Acesse o painel principal do Home Assistant.
- Navegue até: Configurações → Dispositivos e serviços → Adicionar integração
- Procure por ONVIF e selecione-o
- Clique em Enviar
Etapa 2: adicione a câmera
- Quando o CAM-PT2 for detectado, selecione-o e clique em Enviar
- Digite o nome de usuário e a senha do ONVIF
- 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) |
× |