1. Introducción
Esta guía le guía en la integración de la cámara SONOFF en Home Assistant mediante el protocolo ONVIF . Con esta configuración, podrá:
- Ver video en tiempo real en Home Assistant
- Recibir eventos de detección de movimiento y personas
- Configurar la automatización (por ejemplo, activar la grabación cuando se detecta movimiento)
Antes de comenzar, asegúrese de que el firmware de su dispositivo y la versión de la aplicación cumplan con los requisitos de compatibilidad con ONVIF.
|
*Este tutorial toma como ejemplo la cámara SONOFF CAM-PT2.
2. Lo que necesitarás
Para completar esta integración, asegúrese de tener lo siguiente:
Hardware y software
- Un dispositivo que ejecuta Home Assistant (por ejemplo, Raspberry Pi 4+, PC o Docker)
- Tanto la cámara como Home Assistant en la misma red local
Información y acceso a la cuenta
- Su cámara SONOFF se ha añadido a la aplicación eWeLink
- Función ONVIF/RTSP habilitada mediante:
Configuración del dispositivo → Más configuraciones → ONVIF/RTSP
Registre la siguiente información:
- Dirección IP de la cámara
- Puerto ONVIF
- Nombre de usuario y contraseña (modificable)
3. Emparejar con Home Assistant
Paso 1: Instalar la integración ONVIF
- Vaya al panel principal de Home Assistant.
- Vaya a: Configuración → Dispositivos y servicios → Agregar integración
- Busque ONVIF y selecciónelo
- Haga clic en Enviar
Paso 2: Agregar la cámara
- Cuando se detecte CAM-PT2, selecciónelo y haga clic en Enviar
- Ingrese el nombre de usuario y la contraseña de ONVIF
- Haga clic en Omitir y finalizar
Ahora verá su cámara en el panel de Home Assistant, en la pestaña Descripción general .
4. Qué puedes hacer
4.1 Transmisión en tiempo real
- Vea la transmisión de video en vivo directamente en Home Assistant
- Activar o desactivar el audio
4.2 Estado de detección de movimiento y personas
- Detección de movimiento/humanos como desencadenadores de automatización
4.3 Control PTZ
- Crear un nuevo panel de control
- Editar el tablero de instrumentos
- Crear una nueva sección
- En el panel " Por entidad ", marque las casillas de los sensores de detección de movimiento/personas de su cámara y la entidad de flujo
MainStream
. Luego, haga clic en " Añadir al panel " para incluirlos en su diseño.
- En la sección recién creada, haga clic en el ícono de edición (⋮) en la esquina superior derecha y elija “ Editar en YAML ” en el menú.
- Identifica el texto a la izquierda de "_mainstream". Este texto representa el nombre de tu cámara. Por ejemplo, si la cadena de tu cámara es "cam_pt2_test_mainstream", entonces el nombre de la cámara 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 ejemplo:
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
- Después de reemplazar Con el nombre de tu cámara, reemplaza el código original por la versión modificada. Luego, haz clic en GUARDAR y LISTO para aplicar los cambios.
- En este punto, puede ver la transmisión en vivo de la cámara, así como los botones de control PTZ. Puede usar estos botones para girar la cámara hacia arriba, abajo, izquierda y derecha.
4.4 Automatizaciones
Crea automatizaciones usando eventos de cámara como activadores. Ejemplo:
Cuando se detecta movimiento:
- Vaya a Información del dispositivo → + Agregar automatización → Usar dispositivo como disparador
- Seleccione “Detección de movimiento iniciada”
- Elija una acción:
Cámara → Grabar , configure la ruta del archivo como:
/media/{{ now().strftime('%Y%m%d-%H%M%S') }}.mp4
- Configurar la duración y la retrospección
- Haga clic en Guardar
Luego podrás encontrar grabaciones en Medios → Mis medios .
5. Descripción general de las funciones
La cámara SONOFF es compatible con ONVIF y RTSP, lo que facilita su integración con Home Assistant. Para ayudarle a comprender las diferencias, a continuación se ofrece un breve resumen de sus funciones.
CAM-PT2
Característica |
ONVIF |
RTSP |
Descubrimiento de dispositivos |
√ |
× |
Vista en vivo |
√ |
√ |
Control PTZ |
√ Se requiere configuración manual mediante script. |
× |
Notificación de eventos |
√ Automatización de activadores (movimiento, humano) |
× |
CAM-S2
Característica |
ONVIF |
RTSP |
Descubrimiento de dispositivos |
√ |
× |
Vista en vivo |
√ |
√ |
Notificación de eventos |
√ Automatización de activadores (movimiento, humano) |
× |