Apple Health adatok szinkronizálása MQTT-re

Közöljön egészségügyi exportokat JSON-ként a MQTT-bróker egy témájára.

Fontos — automatizálási korlátozások: Az eszköznek feloldottnak kell lennie az egészségügyi adatok olvasásához, és az iOS nem garantálja a háttérfuttatásokat a választott gyakorisággal. Tekintse át az Automatizálási korlátozásokat, mielőtt automatikus exportokra támaszkodna.

Az automatizálás megnyitása

Nyissa meg az Exportálás → Automatizált menüpontot iPhone-on, vagy az Automatizálások lehetőséget az iPad oldalsávjában. Válassza az Új automatizálás lehetőséget, vagy nyisson meg egy meglévő automatizálást a szerkesztéshez.

Név, állapot és értesítések

Adjon meg egy nevet, amely azonosítja ezt az automatizálást. Az Engedélyezve lehetővé teszi az automatikus futtatásokat; hagyja kikapcsolva, amíg készen nem áll.

Válassza ki a kívánt futási értesítéseket:

• A Értesítés a gyorsítótár frissítésekor arról számol be, hogy az exportadatok előkészültek.
• A Értesítés futáskor a brókerre történő sikeres közlésről.

Engedélyezze az értesítéseket, ha kéri. Ezek az értesítések tevékenységet jeleznek; nem ütemeznek futtatást.

A kapcsolat beállítása

1. Válassza az MQTT lehetőséget Automatizálástípusként.
2. Adja meg a bróker gazdanevét vagy IP-címét és portját. Az alapértelmezett port 1883.
3. Adja meg a Témát, például health/metrics.
4. Állítson be egyedi Kliensazonosítót minden automatizáláshoz, és adjon meg felhasználónevet és jelszót, ha a bróker megköveteli.

A brókernek elérhetőnek kell lennie az eszközéről. A feliratkozóknak a pontos témát kell használniuk, beleértve a kis- és nagybetűket. A kliensazonosító újrafelhasználása miatt a brókerkapcsolatok felválthatják egymást.

Adattípus-beállítások

Válasszon egy Adattípust ehhez az automatizáláshoz: Egészségügyi metrikák, Edzések, Tünetek, EKG, Pulzusértesítések, Lelkiállapot, Cikluskövetés vagy Gyógyszerek. A Lelkiállapothoz iOS 18 vagy újabb szükséges; a Gyógyszerekhez iOS 26 vagy újabb és külön gyógyszerhozzáférés.

Egészségügyi metrikák

Válassza az Egészségügyi metrikák lehetőséget, majd nyissa meg az Egészségügyi metrikák kiválasztása menüpontot, és válassza ki a szükséges méréseket.

A leolvasások adott alkalmazásokra vagy eszközökre korlátozásához nyissa meg a Preferált források lehetőséget, válasszon egy metrikát, és jelölje ki a forrásait. Az Összes minden nem kizárt forrást engedélyez. A Kizárt források segítségével figyelmen kívül hagyhat egy forrást az automatizálás egészségügyi metrikáinál. A kizárások elsőbbséget élveznek; a ki nem választott forrás nem helyettesít, ha a preferált forrásnak nincs adata. Válassza a Mentés lehetőséget a forrásválasztások alkalmazásához, vagy a Mégsem lehetőséget az elvetésükhöz.

Edzések

Válassza az Edzések lehetőséget az edzésrekordok exportálásához. Az Útvonaladatok felvétele elérhető útvonalpontokat ad a JSON edzésadatokhoz. Nem hoz létre külön GPX-feltöltéseket.

A 2. verziónál kapcsolja be az Edzésmetrikák felvétele lehetőséget a pulzus, aktív energia és lépések típusú leolvasások hozzáadásához. Válassza a Percek vagy Másodpercek lehetőséget az edzésmetrika Időcsoportosításához; a másodpercek több részletet és nagyobb exportokat eredményeznek. Az 1. verzió mindig tartalmazza az edzésmetrikákat.

Exportbeállítások

Az MQTT csak JSON-t közöl. Az üzenetek előtérbeli közléshez QoS 0-t, háttérbeli közléshez QoS 1-et használnak. Az üzenetek nem maradnak meg (retained).

Exportverzió

Válassza a 2. verziót az aktuális adatszerkezethez. Használja az 1. verziót, ha egy meglévő munkafolyamat a régebbi formátumtól függ.

Dátumtartomány

Kiválasztás	Tartalmazott adatok
Alapértelmezett	Az előző nap és a mai nap a futás idejéig
Az utolsó szinkronizálás óta	Az előző szinkronizálástól a futás idejéig
Ma	A mai nap a futás idejéig
Tegnap	Az előző teljes nap
Előző 7 nap	Az előző hét teljes nap

Adatok összegzése és időcsoportosítás

JSON + Egészségügyi metrikák esetén kapcsolja be az Adatok összegzése lehetőséget a leolvasások időcsoportokba vonásához, vagy kapcsolja ki az egyedi leolvasásokhoz, ahol elérhetők. Az összegzés a metrikától függ — például a lépések összeadódnak, a testsúly-leolvasások átlagolódnak. A CSV egészségügyi metrika-exportok összegzett adatokat használnak.

Ha az Időcsoportosítás elérhető, válassza ki, mennyi részletet tartson meg. Az óránkénti vagy napi csoportok kevesebb sort eredményeznek, mint a perc- vagy másodperc-csoportok. Az elérhető választások a dátumtartománytól és a formátumtól függnek. Az edzés időcsoportosítása külön van beállítva az Edzéseknél.

Emlékeztetők ütemezése

Ha emlékeztetőt szeretne az alkalmazás feloldására és megnyitására, kapcsolja be az Emlékeztetők engedélyezése lehetőséget. Válassza az Óránként, Minden nap vagy Kiválasztott napok lehetőséget, majd állítsa be a percet, az időt és a napokat. Engedélyezze az értesítési hozzáférést, ha kéri; ha elutasítva van, használja az Értesítési beállítások megnyitása lehetőséget.

Az emlékeztető nem futtatja az automatizálást, és nem erősít meg sikeres szinkronizálást. Koppintson rá az automatizálás megnyitásához, vagy használja a Megnyitás és szinkronizálás lehetőséget az értesítésen a futtatás kéréséhez. Az automatizálásnak engedélyezve kell lennie; az emlékeztető sikeres háttérfuttatás után is megjelenhet. Az emlékeztető-változtatások mentéskor érvényesülnek.

Szinkronizálási gyakoriság és mentés

Válasszon egy számot és Percek, Órák, Napok vagy Hetek értéket a Szinkronizálási gyakoriság alatt — például 15 percenként. Ez kívánt háttérütem, nem garantált menetrend.

Az eszköznek feloldottnak kell lennie, amikor egészségügyi adatokat olvas. Kapcsolja be a Háttérben frissítést a Health Auto Exportnál, és kapcsolja ki az Alacsony töltöttség módot az automatikus futtatásokhoz. Az iOS továbbra is késleltetheti a futtatásokat, ha az eszköz inaktív volt, vagy a rendszererőforrások korlátozottak.

Kapcsolja be az Engedélyezve lehetőséget, amikor készen áll az automatikus futtatásokra, majd válassza a Frissítés lehetőséget az automatizálás mentéséhez. Az alábbi lépésekkel azonnal feltölthet egy kiválasztott dátumtartományt.

Előzmény- vagy kihagyott adatok exportálása

Használja a Kézi feltöltést, amikor először állítja be az automatizálást előzményadatok exportálásához, vagy később az automatikus szinkronizálás által kihagyott dátumok pótlásához. A beállítás ellenőrzéséhez is használhatja.

1. Csatlakoztasson egy MQTT-feliratkozót a brókeréhez, és iratkozzon fel a beállított témára.
2. A Health Auto Exportban nyissa meg az automatizálást, és válassza a Kézi feltöltés lehetőséget a Meglévő adatok exportálása alatt.
3. Állítsa be a Kezdő és Záró dátumot, majd válassza az Export indítása lehetőséget.
4. Ellenőrizze a fogadott JSON-t és a dátumait.

A payload a JSON exportformátumot követi. Például:

{
  "data": {
    "metrics": [
      {
        "name": "step_count",
        "units": "count",
        "data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
      }
    ]
  }
}

Hibaelhárítás

• Kapcsolat sikertelen: Ellenőrizze a gazdagépet, a portot, a hálózati hozzáférést és a bróker kapcsolati követelményeit.
• Hitelesítés sikertelen: Ellenőrizze a hitelesítő adatokat és a témára közlés jogosultságát.
• Nincs üzenet: Erősítse meg, hogy a feliratkozó ugyanazt a brókert és pontos témát használja, majd tekintse át a Tevékenységnaplókat.
• Túl nagy üzenet: Válasszon kevesebb metrikát, rövidebb tartományt vagy durvább időcsoportosítást.

Nyissa meg az automatizálást, és válassza a Tevékenységnaplók megtekintése lehetőséget a futás áttekintéséhez. A Figyelmeztetések lehetséges problémákat jeleznek, például lassú adatlekérést; a hibák sikertelen lépéseket azonosítanak. Probléma bejelentéséhez lásd Segítségkérés.