Apple Health adatok szinkronizálása Home Assistantba

A Home Assistant automatizálásokkal automatikusan szinkronizálhatod egészségügyi adataidat Home Assistantba érzékelőállapotként. Ez lehetővé teszi, hogy egészségügyi adataidat Home Assistant automatizálásokban, irányítópultokon és más integrációkban használd.

Áttekintés

A Home Assistant automatizálások az egészségügyi metrikáidat a Home Assistant REST API-jára küldik, érzékelőállapotokat hozva létre vagy frissítve, amelyek a teljes Home Assistant példányodban használhatók. Az adatok a Home Assistant /states/<entity_id> API-jához igazított formátumban kerülnek küldésre.

Használati esetek:

• Egészségügyi metrikák megjelenítése Home Assistant irányítópultokon
• Automatizálások létrehozása egészségügyi adatok alapján
• Egészségügyi adatok integrálása más okosotthon-eszközökkel
• Egészségügyi trendek követése a Home Assistantban

Fő jellemzők:

• Automatikus érzékelőállapot-létrehozás
• Csak JSON formátum (Home Assistantra optimalizálva)
• Csak Egészségügyi metrikák adattípus
• Egyszerű URL-konfiguráció

Korlátok

• Egészségügyi adatok elérése: Az alkalmazások nem férnek hozzá egészségügyi adatokhoz, amíg az iPhone zárolva van. Az automatizálások csak akkor futnak, amikor az eszköz fel van oldva. Ez befolyásolhatja az adatok frissességét. A naprakész adatokhoz kövesd a kézi szinkronizálásra vonatkozó útmutatót.

• Háttérfeldolgozás: Az iOS korlátozza a háttérben futó feldolgozást az akkumulátor védelme érdekében. Az automatizálások a háttérben futó alkalmazás-frissítésre támaszkodnak, és nem feltétlenül futnak le azonnal, ha:

  • A háttérben futó alkalmazás-frissítés ki van kapcsolva az alkalmazásnál
  • Az eszköz alacsony töltöttségi módban van
  • Az eszköz hosszú ideje inaktív
  • A rendszer erőforrásai szűkösek
  • Több alkalmazás verseng a háttérben futásért

• Csak Egészségügyi metrikák adattípus támogatott

• Csak JSON formátum (nem változtatható)

Előfeltételek

• Futtatott és a hálózaton elérhető Home Assistant példány
• Home Assistant API hozzáférési token (Long-Lived Access Token)
• Hálózati kapcsolat a Home Assistant példányhoz
• Olyan Home Assistant verzió, amely támogatja a REST API-t

Konfiguráció

Lépj az Automatizált exportok képernyőre a fő navigációból, majd koppints az „Új automatizálás” lehetőségre, és válaszd a „Home Assistant” automatizálástípust.

Automatizálás neve

Adj leíró nevet az automatizálásnak. Ebből generálódik az érzékelő entitásazonosítója a Home Assistantban.

Megjegyzés: Az automatizálás neve kisbetűssé és szóköz nélkül alakul entitásazonosítóvá. Például a „My Health Data” → hae.myhealthdata.

Értesítések

Állítsd be, mikor szeretnél értesítést kapni:

• Értesítés gyorsítótár-frissítéskor – Értesítés, ha a gyorsítótárazott adat frissül
• Értesítés futtatáskor – Értesítés minden alkalommal, amikor az automatizálás lefut

Home Assistant URL

Add meg a Home Assistant példányod alap URL-jét. Tartalmazza a protokollt és a portot, ha nem az alapértelmezettet használod.

Példa URL-ek:

• http://homeassistant.local:8123
• http://192.168.1.100:8123

Megjegyzés: Az URL-nek elérhetőnek kell lennie az eszközödről. HTTPS esetén győződj meg róla, hogy az tanúsítvány érvényes, vagy adj hozzá kivételt.

Automatikusan generált végpont

Az alkalmazás automatikusan összeállítja a teljes API-végpontot az automatizálás neve alapján:

{your_url}/api/states/hae.{automation_name}

Például ha az URL http://homeassistant.local:8123, és az automatizálás neve „Health Metrics”, a végpont:

http://homeassistant.local:8123/api/states/hae.healthmetrics

Ez a végpont az URL mező alatt jelenik meg tájékoztatásként.

Kérés időtúllépése

Válassz időtúllépést a Home Assistant felé küldött HTTP-kérésekhez.

Elérhető időtúllépések:

• 60 másodperc – Alapértelmezés, a legtöbb Home Assistant példányhoz megfelelő
• 300 másodperc (5 perc) – Lassabb példányokhoz
• 1800 másodperc (30 perc) – Nagyon lassú feldolgozáshoz
• 3600 másodperc (1 óra) – Maximálisan ajánlott időtúllépés

HTTP-fejlécek

Adj hozzá hitelesítési fejléceket a Home Assistant API eléréséhez. Szükséged lesz egy Authorization fejlécre a Long-Lived Access Tokennel.

Kötelező fejléc:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Long-Lived Access Token beszerzése:

1. Nyisd meg a Home Assistantot
2. Lépj a profilodra (kattints a nevedre bal alul)
3. Görgess a „Long-Lived Access Tokens” részhez
4. Kattints a „Create Token” lehetőségre
5. Adj nevet (pl. „Health Auto Export”)
6. Másold ki a tokent, és illeszd be a fejléc értékmezőjébe

Opcionális fejlécek:
Szükség szerint további fejléceket adhatsz a Home Assistant beállításodhoz.

Fejlécek hozzáadása:

1. Koppints a „Fejlécek hozzáadása” lehetőségre
2. Írd be a fejléc kulcsát a bal mezőbe
3. Írd be a fejléc értékét a jobb mezőbe
4. Ismeld további fejlécekhez

Fontos: Minden fejléc-kulcshoz tartoznia kell értéknek. Az üres fejlécek figyelmen kívül maradnak.

Adattípus-beállítások

Adattípus

Megjegyzés: A Home Assistant automatizálások csak az Egészségügyi metrikák adattípust támogatják. Ez nem változtatható, automatikusan Egészségügyi metrikákra van állítva.

Egészségügyi metrikák konfigurációja

Egészségügyi metrikák kiválasztása – Válaszd ki, mely konkrét metrikák kerüljenek bele. Kiválaszthatod az összes elérhető metrikát vagy csak bizonyosakat.

Tipp: Ha csak a szükséges metrikákat választod, javulhat a feldolgozási idő és csökkenhet a Home Assistantnak küldött adatméret.

Preferált források – Állítsd be, mely adatforrások kapjanak prioritást, ha több forrás ugyanazt a metrikát szolgáltatja.

Exportbeállítások

Exportformátum

Megjegyzés: A Home Assistant automatizálások csak JSON formátumot támogatnak. Ez nem változtatható, automatikusan JSON-ra van állítva.

Export verzió

Megjegyzés: Export verzió nem érhető el Home Assistant automatizálásoknál, mert a formátum kifejezetten a Home Assistant állapot API-jához van optimalizálva.

Dátumtartomány

Válaszd ki, mikor kerüljenek exportálásra az adatok:

• Alapértelmezés – Szinkronizálja az előző teljes nap adatait, valamint az aktuális dátum és időig terjedő adatokat
• Ma – Szinkronizálja a mai nap összes adatát az aktuális időpontig
• Tegnap – Szinkronizálja a teljes előző nap adatait

Megjegyzés: A Home Assistant automatizálások nem támogatják a „Valós idejű”, „Az utolsó szinkron óta” vagy „Előző 7 nap” opciókat.

Adatok összefoglalása

Kapcsold BE vagy KI az „Adatok összefoglalása” beállítást az Egészségügyi metrikákhoz.

• BE – összesített adatösszefoglalók (alapértelmezés)
• KI – ahol lehetséges, szétbontott adat

Megjegyzés: Ez a beállítás csak az Egészségügyi metrikák adattípusra vonatkozik.

Időcsoportosítás

Ha az adatok összefoglalása be van kapcsolva, válaszd ki, hogyan legyenek az adatok összesítve:

• Alapértelmezés – nincs összesítés, nyers adatpontok
• Napok – adatok napi csoportosítása (ajánlott)

Szinkrongyakoriság

Állítsd be, milyen gyakran szinkronizáljon az automatizálás adatot a Home Assistantba:

Válassz számot és intervallumot.

Tesztelés és ellenőrzés

Kézi teszt

1. Koppints a „Kézi export” lehetőségre az automatizálás konfigurációs képernyőjén
2. Válassz dátumtartományt
3. Koppints az „Export” gombra tesztkérés küldéséhez
4. Ellenőrizd a Home Assistantban, hogy az érzékelőállapot létrejött-e vagy frissült-e

Ellenőrzés a Home Assistantban

1. Nyisd meg a Home Assistantot
2. Lépj a Developer Tools > States menüpontra
3. Keress rá hae.{your_automation_name} kifejezésre (kisbetű, szóköz nélkül)
4. Ellenőrizd, hogy az érzékelőállapot mutatja-e az egészségügyi adatokat
5. Nézd meg a „Last Updated” időbélyeget a legutóbbi szinkronok megerősítéséhez

Tevékenységnapló megtekintése

1. Koppints a „Tevékenységnapló megtekintése” lehetőségre az automatizálás konfigurációs képernyőjén
2. Nézd át a legutóbbi futásokat
3. Keress hibákat vagy figyelmeztetéseket
4. Ellenőrizd a kérések időbélyegét és a válasz állapotát

Home Assistant naplók ellenőrzése

Ha nem jelennek meg adatok a Home Assistantban:

1. Nyisd meg a Home Assistantot
2. Lépj a Settings > System > Logs menüpontra
3. Keress REST API-val vagy érzékelőállapotokkal kapcsolatos hibákat
4. Ellenőrizd a hitelesítési hibákat vagy érvénytelen adatformátumot

Hibaelhárítás

Gyakori problémák

Hitelesítési hibák

• Ellenőrizd, hogy helyes-e a Long-Lived Access Token
• Az Authorization fejléc formátuma legyen: Bearer YOUR_TOKEN
• Ellenőrizd, hogy a token nem járt-e le és nem vonták-e vissza
• Győződj meg róla, hogy a tokennek megfelelő jogosultságai vannak a Home Assistantban

Nem jelenik meg az érzékelő a Home Assistantban

• Ellenőrizd, hogy az automatizálás neve nem tartalmaz speciális karaktereket
• Ellenőrizd az entitásazonosító formátumát: hae.{automation_name} (kisbetű, szóköz nélkül)
• Nézd meg a Home Assistant naplóit hibákért
• Győződj meg róla, hogy az API-kérés sikeres volt (nézd a tevékenységnaplót)

Nem frissülnek az adatok

• Ellenőrizd, hogy az automatizálás be van-e kapcsolva
• Nézd át a tevékenységnaplót hibákért
• Győződj meg róla, hogy van hálózati kapcsolat a Home Assistanthoz

Kapcsolat időtúllépése

• Ellenőrizd, hogy a Home Assistant fut és elérhető
• Ellenőrizd a hálózati kapcsolatot
• Növeld a kérés időtúllépését, ha a Home Assistant lassan válaszol
• Ellenőrizd az URL-t és a portot

Hibaüzenetek

Az alkalmazás hibaüzenetet jelenít meg, ha:

• Az URL érvénytelen vagy elérhetetlen
• A hitelesítés sikertelen (ellenőrizd az Authorization fejlécet)
• A Home Assistant hibaállapotkódot ad vissza
• Nincs hálózati kapcsolat

A tevékenységnaplóban részletes hibainformáció található, beleértve HTTP állapotkódokat és a Home Assistant hibaüzeneteit.

Home Assistant integrációs tippek

Egészségügyi adatok használata automatizálásokban

Miután az egészségügyi adatok szinkronizálódtak a Home Assistantba, használhatod őket automatizálásokban:

automation:
  - alias: "Good Sleep Quality"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Great sleep last night!"

Irányítópultok létrehozása

Adj egészségügyi metrikákat a Home Assistant irányítópultodhoz:

1. Lépj az irányítópultra
2. Adj hozzá új kártyát
3. Válaszd az „Entities” vagy „Gauge” kártyatípust
4. Add hozzá a hae.{your_automation_name} érzékelő entitásokat

Érzékelőállapot szerkezete

A Home Assistantban az érzékelőállapot tartalmazza:

• state: az aktuális érték vagy állapot
• attributes: további adatok, többek között:
  • Időbélyeg-információk
  • Az exportált JSON formátumnak megfelelő adatszerkezet
  • Ahol érvényes, mértékegység-információ

Tippek és ajánlott gyakorlat

1. Automatikus szinkron:

   • Töltsd az eszközt, és használd az iPhone tükrözést
     • Töltés közben az iOS kevésbé korlátozza a teljesítményt
     • Az iPhone tükrözéssel az eszköz úgy viselkedik, mintha fel lenne oldva

2. Elnevezés:

   • Kerüld a speciális karaktereket, amelyek problémát okozhatnak

3. Adatkiválasztás:

   • Csak a szükséges metrikákat válaszd