Externe Integration - UniFi Protect (Kameras, Klingeln, Erkennungen)

Hallo zusammen! :waving_hand:

Ich habe bereits die Integration von UniFi Network durchgeführt, aber es fehlte noch die Schwester für diejenigen, die Ubiquiti-Kameras haben: UniFi Protect. Es ist die zweithäufigste Kamera-Integration bei Home Assistant, und sie gab es nicht im Store. Sie funktioniert über die offizielle API der Konsole, lokal, ohne Ubiquiti-Cloud-Konto.

Was es kann

  • Kameras: Das Bild (wird regelmäßig aktualisiert, bei jeder Erkennung und auf Anfrage), online oder offline, Bewegung und intelligente Erkennungen Person / Fahrzeug / Tier / Paket (nur die, die Ihre Kamera kann).
  • Klingeln: Drücken der Klingel.
  • Flutlicht: Einschalten, Rückkehr zum Modus, Bewegungserkennung.
  • UP-Sense-Sensoren: Öffnung, Temperatur, Luftfeuchtigkeit, Helligkeit, Bewegung, Wasseraustritt, Batterie, je nach Art der Installation.
  • Zwei Szenarien-Trigger: „Objekt erkannt“ (filterbar nach Kamera und Typ: Person, Fahrzeug…) und „Es wurde geklingelt“. Sie werden ausgelöst, sobald das aktualisierte Bild in Gladys angekommen ist, damit die Benachrichtigung das richtige Foto hat.
  • Zwei Szenarien-Aktionen: Bild einer Kamera aktualisieren und Nachricht auf der Klingel ändern.
  • Ein Widget „Protect“: Online-Kameras, Erkennungen der letzten 24 Stunden und die letzten Erkennungen mit ihrem Bild.
  • Eine Aktion, die Ihnen die RTSP-Adresse einer Kamera gibt, um sie in die „RTSP-Kamera“-Integration von Gladys für den Videostream einzufügen.
  • Auf Französisch, Englisch, Deutsch und Spanisch.

Das coole Feature

Person vor der Garage nachts erkannt → Benachrichtigung mit Foto und das Flutlicht geht an
Es wird geklingelt → Foto des Besuchers auf dem Telefon, und die Klingel zeigt „Ich komme!“ an

Installation

:warning: Gladys 5.1 mindestens, und eine Konsole mit einer aktuellen Version von Protect (Protect 6 oder neuer, die die API „Integration“ hat).

Sie kommt im Store beim nächsten Durchlauf des Indexers. In der Zwischenzeit: Integrationen → Von GitHub installieren, mit GitHub - guim31/gladys-unifi-protect: UniFi Protect cameras, doorbells, lights and sensors for Gladys Assistant, local Integration API · GitHub

  1. In der UniFi-Konsole: Einstellungen → Control Plane → Integrationen, erstellen Sie einen API-Schlüssel.
  2. In Gladys: Die Adresse der Konsole und der Schlüssel. Die Konsole hat ein selbstsigniertes Zertifikat: Aktivieren Sie die Option, um es zu akzeptieren (sie ist standardmäßig deaktiviert, absichtlich).
  3. Verbindung testen, dann Registerkarte Entdeckung, um Ihre Kameras und Sensoren hinzuzufügen.

Kleine ehrliche Vorbehalte

  • Entwickelt ohne Protect-Konsole (ich habe keine UniFi-Kameras): Alles wurde an echten Protect-Antworten getestet, die aus den Tests der uiprotect-Bibliothek von Home Assistant übernommen wurden. Ihr Feedback ist willkommen, besonders zu Erkennungen und der Klingel.
  • Die offizielle API ermöglicht weder die Aktivierung der Aufzeichnung noch das Abschalten der Benachrichtigungen: Diese Aktionen existieren daher nicht.
  • Der Videostream erfolgt über die RTSP-Integration von Gladys, nicht über diese.

Wie die vorherigen, entwickelt mit Claude Code. Unabhängiges Projekt, nicht mit Ubiquiti verbunden.

Repository: GitHub - guim31/gladys-unifi-protect: UniFi Protect cameras, doorbells, lights and sensors for Gladys Assistant, local Integration API · GitHub