1. Introduction
Ce guide vous explique comment intégrer la caméra SONOFF à Home Assistant grâce au protocole ONVIF . Grâce à cette configuration, vous pourrez :
- Visionnez la vidéo en temps réel dans Home Assistant
- Recevoir des événements de détection de mouvement et de personne
- Configurer l'automatisation (par exemple, déclencher l'enregistrement lorsqu'un mouvement est détecté)
Avant de commencer, assurez-vous que le micrologiciel de votre appareil et la version de l'application répondent aux exigences de prise en charge ONVIF.
|
*Ce tutoriel prend la caméra SONOFF CAM-PT2 comme exemple.
2. Ce dont vous aurez besoin
Pour terminer cette intégration, assurez-vous de disposer des éléments suivants :
Matériel et logiciels
- Un appareil exécutant Home Assistant (par exemple, Raspberry Pi 4+, PC ou Docker)
- La caméra et Home Assistant sont sur le même réseau local
Informations et accès au compte
- Votre caméra SONOFF a été ajoutée à l'application eWeLink
- Fonction ONVIF/RTSP activée via :
Paramètres de l'appareil → Plus de paramètres → ONVIF/RTSP
Enregistrez les informations suivantes :
- Adresse IP de la caméra
- Port ONVIF
- Nom d'utilisateur et mot de passe (modifiables)
3. Associez-le à Home Assistant
Étape 1 : Installer l'intégration ONVIF
- Accédez au tableau de bord principal de Home Assistant.
- Accédez à : Paramètres → Appareils et services → Ajouter une intégration
- Recherchez ONVIF et sélectionnez-le
- Cliquez sur Soumettre
Étape 2 : ajouter la caméra
- Lorsque CAM-PT2 est détecté, sélectionnez-le et cliquez sur Soumettre
- Entrez le nom d'utilisateur et le mot de passe ONVIF
- Cliquez sur Ignorer et terminer
Vous verrez désormais votre caméra dans le tableau de bord de Home Assistant sous l’ onglet Présentation .
4. Ce que vous pouvez faire
4.1 Streaming en temps réel
- Regardez le flux vidéo en direct directement dans Home Assistant
- Activer/désactiver l'audio
4.2 État de détection de mouvement et de personne
- Détection de mouvement/humain comme déclencheurs d'automatisation
4.3 Contrôle PTZ
- Créer un nouveau tableau de bord
- Modifier le tableau de bord
- Créer une nouvelle section
- Dans le panneau « Par entité », cochez les cases correspondant aux capteurs de détection de mouvement/personne de votre caméra et à l' entité de flux
MainStream
. Cliquez ensuite sur « Ajouter au tableau de bord » pour les inclure à votre mise en page.
- Dans la section nouvellement créée, cliquez sur l’icône d’édition (â‹®) dans le coin supérieur droit et choisissez « Modifier en YAML » dans le menu.
- Identifiez le texte à gauche de « _mainstream ». Ce texte représente le nom de votre caméra. Par exemple, si la chaîne de caractères de votre caméra est « cam_pt2_test_mainstream », son nom sera « 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
Par exemple:
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
- Après avoir remplacé Remplacez le code d'origine par la version modifiée avec le nom de votre appareil photo. Cliquez ensuite sur ENREGISTRER et TERMINÉ pour appliquer les modifications.
- À ce stade, vous pouvez voir le flux en direct de la caméra ainsi que les boutons de commande PTZ. Vous pouvez utiliser ces boutons pour faire pivoter la caméra vers le haut, le bas, la gauche et la droite.
4.4 Automatisations
Créez des automatisations en utilisant des événements de caméra comme déclencheurs. Exemple :
Lorsqu'un mouvement est détecté :
- Accédez à Informations sur l'appareil → + Ajouter une automatisation → Utiliser l'appareil comme déclencheur
- Sélectionnez « Détection de mouvement commencée »
- Choisissez une action :
Appareil photo → Enregistrer , définissez le chemin du fichier comme :
/media/{{ now().strftime('%Y%m%d-%H%M%S') }}.mp4
- Configurer la durée et la rétrospection
- Cliquez sur Enregistrer
Vous pouvez ensuite retrouver les enregistrements sous Médias → Mes médias .
5. Présentation des fonctionnalités
La caméra SONOFF prend en charge les normes ONVIF et RTSP, facilitant ainsi l'intégration avec Home Assistant. Pour vous aider à comprendre les différences, voici un bref aperçu des fonctionnalités.
CAM-PT2
Fonctionnalité |
ONVIF |
RTSP |
Découverte d'appareils |
√ |
× |
Vue en direct |
√ |
√ |
Contrôle PTZ |
√ Une configuration manuelle via un script est requise. |
× |
Notification d'événement |
√ Automatisation des déclencheurs (mouvement, humain) |
× |
CAM-S2
Fonctionnalité |
ONVIF |
RTSP |
Découverte d'appareils |
√ |
× |
Vue en direct |
√ |
√ |
Notification d'événement |
√ Automatisation des déclencheurs (mouvement, humain) |
× |