Sinkronizacija Apple Health podataka u MQTT

Objavljujte zdravstvene izvoze kao JSON na temu na svom MQTT brokeru.

Važno — ograničenja automatizacija: Uređaj mora biti otključan da bi se mogli čitati zdravstveni podaci, a iOS ne jamči pokretanja u pozadini na odabranoj učestalosti. Prije oslanjanja na automatske izvoze pregledajte Ograničenja automatizacija.

Otvaranje automatizacije

Na iPhoneu otvorite Izvoz → Automatizirano ili na iPadu Automatizacije u bočnoj traci. Odaberite Nova automatizacija ili otvorite postojeću automatizaciju za uređivanje.

Naziv, status i obavijesti

Unesite naziv koji identificira ovu automatizaciju. Omogućeno dopušta automatska pokretanja; ostavite isključeno dok ne budete spremni.

Odaberite bilo koje obavijesti o pokretanju koje želite:

• Obavijesti pri ažuriranju predmemorije javlja da su podaci izvoza pripremljeni.
• Obavijesti pri pokretanju javlja uspješnu objavu na broker.

Dopustite obavijesti kada se to zatraži. Te obavijesti prijavljuju aktivnost; ne zakazuju pokretanje.

Postavljanje povezivanja

1. Kao Tip automatizacije odaberite MQTT.
2. Unesite naziv hosta ili IP adresu i port brokera. Zadani port je 1883.
3. Unesite Temu, na primjer health/metrics.
4. Postavite jedinstveni ID klijenta za svaku automatizaciju i unesite korisničko ime i lozinku ako to broker zahtijeva.

Broker mora biti dostupan s vašeg uređaja. Pretplatnici moraju koristiti točnu temu uključujući veličinu slova. Ponovna upotreba ID-a klijenta može uzrokovati da se povezivanja brokera međusobno zamijene.

Postavke tipa podataka

Za ovu automatizaciju odaberite jedan Tip podataka: Zdravstvene metrike, Treninzi, Simptomi, ECG, Obavijesti o frekvenciji otkucaja srca, Stanje uma, Praćenje ciklusa ili Lijekovi. Stanje uma zahtijeva iOS 18 ili noviji; Lijekovi zahtijevaju iOS 26 ili noviji i zaseban pristup lijekovima.

Zdravstvene metrike

Odaberite Zdravstvene metrike, zatim otvorite Odaberi zdravstvene metrike i odaberite mjerenja koja trebate.

Da ograničite očitanja na određene aplikacije ili uređaje, otvorite Preferirani izvori, odaberite metriku i odaberite njezine izvore. Svi dopušta svaki izvor koji nije isključen. Koristite Isključeni izvori za zanemarivanje izvora u zdravstvenim metrikama ove automatizacije. Isključenja imaju prednost; neodabrani izvor ne zamjenjuje se kada preferirani izvor nema podataka. Odaberite Spremi za primjenu odabira izvora ili Odustani za njihovo odbacivanje.

Treninzi

Odaberite Treninzi za izvoz zapisa treninga. Uključi podatke rute dodaje dostupne točke rute u JSON podatke treninga. Ne stvara zasebna GPX učitavanja.

Za Verziju 2 uključite Uključi metrike treninga za dodavanje očitanja kao što su frekvencija otkucaja srca, aktivna energija i koraci. Za Vremensku grupaciju metrika treninga odaberite Minute ili Sekunde; sekunde proizvode više detalja i veće izvoze. Verzija 1 uvijek uključuje metrike treninga.

Postavke izvoza

MQTT objavljuje samo JSON. Poruke koriste QoS 0 za objavljivanje u prednjem planu i QoS 1 za objavljivanje u pozadini. Poruke se ne zadržavaju.

Verzija izvoza

Odaberite Verziju 2 za trenutačnu strukturu podataka. Koristite Verziju 1 kada postojeći tijek rada ovisi o starijem formatu.

Raspon datuma

Odabir	Uključeni podaci
Zadano	Prethodni dan i današnji dan do vremena pokretanja
Od posljednje sinkronizacije	Od prethodne sinkronizacije do vremena pokretanja
Danas	Današnji dan do vremena pokretanja
Jučer	Prethodni puni dan
Prethodnih 7 dana	Prethodnih sedam punih dana

Sažmi podatke i vremenska grupacija

Za JSON + Zdravstvene metrike uključite Sažmi podatke za kombiniranje očitanja u vremenske grupe ili isključite za pojedinačna očitanja gdje su dostupna. Sažetak ovisi o metrici — na primjer, koraci se zbrajaju, a očitanja težine prosječe. CSV izvozi zdravstvenih metrika koriste sažete podatke.

Kada je dostupna Vremenska grupacija, odaberite koliko detalja zadržati. Satne ili dnevne grupe proizvode manje redaka od minutnih ili sekundnih. Dostupni odabiri ovise o rasponu datuma i formatu. Vremenska grupacija treninga konfigurira se zasebno pod Treninzima.

Zakazivanje podsjetnika

Ako želite podsjetnik da otključate i otvorite aplikaciju, uključite Omogući podsjetnike. Odaberite Satno, Svaki dan ili Odabrani dani, zatim postavite minutu, vrijeme i dane prema potrebi. Dopustite pristup obavijestima kada se to zatraži; ako je pristup odbijen, koristite Otvori postavke obavijesti.

Podsjetnik ne pokreće automatizaciju niti potvrđuje uspješnu sinkronizaciju. Dodirnite ga da otvorite automatizaciju ili koristite Otvori i sinkroniziraj na obavijesti za zahtjev pokretanja. Automatizacija mora biti omogućena; podsjetnik se još može pojaviti nakon uspješnog pokretanja u pozadini. Promjene podsjetnika primjenjuju se kada spremite.

Učestalost sinkronizacije i spremanje

Pod Učestalost sinkronizacije odaberite broj i Minute, Sate, Dane ili Tjedne — na primjer, svakih 15 minuta. To je željeni ritam u pozadini, a ne zajamčeni raspored.

Uređaj mora biti otključan kada se čitaju zdravstveni podaci. Omogućite osvježavanje aplikacije u pozadini za Health Auto Export i isključite način rada niske potrošnje za automatska pokretanja. iOS i dalje može odgoditi pokretanja kada je uređaj bio neaktivan ili su sustavski resursi ograničeni.

Uključite Omogućeno kada budete spremni za automatska pokretanja, zatim odaberite Ažuriraj za spremanje automatizacije. Odabrani raspon datuma možete odmah učitati koracima ispod.

Izvoz povijesnih ili propuštenih podataka

Koristite Ručno učitavanje kada prvi put postavljate automatizaciju za izvoz povijesnih podataka ili kasnije za pokrivanje datuma koje je automatska sinkronizacija propustila. Također ga možete koristiti za provjeru postavki.

1. Povežite MQTT pretplatnika s brokerom i pretplatite se na konfiguriranu temu.
2. U Health Auto Exportu otvorite automatizaciju i pod Izvezi postojeće podatke odaberite Ručno učitavanje.
3. Postavite datume Početak i Kraj, zatim odaberite Započni izvoz.
4. Provjerite primljeni JSON i njegove datume.

Payload slijedi format izvoza JSON. Na primjer:

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

Rješavanje problema

• Povezivanje nije uspjelo: Provjerite host, port, mrežni pristup i zahtjeve povezivanja brokera.
• Autentifikacija nije uspjela: Provjerite vjerodajnice i dopuštenje za objavljivanje na temu.
• Nema poruke: Potvrdite da pretplatnik koristi isti broker i točnu temu, zatim pregledajte Zapisnike aktivnosti.
• Poruka je prevelika: Odaberite manje metrika, kraći raspon ili grubiju vremensku grupaciju.

Otvorite automatizaciju i odaberite Prikaži zapisnike aktivnosti za pregled pokretanja. Upozorenja označavaju potencijalne probleme kao što je sporo dohvaćanje podataka; pogreške identificiraju neuspješne korake. Za pomoć pri prijavi problema pogledajte Dobivanje pomoći.