Intégration Home Assistant (HACS)

Amenez vos caméras, la détection et les enregistrements Yunkan dans Home Assistant avec l'intégration personnalisée officielle — installée en un clic via HACS, sans broker MQTT.

Yunkan propose désormais une intégration personnalisée officielle pour Home Assistant. C'est un client léger qui communique avec votre serveur Yunkan via son API habituelle et le mappe sur des entités natives Home Assistant, un navigateur multimédia et des services — toute la logique d'enregistrement, de détection et de compte reste sur le serveur.

Ouvre ce dépôt dans le HACS de votre Home Assistant en tant que dépôt personnalisé.

Ce que vous obtenez

Caméras avec WebRTC natif (faible latence, repli HLS) et instantanés JPEG — cartes picture-glance, tableaux de bord par zone, export HomeKit et camera.snapshot.
Capteurs de détection par caméra — personne, véhicule, animal, colis, visage, chute, pleurs de bébé et mouvement — avec le nom / la plaque reconnus.
Capteurs de comptage d'objets ainsi que capteurs de visage / plaque reconnus.
Interrupteurs — détection IA, enregistrement, bascules de détection par fonction, suivi automatique PTZ — plus des interrupteurs de détection à l'échelle du serveur sur le hub.
Commandes sur la page de l'appareil — boutons d'actualisation d'instantané et de direction PTZ, liste déroulante de préréglages PTZ et champ de diffusion vocale.
Déclencheurs et actions d'appareil pour les automatisations, plus un blueprint de notification prêt à l'emploi.
Navigateur multimédia pour les enregistrements, événements et instantanés, relayé par l'authentification propre de Home Assistant.

Prérequis

Home Assistant 2024.11 ou plus récent (pour les caméras WebRTC natives).
Un serveur Yunkan accessible — utilisez son adresse d'entrée principale (l'entrée nginx, généralement le port 23406).
Un compte Yunkan. Un compte administrateur est requis pour le PTZ, les interrupteurs de détection et la diffusion vocale ; la consultation fonctionne avec n'importe quel compte.

Installer via HACS

1
Ouvrir dans HACS
Cliquez sur le bouton Ouvrir dans HACS ci-dessus (ou, dans HACS, ouvrez le menu à trois points → Dépôts personnalisés et ajoutez l'URL du dépôt avec la catégorie *Integration*).
2
Installer et redémarrer
Recherchez Yunkan dans HACS, installez-le, puis redémarrez Home Assistant.
3
Ajouter l'intégration
Allez dans Paramètres → Appareils et services → Ajouter une intégration → Yunkan et saisissez l'URL de votre serveur, votre nom d'utilisateur et votre mot de passe.

Installé en tant que dépôt personnalisé

Yunkan n'est pas encore dans la boutique HACS par défaut (une soumission est en cours d'examen), il s'installe donc comme un dépôt personnalisé — le bouton ci-dessus s'en charge. Une fois dans la boutique par défaut, vous pourrez le rechercher directement.

Version gratuite vs Pro

Les caméras, instantanés, événements, capteurs, le navigateur multimédia et le PTZ fonctionnent sur tout serveur Yunkan. La détection IA et la diffusion vocale sont des fonctions Pro ; sur un serveur gratuit, ces actions affichent une invitation à la mise à niveau au lieu d'échouer silencieusement.

Compatible avec la découverte MQTT

Si vous utilisez aussi la découverte MQTT de Yunkan, les deux voies coexistent avec des ID d'entité distincts. Cette intégration est l'alternative plus riche et orientée Pro, et ne nécessite pas de broker MQTT.