Huawei Health Smart-Home-Integration, kostenlos und Open Source
Huawei-Uhren, -Armbänder und -Waagen: Schritte, Herz, SpO2, Schlaf, Gewicht in Gladys.
Veröffentlicht von gboulvin
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.3.0
- ★ 0
Ihr Huawei Health-Konto in Gladys: die Gesundheitswerte Ihrer Huawei-Uhren, -Armbänder und -Waagen (Schritte, Herzfrequenz, SpO2, Stress, Schlaf, Gewicht, Körpertemperatur), Szenenauslöser und -aktionen sowie drei Dashboard-Widgets.
Die Integration liest die Huawei Health Cloud über die offizielle Huawei-API Health Service Kit. Sie schreibt nie in Ihr Konto. Ihre Uhr synchronisiert wie gewohnt über die Huawei Health-App auf Ihrem Telefon; Gladys liest anschließend die Cloud.
Bevor Sie beginnen. Huawei öffnet Health Service Kit nur für geprüfte Apps. Sie benötigen ein eigenes (kostenloses) Huawei-Entwicklerkonto und eine freigegebene App: Rechnen Sie mit etwa 10 Werktagen Prüfung durch Huawei. Die Schritte folgen unten.
1. Ihre Huawei-App erstellen
- Erstellen Sie ein Entwicklerkonto auf HUAWEI Developers und schließen Sie die Identitätsprüfung ab (Privatperson oder Unternehmen).
- Öffnen Sie in der Console HUAWEI ID → Apply for HUAWEI ID.
Wählen Sie den Produkttyp Server app (oder Web app), erstellen Sie
das Produkt und tragen Sie unter Callback URL die Weiterleitungs-URI
ein, die Gladys unter der Schaltfläche Verbinden der Integration anzeigt
(standardmäßig
https://my.gladysassistant.com/redirect/oauth). - Notieren Sie die App ID (Client-ID) und das App secret (Client-Secret).
- Öffnen Sie in der Console Health Service Kit → Apply for Health
Service Kit, wählen Sie dasselbe Produkt und aktivieren Sie die
Lese-Berechtigungen der gewünschten Daten, mindestens:
- Aktivität: Steps, Calories, Distance;
- Gesundheit: Heart rate, SpO2, Stress, Body temperature, Body fat (Gewicht), Sleep. Füllen Sie das von Huawei bereitgestellte Antragsformular aus (beschreiben Sie eine private Hausautomations-Nutzung) und senden Sie es ab.
- Warten Sie auf die E-Mail von Huawei (etwa 10 Werktage). Die Berechtigungen sind etwa 24 Stunden nach der Freigabe nutzbar.
Hinweise:
- Die Testfreigabe erlaubt bis zu 100 Nutzer: mehr als genug für einen Haushalt.
- Laut Huawei erhalten private Entwickler nur die „Basis“-Freigabestufe und müssen eventuell eine mobile App veröffentlichen; wird Ihr Antrag deshalb abgelehnt, ist ein Unternehmens-Entwicklerkonto der dokumentierte Ausweg.
- Huawei teilt nur Daten, die nach der Verknüpfung Ihres Kontos entstehen (kein Verlauf vor der Autorisierung).
2. Die Integration konfigurieren
- Öffnen Sie den Reiter Konfiguration der Integration.
- Geben Sie Client-ID und Client-Secret ein.
- Behalten Sie unter Zu lesende Daten nur, wofür Ihre App freigegeben wurde: Huawei verweigert die Verbindung bei einer nicht gewährten Berechtigung.
- Optionale Einstellungen: Aktualisierungsintervall (standardmäßig 15 Minuten, mindestens 5), Zeitzone (um „heute“ zu bestimmen), tägliches Schrittziel und Warnschwellen (hohe/niedrige Herzfrequenz, niedriger SpO2).
- Speichern Sie, klicken Sie dann auf Verbinden und melden Sie sich mit der HUAWEI ID Ihrer Huawei Health-App an.
- Öffnen Sie auf Ihrem Telefon in der Huawei Health-App Ich → Datenschutzverwaltung und erlauben Sie die Datenfreigabe für Health Kit (die Aktion Verbindung testen meldet, wenn sie fehlt).
3. Geräte
Öffnen Sie den Reiter Erkennung und fügen Sie Huawei Health - <Ihr Name> hinzu. Es enthält eine schreibgeschützte Funktion pro Wert:
| Wert | Gruppe |
|---|---|
| Schritte, Aktivkalorien, Strecke (heute) | Aktivität |
| Herzfrequenz, Ruhepuls, HRV | Herzfrequenz |
| Blutsauerstoff (SpO2) | Blutsauerstoff |
| Stresswert | Stress |
| Körper- und Hauttemperatur | Körpertemperatur |
| Gewicht, Body-Mass-Index, Körperfett | Gewicht |
| Schlafwert, gesamt, Tief-, Leicht-, REM-Schlaf | Schlaf |
Huawei führt alle Geräte des Kontos zusammen (Uhr, Armband, Waage, Telefon): Der Verlauf übersteht einen Uhrenwechsel. Ein Wert, den Ihre Geräte nicht messen, bleibt leer. Die Aktion Verbindung testen und das Übersichts-Widget listen die Huawei bekannten Geräte auf.
Aktionen
- Verbindung testen: prüft die Huawei-Autorisierung und die Freigabe in der Health-App und listet Ihre Geräte auf.
- Jetzt synchronisieren: liest die Huawei Cloud sofort.
- Abmelden: löscht die Huawei-Token aus Gladys. Um den Zugriff vollständig zu widerrufen, entfernen Sie die App auch aus Ihrer HUAWEI ID (Kontoeinstellungen → Datenschutz).
Szenenauslöser
| Auslöser | Wann | Variablen |
|---|---|---|
| Schlafnacht aufgezeichnet | eine neue Nacht erreicht die Cloud | Schlafwert, Dauer, Tiefschlaf, Aufwachzeit |
| Tägliches Schrittziel erreicht | die heutigen Schritte überschreiten das Ziel (einmal pro Tag) | Schritte, Ziel |
| Auffällige Herzfrequenz | eine neue Messung überschreitet einen Grenzwert (Filter: hoch/niedrig) | Herzfrequenz, Richtung |
| Niedriger Blutsauerstoff | eine neue SpO2-Messung fällt unter den Grenzwert | SpO2 |
| Neue Wiegung | ein neues Gewicht erreicht Huawei Health | Gewicht, BMI, Körperfett |
Das erste Lesen nach einem Neustart ist ein Referenzpunkt: Es löst nie etwas aus.
Szenenaktionen
- Huawei Health synchronisieren: Ausgabe
synced. - Gesundheitsübersicht abrufen (Option: zuerst synchronisieren): Schritte, Aktivkalorien, Strecke, Herzfrequenz, Ruhepuls, SpO2, Stress, Gewicht, Schlafwert und -dauer, Zeit der letzten Synchronisierung. Beispiel: „Du hast {{sleep_minutes}} Minuten geschlafen, Wert {{sleep_score}}“.
Dashboard-Widgets
- Huawei Health: Schritte, Herzfrequenz, SpO2, Stress, Schlafwert und Gewicht, mit Konto, letzter Synchronisierung und Ihren Geräten sowie einer Schaltfläche Aktualisieren.
- Huawei-Aktivität: Schrittziel-Anzeige, Aktivkalorien, Strecke und ein Diagramm der letzten 7 Tage.
- Huawei-Schlaf: Wert und Phasen der letzten Nacht, Einschlaf- und Aufwachzeit sowie die Herzfrequenzkurve der letzten 24 Stunden (das Gerät muss in Gladys angelegt sein).
Fehlerbehebung
- „Klicken Sie auf Verbinden“: Das Konto ist nicht verknüpft oder die Client-ID hat sich geändert.
- Einige Daten konnten nicht gelesen werden: Die Berechtigung wurde Ihrer App nicht gewährt oder war beim Klick auf Verbinden nicht ausgewählt. Korrigieren Sie dies in der Huawei-Konsole und klicken Sie erneut auf Verbinden.
- Keine Daten, aber „verbunden“: Erlauben Sie die Freigabe in der Huawei Health-App (Ich → Datenschutzverwaltung) und warten Sie, bis die Uhr mit dem Telefon synchronisiert.
- „Autorisierung abgelaufen“: Das Huawei-Token gilt etwa sechs Monate und verfällt, wenn Sie das Passwort Ihrer HUAWEI ID ändern: Klicken Sie erneut auf Verbinden.
- Außerhalb Europas registrierte Konten werden von einem anderen Huawei-Standort bedient: Die Integration findet ihn selbst.
Konfigurationseinstellungen
Diese Einstellungen fragt Huawei Health in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Ihre Huawei-Entwickler-App | section | Nein | Huawei teilt Huawei Health-Daten nur mit Apps, die für Health Service Kit freigegeben sind. Erstellen Sie eine App auf HUAWEI Developers, beantragen Sie Health Service Kit mit den Leseberechtigungen der unten gewählten Daten (Prüfung: etwa 10 Werktage), hinterlegen Sie die unter der Schaltfläche Verbinden angezeigte Weiterleitungs-URI und geben Sie hier Client-ID und Client-Secret ein. Die Dokumentation beschreibt jeden Schritt. |
| Client-ID (App-ID) | string | Ja | OAuth-2.0-Client-ID Ihrer App in der HUAWEI Developers-Konsole. |
| Client-Secret | secret | Ja | OAuth-2.0-Client-Secret derselben App. |
| Zu lesende Daten | multi_select | Nein | Wählen Sie nur, wofür Ihre Huawei-App freigegeben wurde: Huawei verweigert die Verbindung bei einer nicht gewährten Berechtigung. Klicken Sie nach einer Änderung erneut auf Verbinden. |
| Huawei-Konto | oauth2 | Nein | Speichern Sie zuerst Client-ID und Secret und melden Sie sich dann mit der HUAWEI ID der Huawei Health-App an. |
| Aktualisierungsintervall (s) | number | Nein | Wie oft die Huawei Health Cloud gelesen wird (mindestens 5 Minuten). Ihre Uhr synchronisiert über die Huawei Health-App auf Ihrem Telefon. |
| Zeitzone | string | Nein | IANA-Zeitzone für die Tagesgrenzen (heutige Schritte) und die Uhrzeiten. |
| Tägliches Schrittziel | number | Nein | Löst „Schrittziel erreicht“ aus und füllt die Anzeige des Aktivitäts-Widgets. |
| Warnung hohe Herzfrequenz (bpm) | number | Nein | |
| Warnung niedrige Herzfrequenz (bpm) | number | Nein | |
| Warnung niedriger Blutsauerstoff (%) | number | Nein |
So installierst du Huawei Health in Gladys
- Öffne in Gladys Integrationen: Huawei Health erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/gboulvin/gladys-huawei-health: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/gboulvin/Gladys-Huawei-Health.
Huawei Health benötigt Gladys >=5.3.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
Huawei Health 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