Imou Life Smart-Home-Integration, kostenlos und Open Source
Imou-Kameras über die offizielle Imou Open API: Bilder, Bewegung, Personen, Klingel, Privatsphäre.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Imou-Kameras und -Türklingeln (Ranger, Cruiser, Bullet, Cell, Versa, Türklingeln…) in Gladys, über die offizielle Imou Open API (open.imoulife.com): Kamerabilder, Bewegungs- und Personenerkennung, Türklingel, Privatsphäre-Modus, Bewegungserkennung, Flutlicht, Sirene, Schwenken und Neigen, Batterie und SD-Karte.
Ohne die Hardware entwickelt (Developed without the hardware): Rückmeldungen sind willkommen. Diese Integration wurde nach der Imou-Dokumentation und den quelloffenen Imou-Bibliotheken geschrieben, ohne Imou-Kamera und ohne Imou-Entwicklerkonto. Wenn etwas mit deinem Modell nicht funktioniert, eröffne bitte ein Ticket: https://github.com/guim31/gladys-imou/issues
Diese Integration ist nicht mit Imou oder Dahua verbunden.
Voraussetzungen
- Gladys Assistant 5.1 oder neuer (die Schwenkpfeile im Dashboard brauchen Gladys 5.2).
- Deine Kameras in der Imou Life-App.
- Ein kostenloses Imou-Entwicklerkonto für eine AppId und ein AppSecret:
- Geh auf open.imoulife.com und registriere dich mit derselben Anmeldung wie in der Imou-Life-App (Gladys sieht die Kameras dieses Kontos).
- Öffne die Konsole, My App → App Information, klicke auf Edit, fülle die Felder aus und speichere.
- Kopiere die AppId und das AppSecret dieser Seite.
- Gladys braucht Internet: Alles läuft über die Imou-Cloud.
Konfiguration
In Gladys, Integrationen → Imou Life → Konfiguration:
| Einstellung | Was sie tut |
|---|---|
| AppId | Die AppId deiner Entwickleranwendung. |
| AppSecret | Das zugehörige AppSecret. Es signiert nur die Anfragen: nie gesendet, nie in die Protokolle geschrieben. |
| Rechenzentrum | Wo dein Imou-Konto liegt: Europa (Standard), Asien-Pazifik, Amerika oder China. |
| Alarmabfrage | Wie oft die Alarme jeder Kamera gelesen werden (30 Sekunden bis 10 Minuten, standardmäßig 1 Minute). |
| Kamerabilder | Wie oft ein neues Bild der Kameras mit Netzteil aufgenommen wird (standardmäßig 15 Minuten). |
| Abschalten der Überwachung erlauben | Erlaubt Szenen und Widget, die Erkennung abzuschalten oder den Privatsphäre-Modus einzuschalten. Aus. |
| Sirene erlauben | Fügt Kameras mit Sirene einen Schalter dafür hinzu. Standardmäßig aus. |
| Sprache der Namen | Sprache der Funktionsnamen und der Texte für Szenen (standardmäßig Französisch). |
Dann Verbindung testen: Das Ergebnis nennt die Zahl der Kameras und etwa wie viele Aufrufe pro Tag deine Einstellungen kosten. Die Kameras erscheinen im Tab Erkennung: Füge die gewünschten hinzu. Nur die zu Gladys hinzugefügten Kameras werden gelesen.
Geräte
Ein Gladys-Gerät pro Kamera (eines pro Objektiv einer Doppelobjektiv-Kamera oder pro Kanal eines Rekorders), erkannt an seiner Imou-Seriennummer. Jede Kamera bekommt nur die Funktionen, die sie hat:
| Funktion | Was sie zeigt |
|---|---|
| Bild | Die letzte Aufnahme oder das letzte Alarmbild, angezeigt von der Kamerabox des Dashboards. |
| Schwenken und Neigen | Pfeile (und Zoom) der motorisierten Kameras: Jeder Druck ist ein kurzer Schritt, die Kamera hält selbst. |
| Bewegung | 1 für eine Minute nach einer Erkennung (Personen eingeschlossen). |
| Person | 1 für eine Minute, nachdem die Kamera eine Person erkannt hat. |
| Türklingel | Türklingeln: 1, dann 0, wenn jemand klingelt. |
| Letztes Ereignis | „Person · 18:32“. |
| Online | Die Kamera antwortet der Imou-Cloud. Eine schlafende Akkukamera ist online. |
| Bewegungserkennung | Ob die Bewegungserkennung an ist. Nur lesbar: siehe Szenenaktionen. |
| Privatsphäre-Modus | Ob das Objektiv verdeckt ist. Nur lesbar: siehe Szenenaktionen. |
| Flutlicht | Das Flutlicht der Kameras, die eines haben: an/aus über Gladys. |
| Sirene | Nur wenn Sirene erlauben aktiviert ist. |
| Batterie | Akkukameras, in %. |
| SD-Karte | Normal, keine Karte, wird formatiert, Fehler. |
| Größe der SD-Karte | In GB. |
| Freier Platz der SD-Karte | In GB (0 ohne Karte). |
Bewegungserkennung und Privatsphäre-Modus werden angezeigt, aber nie als Schalter angeboten: Ein versehentliches Abschalten (ein Sprachassistent, eine Szene „alles aus“) ließe das Haus unbewacht. Beide ändern sich über die Szenenaktionen und das Widget.
Aktualisierung und Kontingent
Gladys fragt diese Kameras nicht ab: Die Integration liest die Imou-Cloud mit eigenen Timern.
- Die Geräteliste (ein Aufruf für alle Kameras) alle 10 Minuten: Namen, Online-Status.
- Die Alarme jeder zu Gladys hinzugefügten Kamera im Takt der Alarmabfrage: ein Aufruf pro Kamera.
- Bewegungserkennung, Privatsphäre-Modus und Flutlicht alle 30 Minuten, Batterie und SD-Karte jede Stunde, und gleich nach einem Befehl.
- Eine Aufnahme jeder Kamera mit Netzteil im Takt der Kamerabilder. Akkukameras weckt dieser Timer nie.
Jeder Aufruf zählt im Kontingent deines Imou-Entwicklerkontos. Mit den Standardeinstellungen kostet eine Kamera mit Netzteil etwa 1 700 Aufrufe pro Tag (davon 1 440 für die Alarme): Stell die Alarmabfrage langsamer, um zu sparen. Imou ändert die Grenzen seines kostenlosen Tarifs mit der Zeit: Du findest sie unter My Resources in der Konsole. Meldet Imou ein aufgebrauchtes Kontingent, stoppen alle Abfragen für eine Stunde, und die Konfigurationsseite sagt es.
Widget
Imou-Kameras zeigt das neueste Bild der gewählten Kameras (standardmäßig alle), eine Zeile pro Kamera (Privatsphäre-Modus, letztes Ereignis, online, im Ruhezustand oder offline) und, wenn es eine einzige Kamera zeigt, eine Taste Neues Bild und den Privatsphäre-Modus: Fortsetzen immer, Privatsphäre nur wenn Abschalten der Überwachung erlauben aktiviert ist, nach einer Bestätigung.
Szenenauslöser
- Bewegung von einer Imou-Kamera erkannt: jede Erkennung, Personen eingeschlossen. Filter: Kamera, was erkannt wurde (Bewegung, Person). Variablen: Name der Kamera, was erkannt wurde.
- Person von einer Imou-Kamera erkannt: Die Personenerkennung der Kamera hat jemanden gesehen. Variable: Name der Kamera.
- Jemand klingelt an einer Imou-Türklingel: Filter: Türklingel. Variable: Name der Türklingel.
Das Kamerabild wird vor dem Auslösen aktualisiert: „Kamerabild senden“ sendet das Bild des Ereignisses. Ereignisse werden im Takt der Alarmabfrage gelesen: Rechne mit bis zu dieser Verzögerung.
Szenenaktionen
- Bild einer Imou-Kamera aktualisieren: sofort eine Aufnahme.
- Imou-Kamera drehen: ein Schritt nach links, rechts, oben, unten, hinein- oder herauszoomen.
- Privatsphäre-Modus einer Imou-Kamera: an (Objektiv verdeckt) oder aus (Kamera überwacht). An braucht Abschalten der Überwachung erlauben.
- Bewegungserkennung einer Imou-Kamera: an oder aus. Aus braucht Abschalten der Überwachung erlauben.
Szenenbeispiele
- Wenn Person von einer Imou-Kamera erkannt nachts von der Einfahrtskamera kommt: Außenlicht einschalten und ihr Bild per Nachricht senden.
- Wenn Jemand klingelt an einer Imou-Türklingel: das Bild der Türklingel an die Familie senden und auf den Lautsprechern ansagen.
- Wenn die letzte Person das Haus verlässt: Privatsphäre-Modus einer Imou-Kamera aus für die Innenkameras; bei der Rückkehr (wenn das Abschalten erlaubt ist): an.
Fehlerbehebung
- „Imou hat die AppId oder das AppSecret abgelehnt“: Kopiere sie erneut aus My App und prüfe das Rechenzentrum deines Kontos.
- Keine Kamera gefunden: Das Entwicklerkonto muss dieselbe Anmeldung wie die Imou-Life-App nutzen. Eine geteilte Kamera erscheint nur mit Steuerungsrecht.
- „Über der Gerätegrenze des kostenlosen Tarifs“: Der kostenlose Imou-Entwicklertarif steuert nur eine begrenzte Zahl von Geräten. Behalte die nötigen Kameras auf diesem Konto oder teile die anderen mit einem zweiten Konto mit eigener AppId.
- Kontingent aufgebraucht: Stell Alarmabfrage und Kamerabilder langsamer oder füge weniger Kameras hinzu.
- Kein Bild: Die Kamera ist offline, im Ruhezustand oder im Privatsphäre-Modus. Manche Modelle verschlüsseln ihre Alarmbilder: Die Integration nimmt dann ein Bild der Kameras mit Netzteil auf.
- Protokolle: Integrationen → Imou Life → Protokolle.
LOG_LEVEL=debugzeigt jede Abfrage. AppSecret, AppId, Tokens und Bildadressen werden nie geschrieben.
Grenzen
- Nur Cloud: Imou-Cloud und Internetzugang sind nötig. Imou kann Ereignisse nicht an Gladys senden (sein Push braucht eine öffentliche Adresse): Die Alarme werden bei jeder Alarmabfrage gelesen, eine Szene startet also bis zu dieser Verzögerung nach dem Ereignis.
- Kein Live-Video: Das Dashboard zeigt das letzte Bild.
- Kameras der neueren Imou-Plattform (von Verbindung testen gemeldet) haben nur Bild, Alarme und Online-Status.
- Akkukameras werden nicht per Timer aufgenommen (jede Aufnahme würde sie wecken), ihre SD-Karte wird nicht gelesen.
- Personenerkennung, Türklingel und Fähigkeiten stammen aus der Imou-Dokumentation, nicht aus Tests an echten Kameras: Rückmeldungen sind willkommen.
- Ohne die Hardware und ohne Imou-Konto entwickelt; nicht mit Imou oder Dahua verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Imou Life in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Deine Imou-Entwickleranwendung | section | Nein | Gladys liest deine Kameras über die offizielle Imou Open API. Lege mit der Anmeldung der Imou-Life-App ein kostenloses Entwicklerkonto auf open.imoulife.com an und kopiere AppId und AppSecret unter „My App“. |
| AppId | string | Ja | Seite „My App“ der Imou-Entwicklerkonsole. |
| AppSecret | secret | Ja | Signiert die Anfragen: Es wird nie gesendet oder in die Protokolle geschrieben. |
| Rechenzentrum | select | Nein | Wo dein Imou-Konto liegt. Europa für ein in Europa angelegtes Konto. |
| Alarmabfrage | select | Nein | Wie oft die Alarme jeder Kamera gelesen werden: jedes Mal ein Imou-Aufruf pro Kamera, der im Kontingent deines Entwicklerkontos zählt. |
| Kamerabilder | select | Nein | Wie oft ein neues Bild der Kameras mit Netzteil aufgenommen wird: Die Kamerabox des Dashboards zeigt es. Akkukameras: nur bei Alarm. |
| Abschalten der Überwachung erlauben | boolean | Nein | Erlaubt Szenen und Widget, die Bewegungserkennung abzuschalten oder den Privatsphäre-Modus einzuschalten. Standardmäßig aus: Ein Fehler ließe das Haus unbewacht. |
| Sirene erlauben | boolean | Nein | Fügt Kameras mit Sirene einen Schalter dafür hinzu. Standardmäßig aus: Ein Szenenfehler würde die Nachbarn wecken. |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen und der Texte für Szenen. Die Namen werden beim Hinzufügen festgelegt. |
So installierst du Imou Life in Gladys
- Öffne in Gladys Integrationen: Imou Life erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-imou:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-imou.
Imou Life benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Imou Life ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation