Synchronizace dat Apple Health do MQTT

Publikujte zdravotní exporty jako JSON na téma na vašem MQTT brokeru.

Důležité — omezení automatizací: Zařízení musí být odemčené, aby bylo možné číst zdravotní data, a iOS negarantuje běhy na pozadí ve zvolené frekvenci. Před spoléháním na automatické exporty si prohlédněte Omezení automatizací.

Otevření automatizace

Na iPhonu otevřete Export → Automatizované, nebo na iPadu Automatizace v postranním panelu. Vyberte Nová automatizace, nebo otevřete existující automatizaci k úpravě.

Název, stav a oznámení

Zadejte název, který tuto automatizaci identifikuje. Zapnuto umožňuje automatické běhy; nechte vypnuté, dokud nebudete připraveni.

Zvolte libovolná oznámení o běhu:

• Oznámit při aktualizaci mezipaměti hlásí, že data exportu byla připravena.
• Oznámit při běhu hlásí úspěšnou publikaci na broker.

Na výzvu povolte oznámení. Tato oznámení hlásí aktivitu; nenaplánují běh.

Nastavení připojení

1. Jako Typ automatizace zvolte MQTT.
2. Zadejte název hostitele nebo IP adresu a port brokeru. Výchozí port je 1883.
3. Zadejte Téma, například health/metrics.
4. Nastavte jedinečné ID klienta pro každou automatizaci a zadejte uživatelské jméno a heslo, pokud to broker vyžaduje.

Broker musí být dostupný z vašeho zařízení. Odběratelé musí používat přesné téma včetně velikosti písmen. Opakované použití ID klienta může způsobit, že se připojení brokeru navzájem nahradí.

Nastavení typu dat

Pro tuto automatizaci vyberte jeden Typ dat: Zdravotní metriky, Tréninky, Symptomy, EKG, Oznámení o tepové frekvenci, Stav mysli, Sledování cyklu nebo Léky. Stav mysli vyžaduje iOS 18 nebo novější; Léky vyžadují iOS 26 nebo novější a samostatný přístup k lékům.

Zdravotní metriky

Zvolte Zdravotní metriky, poté otevřete Vybrat zdravotní metriky a vyberte potřebná měření.

Chcete-li omezit čtení na konkrétní aplikace nebo zařízení, otevřete Preferované zdroje, zvolte metriku a vyberte její zdroje. Vše povoluje každý zdroj, který nebyl vyloučen. Použijte Vyloučené zdroje k ignorování zdroje napříč zdravotními metrikami této automatizace. Vyloučení mají přednost; nevybraný zdroj se nenahrazuje, když preferovaný zdroj nemá data. Vyberte Uložit pro použití voleb zdrojů, nebo Zrušit pro jejich zrušení.

Tréninky

Zvolte Tréninky pro export záznamů tréninků. Zahrnout data trasy přidává dostupné body trasy do JSON dat tréninku. Nevytváří samostatná nahrání GPX.

Pro Verzi 2 zapněte Zahrnout metriky tréninku pro přidání čtení, jako je tepová frekvence, aktivní energie a kroky. Pro Časové seskupení metrik tréninku zvolte Minuty nebo Sekundy; sekundy produkují více detailů a větší exporty. Verze 1 vždy zahrnuje metriky tréninku.

Nastavení exportu

MQTT publikuje pouze JSON. Zprávy používají QoS 0 pro publikování v popředí a QoS 1 pro publikování na pozadí. Zprávy se neuchovávají.

Verze exportu

Zvolte Verzi 2 pro aktuální strukturu dat. Použijte Verzi 1, když stávající workflow závisí na starším formátu.

Časové období

Výběr	Zahrnutá data
Výchozí	Předchozí den a dnešek až do času běhu
Od poslední synchronizace	Od předchozí synchronizace až do času běhu
Dnes	Dnešek až do času běhu
Včera	Předchozí celý den
Předchozích 7 dní	Předchozích sedm celých dní

Shrnout data a časové seskupení

Pro JSON + Zdravotní metriky zapněte Shrnout data pro kombinování čtení do časových skupin, nebo vypněte pro jednotlivá čtení, kde jsou dostupná. Shrnutí závisí na metrice — například kroky se sčítají a čtení hmotnosti se průměrují. CSV exporty zdravotních metrik používají shrnutá data.

Když je dostupné Časové seskupení, zvolte, kolik detailů zachovat. Hodinové nebo denní skupiny produkují méně řádků než minutové nebo sekundové. Dostupné volby závisí na časovém období a formátu. Časové seskupení tréninků se konfiguruje samostatně pod Tréninky.

Plánování připomínek

Chcete-li výzvu k odemčení a otevření aplikace, zapněte Povolit připomínky. Zvolte Hodinově, Každý den nebo Vybrané dny a nastavte minutu, čas a dny podle potřeby. Na výzvu povolte přístup k oznámením; pokud je přístup odepřen, použijte Otevřít nastavení oznámení.

Připomínka nespouští automatizaci ani nepotvrzuje úspěšnou synchronizaci. Klepnutím ji otevřete, nebo použijte Otevřít a synchronizovat na oznámení k vyžádání běhu. Automatizace musí být zapnutá; připomínka se může stále objevit po úspěšném běhu na pozadí. Změny připomínek se projeví při uložení.

Frekvence synchronizace a uložení

Pod Frekvence synchronizace zvolte číslo a Minuty, Hodiny, Dny nebo Týdny — například každých 15 minut. Jedná se o požadovaný rytmus na pozadí, nikoli o garantovaný plán.

Zařízení musí být odemčené, když se čtou zdravotní data. Povolte Obnovování na pozadí pro Health Auto Export a vypněte Režim nízké spotřeby pro automatické běhy. iOS může běhy stále zpozdit, když bylo zařízení neaktivní nebo jsou omezené systémové prostředky.

Zapněte Zapnuto, až budete připraveni na automatické běhy, a poté vyberte Aktualizovat pro uložení automatizace. Vybrané časové období můžete nahrát ihned pomocí kroků níže.

Export historických nebo zmeškaných dat

Použijte Manuální nahrání, když automatizaci poprvé nastavujete pro export historických dat, nebo později k pokrytí dat zmeškaných automatickou synchronizací. Můžete jej také použít ke kontrole nastavení.

1. Připojte odběratele MQTT k brokeru a přihlaste se k nakonfigurovanému tématu.
2. V Health Auto Export otevřete automatizaci a pod Exportovat existující data vyberte Manuální nahrání.
3. Nastavte data Začátek a Konec a poté vyberte Zahájit export.
4. Zkontrolujte přijatý JSON a jeho data.

Payload se řídí formátem exportu JSON. Například:

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

Řešení problémů

• Připojení selhalo: Zkontrolujte hostitele, port, přístup k síti a požadavky na připojení brokeru.
• Autentizace selhala: Zkontrolujte přihlašovací údaje a oprávnění publikovat na téma.
• Žádná zpráva: Potvrďte, že odběratel používá stejný broker a přesné téma, a poté prohlédněte Protokoly aktivity.
• Zpráva je příliš velká: Vyberte méně metrik, kratší období nebo hrubší časové seskupení.

Otevřete automatizaci a vyberte Zobrazit protokoly aktivity pro kontrolu běhu. Varování označují potenciální problémy, například pomalé načítání dat; chyby identifikují neúspěšné kroky. Pro pomoc s nahlášením problému viz Získání pomoci.