Wyze Smart-Home-Integration, kostenlos und Open Source

Steuern Sie Wyze-Lampen, LED-Streifen, Steckdosen, Kameras und Sensoren.

• Veröffentlicht von gboulvin
• Geräte
• Version 1.0.0
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Steuern Sie Ihre Wyze-Geräte mit Gladys Assistant: Lampen, LED-Streifen, Steckdosen, Kameras und Wyze-Sense-Sensoren, mit Szenen-Auslösern und -Aktionen sowie zwei Dashboard-Widgets.

Unterstützte Geräte

Wyze-Gerät	In Gladys
Weiße Lampe (WLPA19, HL_HWB2)	Ein/Aus, Helligkeit, Farbtemperatur
Farblampe (WLPA19C, BR30) und LED-Streifen (HL_LSL)	Ein/Aus, Helligkeit, Farbtemperatur, Farbe — lokale Steuerung im LAN
Steckdose und Außensteckdose (WLPP1, WLPP1CFH, WLPPO)	Ein/Aus (ein Gerät pro Ausgang)
Kameras (Cam v2/v3/v4, Pan, Outdoor, Doorbell...)	Letztes Bild, Bewegung, Stromversorgung, Sirene, Bewegungserkennung
Floodlight Pro, Battery Cam Pro, Cam OG, Pan v4	Letztes Bild und Bewegung (ihre Steuerung nutzt eine andere Wyze-API)
Wyze-Sense-Kontaktsensor (DWS3U, DWS2U)	Offen/geschlossen, Batterie schwach
Wyze-Sense-Bewegungsmelder (PIR3U, PIR2U)	Bewegung, Batterie schwach

Andere Wyze-Geräte (Schlösser, Thermostat, Staubsauger, Waagen...) werden ignoriert.

Vorbereitung: einen Wyze-API-Key erstellen

Wyze lässt Drittanwendungen nur mit einem persönlichen API-Key zusätzlich zu E-Mail und Passwort zu. Der Key erspart auch den Zwei-Faktor-Code.

1. Öffnen Sie die Wyze-Entwicklerkonsole und melden Sie sich mit Ihrem Wyze-Konto an.
2. Erstellen Sie einen API-Key. Kopieren Sie die KEY ID und den API KEY: Der API KEY wird nur einmal angezeigt.
3. Bewahren Sie beide für die Konfiguration auf. Sie können den Key jederzeit in derselben Konsole widerrufen.

Konfiguration

1. Öffnen Sie den Reiter Konfiguration der Integration.
2. Geben Sie Ihre Wyze-E-Mail, Ihr Passwort, die API-Key-ID und den API-Key ein.
3. Ändern Sie bei Bedarf das Aktualisierungsintervall (standardmäßig 60 Sekunden, mindestens 30): wie oft Zustände und Kameraereignisse gelesen werden.
4. Speichern Sie und klicken Sie auf Verbindung testen: Die Integration meldet sich an und zeigt, wie viele kompatible Geräte sie gefunden hat.
5. Öffnen Sie den Reiter Erkennung und fügen Sie die gewünschten Geräte in Gladys hinzu.

Nur die hinzugefügten Geräte werden bei jeder Aktualisierung gelesen, das schont die Wyze-Cloud. Jetzt synchronisieren erzwingt eine Aktualisierung.

Lokale Steuerung

Wyze ist ein Cloud-Dienst, mit einer Ausnahme: Farblampen und LED-Streifen nehmen Befehle im lokalen Netzwerk an. Wenn Lokale Verbindung bevorzugen aktiv ist (Standard), gehen ihre Befehle direkt an die Lampe; die Zustände werden weiterhin aus der Cloud gelesen.

Das Abzeichen jedes Geräts zeigt den genutzten Kanal: lokal, Cloud oder nicht erreichbar, wenn Wyze das Gerät als offline meldet. Ein orangefarbener Punkt bedeutet, dass ein lokaler Befehl fehlgeschlagen ist und die Lampe über die Cloud angesteuert wurde; Gladys versucht es nach 5 Minuten wieder lokal. Gladys muss die Lampe über TCP-Port 88 erreichen können (gleiches Netzwerk, keine Client-Isolation im WLAN).

Kameras

Die Wyze-Cloud bietet kein Live-Video: Das Kamerabild in Gladys ist das letzte Vorschaubild, das Wyze speichert, meist das des letzten Ereignisses. Es wird bei jedem neuen Ereignis aktualisiert. Gladys akzeptiert nur Bilder bis 150 KB; ein größeres Vorschaubild wird übersprungen (siehe Logs).

Die Funktion Bewegung einer Kamera steht etwa 30 Sekunden lang auf 1, wenn die Kamera ein Bewegungsereignis aufzeichnet, und dann wieder auf 0. Die Erkennung hängt von den Kameraeinstellungen in der Wyze-App ab (Erkennungszonen, Empfindlichkeit, Benachrichtigungen). Die Objekte (Person, Fahrzeug, Haustier, Paket) erfordern ein Cam-Plus-Abonnement.

Szenen

Die Integration fügt dem Szeneneditor eigene Karten hinzu (Gladys 5.1 oder neuer).

Auslöser:

• Wyze-Kameraereignis — eine Kamera hat ein Ereignis aufgezeichnet. Filtern Sie nach Kamera, Ereignis (Bewegung, Geräusch, Rauchalarm, CO-Alarm, Türklingel, Gesicht, andere) und erkanntem Objekt (Person, Fahrzeug, Haustier, Paket, nichts). Leere Filter passen auf alles. Die folgenden Aktionen können {{triggerEvent.data.event}} und {{triggerEvent.data.object}} lesen.
• Wyze-Gerät online/offline — ein Gerät hat die Cloud-Verbindung verloren oder wiederhergestellt. Variable: {{triggerEvent.data.status}} (offline / online).

Aktionen:

• Sirene der Wyze-Kamera — startet oder stoppt die Sirene einer Kamera.
• Wyze-Bewegungserkennung — aktiviert oder deaktiviert die Bewegungserkennung einer Kamera (zum Beispiel bei scharfer Alarmanlage).
• Bild der Wyze-Kamera — veröffentlicht das letzte Bild einer Kamera, um es danach mit der Gladys-Aktion „Kamerabild senden“ zu verschicken.
• Wyze-Geräte aktualisieren — liest die Geräte sofort; liefert die Anzahl der Geräte und der Geräte online.

Eine Kamera, die eine Aktion nicht ausführen kann (Floodlight Pro...), liefert false, statt fehlzuschlagen, damit die folgenden Aktionen davon abhängen können.

Dashboard

Im Dashboard-Editor stehen zwei Widgets zur Verfügung:

• Wyze-Übersicht — Geräte, online und offline, offene Türen und Fenster, Cloud-Status, letzte Aktualisierung, letztes Kameraereignis und eine Schaltfläche Jetzt synchron..
• Wyze-Kamera — wählen Sie eine Kamera in den Widget-Einstellungen: letztes Bild, Live-Bewegung, Verbindung, letztes Ereignis und Sirenen-Schaltflächen (die Sirene fragt nach einer Bestätigung).

Fehlerbehebung

• „Wyze hat die Anmeldung abgelehnt“ — prüfen Sie E-Mail und Passwort und ob API-Key-ID und API-Key zum selben Key gehören. Nach einer Ablehnung wartet Gladys 15 Minuten vor dem nächsten Versuch (Wyze sperrt Konten, die sich zu oft anmelden); das Speichern der Konfiguration versucht es sofort erneut.
• Ein Gerät aktualisiert sich nicht — prüfen Sie in der Wyze-App, ob es online ist; die Zustände werden in jedem Aktualisierungsintervall gelesen.
• Eine Farblampe bleibt in der Cloud — prüfen Sie, ob Gladys die Lampe über TCP-Port 88 erreicht, oder deaktivieren Sie Lokale Verbindung bevorzugen.
• Logs — öffnen Sie die Logs der Integration in Gladys (oder docker logs), mit LOG_LEVEL=debug für Details. Passwörter und Tokens werden nie protokolliert.

Datenschutz

Ihre Zugangsdaten speichert Gladys in seiner Konfiguration. Die Wyze-Sitzung (Zugriffs- und Aktualisierungstoken) liegt im privaten Volume der Integration, damit ein Neustart keine neue Anmeldung auslöst. Die Integration spricht nur mit der Wyze-Cloud und mit Ihren Farblampen im lokalen Netzwerk.

Diese Integration ist nicht mit Wyze Labs verbunden. Sie nutzt dieselbe Cloud-API wie die Wyze-App, die Wyze ohne Vorankündigung ändern kann.

Konfigurationseinstellungen

Diese Einstellungen fragt Wyze in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Wyze-Konto verbinden	section	Nein	Wyze verlangt zusätzlich zu E-Mail und Passwort einen persönlichen API-Key. Erstellen Sie ihn in der Wyze-Entwicklerkonsole mit Ihrem Wyze-Konto und kopieren Sie Key-ID und API-Key unten hinein. Der API-Key erspart auch die Zwei-Faktor-Abfrage.
Wyze-E-Mail	string	Ja
Wyze-Passwort	secret	Ja
API-Key-ID	string	Ja	Die „KEY ID“ der Wyze-Entwicklerkonsole.
API-Key	secret	Ja	Der „API KEY“, der beim Erstellen einmalig angezeigt wird.
Aktualisierungsintervall (s)	number	Nein	Wie oft Zustände und Kameraereignisse aus der Wyze-Cloud gelesen werden, in Sekunden (mindestens 30).

So installierst du Wyze in Gladys

1. Öffne in Gladys Integrationen: Wyze erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/gboulvin/gladys-wyze:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/gboulvin/Gladys-Wyze.

Wyze 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

Wyze 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 gboulvin 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

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂