Intégration externe - UniFi Protect (caméras, sonnettes, détections)

Salut tout le monde ! :waving_hand:

J’ai déjà fait l’intégration UniFi Network, mais il manquait sa sœur pour ceux qui ont des caméras Ubiquiti : UniFi Protect. C’est la 2ᵉ intégration caméra la plus utilisée chez Home Assistant, et elle n’existait pas dans le store. Elle passe par l’API officielle de la console, en local, sans compte cloud Ubiquiti.

Ce que ça fait

  • Caméras : l’image (rafraîchie régulièrement, à chaque détection et à la demande), en ligne ou non, le mouvement, et les détections intelligentes personne / véhicule / animal / colis (seulement celles que votre caméra sait faire).
  • Sonnettes : l’appui sur la sonnette.
  • Projecteurs (Floodlight) : allumer, revenir à leur mode, détection de mouvement.
  • Capteurs UP-Sense : ouverture, température, humidité, luminosité, mouvement, fuite d’eau, batterie, selon la façon dont ils sont posés.
  • Deux déclencheurs de scène : « objet détecté » (filtrable par caméra et par type : personne, véhicule…) et « on sonne ». Ils partent une fois l’image fraîche arrivée dans Gladys, pour que la notification ait la bonne photo.
  • Deux actions de scène : rafraîchir l’image d’une caméra, et changer le message affiché sur la sonnette.
  • Un widget « Protect » : caméras en ligne, détections des dernières 24 h et les dernières détections avec leur image.
  • Une action qui vous donne l’adresse RTSP d’une caméra, à coller dans l’intégration « Caméra RTSP » de Gladys pour le flux vidéo.
  • En français, anglais, allemand et espagnol.

Le truc sympa

Personne détectée devant le garage la nuit → notification avec la photo et le projecteur qui s’allume
On sonne → la photo du visiteur sur le téléphone, et la sonnette qui affiche « J’arrive ! »

Installation

:warning: Gladys 5.1 minimum, et une console avec une version récente de Protect (Protect 6 ou plus récent, qui a l’API « Integration »).

Elle arrive dans le store au prochain passage de l’indexeur. En attendant : Intégrations → Installer depuis GitHub, avec GitHub - guim31/gladys-unifi-protect: UniFi Protect cameras, doorbells, lights and sensors for Gladys Assistant, local Integration API · GitHub

  1. Dans la console UniFi : Settings → Control Plane → Integrations, créez une clé d’API.
  2. Dans Gladys : l’adresse de la console et la clé. La console a un certificat auto-signé : cochez l’option prévue pour l’accepter (elle est désactivée par défaut, exprès).
  3. Tester la connexion, puis onglet Découverte pour ajouter vos caméras et capteurs.

Petites réserves honnêtes

  • Développée sans console Protect (je n’ai pas de caméras UniFi) : tout a été testé sur de vraies réponses de Protect, reprises des tests de la bibliothèque uiprotect de Home Assistant. Vos retours sont les bienvenus, surtout sur les détections et la sonnette.
  • L’API officielle ne permet ni d’activer l’enregistrement ni de couper les notifications : ces actions n’existent donc pas.
  • Le flux vidéo passe par l’intégration RTSP de Gladys, pas par celle-ci.

Comme les précédentes, développée avec Claude Code. Projet indépendant, non affilié à Ubiquiti.

Dépôt : GitHub - guim31/gladys-unifi-protect: UniFi Protect cameras, doorbells, lights and sensors for Gladys Assistant, local Integration API · GitHub