# 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.

[![Open in HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=mrtian2016&repository=yunkan-hass-integration&category=integration)

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.

---

来源:https://yun-kan.com/fr/docs/home-assistant