[BETA] UniFi Door: UniFi Access/Protect Türstation (z. B. G6 Entry)

Das SIP-basierte DoorIP funktioniert mit UniFi-Türstationen nicht. Deshalb habe ich mit Claude ein Modul gebaut, das die Türstation über die UniFi-APIs einbindet: Klingel erkennen, Tür öffnen, Kamerabild und Livebild anzeigen.

Status: Beta. Es läuft bei mir mit einer G6 Entry und einem Door Hub Mini. Andere UniFi-Türstationen habe ich nicht getestet, Rückmeldungen sind willkommen.

Was funktioniert (am echten Gerät getestet)

  • Tür öffnen über die UniFi Access API, als Schalter und per Funktionsaufruf UFD_Unlock($id). Der Schalter springt nach 5 Sekunden zurück.
  • Klingel-Erkennung per Webhook aus dem UniFi Protect Alarm Manager (Variablen „Es klingelt” und „Letztes Klingeln”). Wiederholte Zustellungen desselben Ereignisses werden ignoriert.
  • Auswahl per Liste: Tür und Kamera werden aus den APIs geladen, keine IDs zum Abtippen.
  • Türkamera-Snapshot wahlweise über die offizielle Protect-API, eine Snapshot-URL oder ein vorhandenes Bild-Medienobjekt (z. B. aus dem UniFi-Protect-Modul).
  • Live-Video über Symcons eigenen Stream-Medientyp (RTSP/RTSPS, H.264) oder ein vorhandenes Stream-Medienobjekt.
  • Push-Benachrichtigung über die neue Kachel Visualisierung. Die alte WebFront Visualisierung unterstützt das Modul bewusst nicht.
  • Wandpanel-Modus: Beim Klingeln öffnet sich das Kamera-Popup automatisch auf allen verbundenen Geräten der Visualisierung, ganz ohne Antippen. Es schließt sich nach einer einstellbaren Zeit selbst (Standard 60 Sekunden).
  • Interaktives Popup mit „Tür öffnen”-Button (optional, ab Symcon 9.1): Bild und Button erscheinen am Wandpanel, nach dem Öffnen schließt sich das Popup. Das Bild ist ein Snapshot, kein Live-Video.

Was noch nicht funktioniert oder ungetestet ist

  • Echtes Gegensprechen ist nicht gebaut. Vorhanden sind nur Diagnose-Funktionen: Kameras auflisten, Lautsprecher prüfen und ein Testton über die offizielle Protect-API (braucht ffmpeg auf dem Symcon-Host). Auch der Testton ist noch nicht am Gerät geprüft. Ich brauch das Gegensprechen für mich nicht, bei Bedarf ergänze ich es aber gerne.
  • Kein Live-Video im interaktiven Popup. Wer Video im Popup will, nutzt das normale Medien-Popup, dort gibt es aber keinen Button. Hier fehlt mir das Knowhow um es entsprechend zu ergänzen.
  • Der Timeout schließt das normale Medien-Popup über einen Neustart der Visualisierung. Das gilt für alle verbundenen Geräte, nicht nur fürs Wandpanel, weil Symcon keine Funktion zum Schließen anbietet, bzw. ich diese nicht gefunden habe.
  • Mit der Option „interaktives Popup” zeigt auch die normale Instanz-Kachel die neue Ansicht statt der Variablenliste.
  • Ereignis-Historie aus dem Access-Systemprotokoll fehlt.

Voraussetzungen

  • IP-Symcon ab 8.2, interaktives Popup ab 9.1
  • UniFi Access (API-Token) und UniFi Protect (API-Key unter Einstellungen → Integrations der Konsole)
  • Kamera-Kodierung „Standard” (H.264), mit H.265 kann Symcon den Stream nicht abspielen
  • Eine WebHook-Control-Instanz

Installation: Im Module Store muss exakt nach „Unifi Door” gesucht werden, sonst wird das Modul nicht gefunden. Alternativ die Git-URL in der Modulverwaltung einbinden.

Mithelfen: Der Code liegt öffentlich auf GitHub: GitHub - sunny-ww/SymconUniFiDoor: IP-Symcon-Modul für UniFi-Türstationen (G6 Entry / Door Hub Mini) — Ersatz für DoorIP · GitHub. Issues, Pull Requests und Tests mit anderer Hardware sind willkommen. Besonders gesucht: ein echter Gegensprech-Pfad (Mikrofon aus der Kachel über Opus/RTP in die Talkback-Session) und eine sauberere Lösung zum Schließen des Popups.