Sincronizați datele Apple Health pe MQTT

Publicați exporturile de sănătate ca JSON pe un topic al brokerului MQTT.

Important — limitele automatizărilor: Dispozitivul trebuie să fie deblocat pentru a citi datele de sănătate, iar iOS nu garantează rulări în fundal la frecvența aleasă. Examinați Limitele automatizărilor înainte de a vă baza pe exporturi automate.

Deschideți automatizarea

Deschideți Export → Automatizat pe iPhone, sau Automatizări în bara laterală iPad. Selectați Automatizare nouă, sau deschideți o automatizare existentă pentru a o edita.

Nume, status și notificări

Introduceți un nume care identifică această automatizare. Activat permite rulări automate; lăsați-l dezactivat până sunteți gata.

Alegeți orice notificări de rulare pe care le doriți:

• Notifică la actualizarea cache-ului raportează că datele de export au fost pregătite.
• Notifică la rulare raportează o publicare reușită pe broker.

Permiteți notificările când vi se solicită. Aceste notificări raportează activitatea; nu programează o rulare.

Configurați conexiunea

1. Alegeți MQTT ca Tip automatizare.
2. Introduceți hostname-ul sau adresa IP a brokerului și portul. Portul implicit este 1883.
3. Introduceți Topic, de exemplu health/metrics.
4. Setați un ID client unic pentru fiecare automatizare și introduceți un nume de utilizator și o parolă dacă brokerul le solicită.

Brokerul trebuie să fie accesibil de pe dispozitiv. Abonații trebuie să folosească topic-ul exact, inclusiv majusculele. Reutilizarea unui client ID poate face ca conexiunile brokerului să se înlocuiască reciproc.

Setări tip de date

Selectați un Tip de date pentru această automatizare: Metrici de sănătate, Antrenamente, Simptome, ECG, Notificări frecvență cardiacă, Stare de spirit, Urmărire ciclu sau Medicamente. Stare de spirit necesită iOS 18 sau ulterior; Medicamente necesită iOS 26 sau ulterior și acces separat la medicamente.

Metrici de sănătate

Alegeți Metrici de sănătate, apoi deschideți Selectați metricile de sănătate și selectați măsurătorile de care aveți nevoie.

Pentru a limita citirile la anumite aplicații sau dispozitive, deschideți Surse preferate, alegeți o metrică și selectați-i sursele. Toate permite fiecare sursă care nu a fost exclusă. Folosiți Surse excluse pentru a ignora o sursă pentru toate metricile de sănătate ale acestei automatizări. Excluderile au prioritate; o sursă neselectată nu este substituită când o sursă preferată nu are date. Selectați Salvează pentru a aplica alegerile de surse sau Anulează pentru a le renunța.

Antrenamente

Alegeți Antrenamente pentru a exporta înregistrările de antrenament. Include datele rutei adaugă punctele de rută disponibile la datele JSON ale antrenamentului. Nu creează încărcări GPX separate.

Pentru Versiunea 2, activați Include metricile antrenamentului pentru a adăuga citiri precum frecvența cardiacă, energia activă și pașii. Alegeți Minute sau Secunde pentru Grupare temporală a metricilor de antrenament; secundele produc mai multe detalii și exporturi mai mari. Versiunea 1 include întotdeauna metricile de antrenament.

Setări export

MQTT publică doar JSON. Mesajele folosesc QoS 0 pentru publicarea în prim-plan și QoS 1 pentru publicarea în fundal. Mesajele nu sunt reținute.

Versiune export

Alegeți Versiunea 2 pentru structura curentă de date. Folosiți Versiunea 1 când un flux de lucru existent depinde de formatul mai vechi.

Interval de date

Selecție	Date incluse
Implicit	Ziua anterioară și ziua de azi până la ora rulării
De la ultima sincronizare	De la sincronizarea anterioară până la ora rulării
Astăzi	Azi până la ora rulării
Ieri	Ziua anterioară completă
Ultimele 7 zile	Cele șapte zile complete anterioare

Rezumați datele și gruparea temporală

Pentru JSON + Metrici de sănătate, activați Rezumați datele pentru a combina citirile în grupuri temporale, sau dezactivați-l pentru citiri individuale unde sunt disponibile. Rezumatul depinde de metrică—de exemplu, pașii sunt totalizați și citirile de greutate sunt medii. Exporturile CSV ale metricilor de sănătate folosesc date rezumate.

Când Grupare temporală este disponibilă, alegeți cât detaliu să păstrați. Grupurile orare sau zilnice produc mai puține rânduri decât grupurile pe minut sau secundă. Alegerile disponibile depind de intervalul de date și format. Gruparea temporală a antrenamentelor este configurată separat sub Antrenamente.

Programați mementouri

Dacă doriți un memento să deblocați și să deschideți aplicația, activați Activează mementourile. Alegeți Orar, În fiecare zi sau Zile selectate, apoi setați minutul, ora și zilele după caz. Permiteți accesul la notificări când vi se solicită; dacă accesul este refuzat, folosiți Deschide setările de notificări.

Un memento nu rulează automatizarea și nu confirmă o sincronizare reușită. Atingeți-l pentru a deschide automatizarea, sau folosiți Deschide și sincronizează pe notificare pentru a solicita o rulare. Automatizarea trebuie să fie activată; un memento poate apărea totuși după o rulare reușită în fundal. Modificările mementourilor se aplică când salvați.

Frecvență de sincronizare și salvare

Alegeți un număr și Minute, Ore, Zile sau Săptămâni sub Frecvență de sincronizare—de exemplu, la fiecare 15 minute. Aceasta este o cadență de fundal dorită, nu un program garantat.

Dispozitivul trebuie să fie deblocat când se citesc datele de sănătate. Activați Actualizare în fundal pentru Health Auto Export și dezactivați Modul de consum redus pentru rulări automate. iOS poate totuși întârzia rulările când dispozitivul a fost inactiv sau resursele sistemului sunt limitate.

Activați Activat când sunteți gata pentru rulări automate, apoi selectați Actualizează pentru a salva automatizarea. Puteți încărca imediat un interval de date selectat folosind pașii de mai jos.

Exportați date istorice sau ratate

Folosiți Încărcare manuală când configurați prima dată automatizarea pentru a exporta date istorice, sau mai târziu pentru a acoperi datele ratate de sincronizarea automată. Îl puteți folosi și pentru a verifica configurarea.

1. Conectați un abonat MQTT la broker și abonați-vă la topic-ul configurat.
2. În Health Auto Export, deschideți automatizarea și selectați Încărcare manuală sub Exportați datele existente.
3. Setați datele Început și Sfârșit, apoi selectați Începe exportul.
4. Verificați JSON-ul primit și datele sale.

Payload-ul urmează formatul de export JSON. De exemplu:

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

Depanare

• Conexiune eșuată: Verificați hostul, portul, accesul la rețea și cerințele de conexiune ale brokerului.
• Autentificare eșuată: Verificați acreditările și permisiunea de a publica pe topic.
• Niciun mesaj: Confirmați că abonatul folosește același broker și topic-ul exact, apoi examinați jurnalele de activitate.
• Mesaj prea mare: Selectați mai puține metrici, un interval mai scurt sau o grupare temporală mai grosieră.

Deschideți automatizarea și selectați Vizualizați jurnalele de activitate pentru a examina o rulare. Avertismentele semnalează probleme potențiale precum recuperarea lentă a datelor; erorile identifică pașii eșuați. Pentru ajutor la raportarea unei probleme, consultați Obținerea de ajutor.