Synchronizácia údajov Apple Health do MQTT

Publikujte zdravotné exporty ako JSON do témy na vašom MQTT brokeri.

Dôležité — obmedzenia automatizácií: Zariadenie musí byť odomknuté na čítanie zdravotných údajov a iOS negarantuje beh na pozadí vo zvolenej frekvencii. Pred spoľahnutím sa na automatické exporty skontrolujte Obmedzenia automatizácií.

Otvorenie automatizácie

Na iPhone otvorte Export → Automatizované, alebo na iPade Automatizácie na bočnom paneli. Vyberte Nová automatizácia alebo otvorte existujúcu automatizáciu na úpravu.

Názov, stav a oznámenia

Zadajte názov, ktorý identifikuje túto automatizáciu. Zapnuté umožňuje automatické spustenia; nechajte vypnuté, kým nebudete pripravení.

Vyberte ľubovoľné oznámenia o spustení:

• Upozorniť pri aktualizácii vyrovnávacej pamäte hlási, že exportné údaje boli pripravené.
• Upozorniť pri spustení hlási úspešné publikovanie do brokera.

Pri výzve povoľte oznámenia. Tieto oznámenia hlásia aktivitu; neplánujú spustenie.

Nastavenie pripojenia

1. Ako Typ automatizácie zvoľte MQTT.
2. Zadajte názov hostiteľa alebo IP adresu a port brokera. Predvolený port je 1883.
3. Zadajte Tému, napríklad health/metrics.
4. Pre každú automatizáciu nastavte jedinečné Client ID a ak to broker vyžaduje, zadajte používateľské meno a heslo.

Broker musí byť dostupný zo zariadenia. Odberatelia musia používať presnú tému vrátane veľkosti písmen. Opätovné použitie Client ID môže spôsobiť, že pripojenia brokera sa navzájom nahradia.

Nastavenia typu údajov

Vyberte jeden Typ údajov pre túto automatizáciu: Zdravotné metriky, Tréningy, Príznaky, ECG, Oznámenia o srdcovej frekvencii, Stav mysle, Sledovanie cyklu alebo Lieky. Stav mysle vyžaduje iOS 18 alebo novší; Lieky vyžadujú iOS 26 alebo novší a samostatný prístup k liekom.

Zdravotné metriky

Zvoľte Zdravotné metriky, potom otvorte Vybrať zdravotné metriky a vyberte potrebné merania.

Ak chcete obmedziť hodnoty na konkrétne aplikácie alebo zariadenia, otvorte Preferované zdroje, zvoľte metriku a vyberte jej zdroje. Všetky povoľuje každý zdroj, ktorý nebol vylúčený. Použite Vylúčené zdroje na ignorovanie zdroja vo všetkých zdravotných metrikách tejto automatizácie. Vylúčenia majú prednosť; nevybraný zdroj sa nenahrádza, keď preferovaný zdroj nemá údaje. Vyberte Uložiť na použitie volieb zdrojov alebo Zrušiť na ich zahodenie.

Tréningy

Zvoľte Tréningy na export záznamov tréningov. Zahrnúť údaje trasy pridá dostupné body trasy do JSON údajov tréningu. Nevytvára samostatné nahratia GPX.

Pre Verziu 2 zapnite Zahrnúť metriky tréningu, aby ste pridali hodnoty, napríklad srdcovú frekvenciu, aktívnu energiu a kroky. Pre Časové zoskupenie metrík tréningu zvoľte Minúty alebo Sekundy; sekundy produkujú viac detailov a väčšie exporty. Verzia 1 vždy zahŕňa metriky tréningu.

Nastavenia exportu

MQTT publikuje len JSON. Správy používajú QoS 0 pri publikovaní v popredí a QoS 1 pri publikovaní na pozadí. Správy sa neuchovávajú (nie sú retained).

Verzia exportu

Zvoľte Verziu 2 pre aktuálnu dátovú štruktúru. Použite Verziu 1, keď existujúci pracovný postup závisí od staršieho formátu.

Rozsah dátumov

Výber	Zahrnuté údaje
Predvolené	Predchádzajúci deň a dnešok až do času spustenia
Od poslednej synchronizácie	Od predchádzajúcej synchronizácie až do času spustenia
Dnes	Dnešok až do času spustenia
Včera	Predchádzajúci celý deň
Predchádzajúcich 7 dní	Predchádzajúcich sedem celých dní

Sumarizovať údaje a časové zoskupenie

Pre JSON + Zdravotné metriky zapnite Sumarizovať údaje na spojenie hodnôt do časových skupín, alebo vypnite pre jednotlivé hodnoty, kde sú dostupné. Súhrn závisí od metriky — napríklad kroky sa sčítajú a hodnoty hmotnosti sa spriemerujú. CSV exporty zdravotných metrík používajú sumarizované údaje.

Keď je dostupné Časové zoskupenie, zvoľte, koľko detailov zachovať. Hodinové alebo denné skupiny produkujú menej riadkov než minútové alebo sekundové. Dostupné voľby závisia od rozsahu dátumov a formátu. Časové zoskupenie tréningov sa nastavuje samostatne v Tréningoch.

Plánovanie pripomienok

Ak chcete výzvu odomknúť a otvoriť aplikáciu, zapnite Zapnúť pripomienky. Zvoľte Každú hodinu, Každý deň alebo Vybrané dni a potom podľa potreby nastavte minútu, čas a dni. Pri výzve povoľte prístup k oznámeniam; ak je prístup zamietnutý, použite Otvoriť nastavenia oznámení.

Pripomienka nespúšťa automatizáciu ani nepotvrdzuje úspešnú synchronizáciu. Klepnutím ju otvoríte, alebo na oznámení použite Otvoriť a synchronizovať na požiadanie spustenia. Automatizácia musí byť zapnutá; pripomienka sa môže zobraziť aj po úspešnom behu na pozadí. Zmeny pripomienok platia pri uložení.

Frekvencia synchronizácie a uloženie

V časti Frekvencia synchronizácie zvoľte číslo a Minúty, Hodiny, Dni alebo Týždne — napríklad každých 15 minút. Ide o požadovanú kadenciu na pozadí, nie o zaručený rozvrh.

Zariadenie musí byť odomknuté, keď sa čítajú zdravotné údaje. Pre automatické spustenia zapnite Obnovenie aplikácií na pozadí pre Health Auto Export a vypnite režim nízkej spotreby. iOS môže spustenia stále oneskoriť, keď bolo zariadenie neaktívne alebo sú systémové zdroje obmedzené.

Keď ste pripravení na automatické spustenia, zapnite Zapnuté a potom vyberte Aktualizovať na uloženie automatizácie. Vybraný rozsah dátumov môžete okamžite nahrať podľa krokov nižšie.

Export historických alebo vynechaných údajov

Použite Manuálne nahratie, keď automatizáciu prvýkrát nastavujete na export historických údajov, alebo neskôr na pokrytie dátumov, ktoré automatická synchronizácia vynechala. Môžete ho použiť aj na overenie nastavenia.

1. Pripojte odberateľa MQTT k brokerovi a odoberajte nastavenú tému.
2. V Health Auto Export otvorte automatizáciu a v časti Exportovať existujúce údaje vyberte Manuálne nahratie.
3. Nastavte dátumy Začiatok a Koniec a potom vyberte Začať export.
4. Skontrolujte prijatý JSON a jeho dátumy.

Dátový balík nasleduje formát exportu JSON. Napríklad:

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

Riešenie problémov

• Pripojenie zlyhalo: Skontrolujte hostiteľa, port, sieťový prístup a požiadavky brokera na pripojenie.
• Overenie zlyhalo: Skontrolujte prihlasovacie údaje a oprávnenie publikovať do témy.
• Žiadna správa: Potvrďte, že odberateľ používa ten istý broker a presnú tému, a potom skontrolujte denníky aktivity.
• Správa je príliš veľká: Vyberte menej metrík, kratší rozsah alebo hrubšie časové zoskupenie.

Otvorte automatizáciu a vyberte Zobraziť denníky aktivity na kontrolu spustenia. Upozornenia označujú potenciálne problémy, napríklad pomalé načítanie údajov; chyby identifikujú zlyhané kroky. Pre pomoc pri nahlásení problému pozrite Získanie pomoci.