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. Home Assistant ouvre ensuite la page de connexion de Yunkan : connectez-vous à votre manière habituelle, puis cliquez sur « Autoriser ». La section suivante détaille cette étape.

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.

Comment la connexion se fait : un clic d'autorisation sur Yunkan

La nouvelle intégration ne vous demande plus votre mot de passe. À l'ajout de l'intégration, vous ne saisissez que l'adresse du serveur Yunkan : Home Assistant ouvre alors la page de connexion de Yunkan, vous vous y connectez à votre manière habituelle — mot de passe, code de vérification, clé d'accès ou authentification unique — puis vous cliquez sur « Autoriser » après avoir vérifié la demande. Yunkan remet un jeton dédié à Home Assistant, et votre mot de passe ne quitte jamais votre côté.

Un compte protégé par la vérification en deux étapes se connecte sans difficulté — l'étape de connexion se déroule sur les pages de Yunkan, et c'est là que le code est saisi.
Vous pouvez couper l'accès à tout moment — ce jeton figure dans Paramètres → Jetons API, son nom mentionnant Home Assistant ; supprimez-le et l'intégration perd immédiatement tout accès. Pour rétablir, refaites l'autorisation depuis Home Assistant.
Les serveurs Yunkan plus anciens n'ont pas de page d'autorisation — l'intégration retombe alors d'elle-même sur l'identifiant et le mot de passe, comme avant. Cette méthode ne fonctionne pas avec un compte protégé par la vérification en deux étapes : mettez d'abord le serveur à jour.

Quand le jeton n'est plus valable

Dans Home Assistant, l'intégration signale qu'une nouvelle authentification est nécessaire : ouvrez-la et refaites la même autorisation, sans avoir à la supprimer puis à la rajouter.

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.

Cette page vous a-t-elle été utile ?