Apple Health adatok szinkronizálása MQTT-be

Az MQTT automatizálásokkal automatikusan publikálhatod egészségügyi adataidat egy MQTT-brókerre. Ideális IoT platformokkal, okosotthon-rendszerekkel vagy bármely MQTT üzenetkezelést támogató szolgáltatással való integrációhoz.

Áttekintés

Az MQTT automatizálások JSON üzenetként publikálják egészségügyi adataidat egy megadott MQTT témára egy MQTT-brókeren. Az adatok az automatizálás lefutásakor kerülnek küldésre a szinkrongyakoriság beállításai szerint.

Használati esetek:

• Integráció IoT platformokkal (Home Assistant, OpenHAB stb.)
• Egészségügyi adatok publikálása MQTT-alapú irányítópultokra
• Valós idejű egészségügyi megfigyelő rendszerek
• Egyedi okosotthon-integrációk
• Adatnaplózás és elemző platformok

Fő jellemzők:

• Csak JSON formátum (MQTT-hez optimalizálva)
• Támogatja a hitelesített és névtelen kapcsolatokat
• Beállítható témaszerkezet
• Kliensazonosító kezelése
• Opcionális felhasználónév/jelszó hitelesítés

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 JSON formátum (nem változtatható)

• MQTT-bróker szükséges (helyi vagy felhőalapú)

Előfeltételek

• MQTT-bróker (pl. Mosquitto, HiveMQ, AWS IoT Core stb.)
• Hálózati kapcsolat az MQTT-brókerhez
• Bróker IP-címe vagy hosztnév
• Portszám
• Opcionális: felhasználónév és jelszó, ha a bróker hitelesítést igényel

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 az „MQTT” automatizálástípust.

Automatizálás neve

Adj leíró nevet az automatizálásnak (pl. „Home Assistant MQTT”, „Felhő MQTT bróker”).

É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 publikál adatot

Bróker konfiguráció

IP-cím

Add meg az MQTT-bróker IP-címét vagy hosztnévét.

Példák:

• 192.168.1.100 (helyi IP)
• mqtt.example.com (hosztnév)
• broker.hivemq.com (felhő MQTT bróker)
• localhost (ha ugyanazon az eszközön fut – iOS-en nem ajánlott)

Megjegyzés: Helyi brókerekhez használj IP-címet, felhős brókerekhez hosztnévet. Győződj meg róla, hogy a bróker elérhető az eszközödről.

Port

Add meg az MQTT-bróker portszámát.

Megjegyzés: Az alapértelmezett port 1883.

Téma

Add meg az MQTT témát, ahová az egészségügyi adatok publikálódnak. Ezt a témát használják a feliratkozók az adatok fogadásához.

Téma példák:

• health/data
• home/health/metrics
• user/health/export
• hae/automation-name

Téma ajánlott gyakorlat:

• Használj perjelet (/) a téma hierarchiához
• Használj leíró neveket az adattípus jelzésére
• Kerüld a szóközöket és speciális karaktereket
• Több automatizálásnál fontold meg az automatizálás nevét a témában

Megjegyzés: A témanév kis- és nagybetűre érzékeny. A feliratkozóknak pontosan ugyanazt a témát kell használniuk.

Kliensazonosító

Adj meg egy egyedi kliensazonosítót ehhez az MQTT kapcsolathoz. Ez azonosítja az eszközöd a bróker felé.

Példa kliensazonosítók:

• health-export-iphone
• hae-client-001
• ios-health-app

Felhasználónév (opcionális)

Add meg a felhasználónevet MQTT bróker hitelesítéshez. Hagyd üresen, ha a bróker nem igényel hitelesítést.

Jelszó (opcionális)

Add meg a jelszót MQTT bróker hitelesítéshez. Hagyd üresen, ha a bróker nem igényel hitelesítést.

Adattípus-beállítások

Adattípus

Válaszd ki, milyen típusú egészségügyi adatot exportálj:

• Egészségügyi metrikák – Lépések, pulzus, alvás és egyéb mérések
• Edzések – Mozgásformák és fitnesztevékenységek
• Tünetek – Egészségügyi tünetek és állapotok
• EKG – Elektrokardiogram felvételek
• Pulzusértesítések – Magas/alacsony pulzus események
• Lelkiállapot – Hangulat és mentális állapot bejegyzések (iOS 18.0+)
• Cikluskövetés – Menstruációs ciklus és reprodukciós adatok
• Gyógyszerek – Gyógyszerbejegyzések és adherencia (iOS 26.0+)

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

Ha az Egészségügyi metrikák van kiválasztva:

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, csökken az üzenet mérete és a feldolgozási idő.

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

Edzés konfigurációja

Ha az Edzések van kiválasztva:

Útvonaladatok belefoglalása – Kapcsold BE, ha az edzés útvonalait is szeretnéd helyadattal rendelkező edzésekhez.

Edzésmetrikák belefoglalása – Kapcsold BE, ha az edzés alatt gyűjtött egészségügyi metrikákat (pulzus, kalória stb.) is szeretnéd.

Időcsoportosítás (edzésmetrikák) – Export 2-es verzió és bekapcsolt edzésmetrikák esetén:

• Perc – edzésmetrikák percenkénti csoportosítása
• Másodperc – edzésmetrikák másodpercenkénti csoportosítása

Exportbeállítások

Exportformátum

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

Export verzió

Válassz exportverziót az edzésadatokhoz:

• 1-es verzió – Régi formátum
• 2-es verzió – Aktuális formátum bővített edzésadatokkal

Megjegyzés: Az export verzió elsősorban az edzésadatok szerkezetét érinti, ha edzéseket exportálsz.

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
• Az utolsó szinkron óta – Minden szinkronkor exportálja az utolsó futás óta az aktuális dátum és időig terjedő összes adatot
• Ma – Szinkronizálja a mai nap összes adatát az aktuális időpontig
• Tegnap – Szinkronizálja a teljes előző nap adatait
• Előző 7 nap – Szinkronizálja az előző hét teljes napjainak adatait

Adatok összefoglalása

JSON formátum és Egészségügyi metrikák adattípus esetén kapcsold BE vagy KI az „Adatok összefoglalása” beállítást.

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

Időcsoportosítás

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

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

Szinkrongyakoriság

Állítsd be, milyen gyakran publikáljon az automatizálás adatot MQTT-re:

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 üzenet publikálásához
4. Használj MQTT klienst a témára való feliratkozáshoz, és ellenőrizd, hogy megérkezett-e az üzenet

MQTT kliens használata

Üzenetek ellenőrzéséhez:

1. Állíts be egy MQTT klienst
2. Csatlakozz ugyanahhoz a brókerhez ugyanazokkal a hitelesítő adatokkal
3. Iratkozz fel a témádra
4. Indíts kézi exportot az alkalmazásból
5. Ellenőrizd, hogy az üzenet megjelenik-e az MQTT kliensben

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 kapcsolati hibákat vagy sikertelen publikálást
4. Ellenőrizd a publikálás időbélyegeit

Üzenetformátum

Az MQTT üzenetek JSON formátumban kerülnek publikálásra. A hasznos terhelés a szabványos export JSON formátumot követi:

{
  "data": {
    "metrics": [...],
    "workouts": [...],
    ...
  }
}

Az üzenet a következőkkel kerül publikálásra:

• Téma: az automatizálásban beállított szerint
• QoS: legfeljebb egyszeri kézbesítés
• Retain: az üzenetek nem maradnak meg
• Payload: JSON karakterlánc egészségügyi adatokkal

Hibaelhárítás

Gyakori problémák

Kapcsolódási hibák

• Ellenőrizd, hogy helyes-e a bróker IP-címe/hosztnévje
• Ellenőrizd a portot, és hogy a bróker azon hallgat-e
• Győződj meg róla, hogy van hálózati kapcsolat a brókerhez
• Ellenőrizd a tűzfalszabályokat
• Nézd meg, hogy a bróker TLS/SSL-t igényel-e

Hitelesítési hibák

• Ellenőrizd a felhasználónevet és jelszót
• Ha megadtál hitelesítő adatokat, ellenőrizd, hogy a brókeren engedélyezve van-e a hitelesítés
• Győződj meg róla, hogy a felhasználónak jogosultsága van a megadott témára történő publikáláshoz

Nem érkeznek meg üzenetek

• Ellenőrizd, hogy a témanév pontosan egyezik (kis- és nagybetűre érzékeny)
• Ellenőrizd, hogy a feliratkozók ugyanahhoz a brókerhez csatlakoznak-e
• Győződj meg róla, hogy a feliratkozók a helyes témára iratkoznak fel
• Ellenőrizd, hogy az automatizálás be van-e kapcsolva és fut-e
• Nézd meg a tevékenységnaplót publikálási hibákért

Nagy üzenetméret

• Csökkentsd a kiválasztott egészségügyi metrikák számát
• Használj kevésbé részletes összesítési opciót
• Fontold meg több automatizálásra bontást különböző adattípusokhoz

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. Téma szervezés:

   • Használj hierarchikus témaszerkezetet (pl. health/metrics, health/workouts)
   • Téma tartalmazhat eszköz- vagy automatizálás-azonosítót
   • Dokumentáld a témaszerkezetet

3. Üzenetméret:

   • Tartsd ésszerű méretben az üzeneteket az MQTT bróker korlátai miatt
   • Kevesebb részletes összesítéssel csökkenthető az adatmennyiség
   • Nagy adathalmazokat oszd fel több üzenetre

4. Figyelés:

   • Az alkalmazás tevékenységnaplójával követheted a sikeres publikálást

5. Felhős brókerek:

   • Felhő MQTT brókerek (AWS IoT, HiveMQ Cloud stb.) használatakor:
     • Kövesd az adott szolgáltatás csatlakozási követelményeit
     • Ellenőrizd az üzenetméret- és sebességkorlátokat
     • Ellenőrizd a témaelnevezési szabályokat