Synkroniser Apple Helse-data til MQTT
Publiser helsedata til en MQTT-broker.
Sist oppdatert: 31. oktober 2026
På denne siden
Publiser helseeksporter som JSON til et emne på MQTT-brokeren din.
Viktig — begrensninger for automatiseringer: Enheten må være ulåst for å lese helsedata, og iOS garanterer ikke bakgrunnskjøringer med frekvensen du velger. Gjennomgå begrensninger for automatiseringer før du stoler på automatiske eksporter.
Åpne automatiseringen
Åpne Eksporter → Automatisert på iPhone, eller Automatiseringer i iPad-sidefeltet. Velg Ny automatisering, eller åpne en eksisterende for å redigere den.
Navn, status og varsler
Angi et navn som identifiserer automatiseringen. Aktivert tillater automatiske kjøringer; la den være av til du er klar.
Velg kjørevarslene du vil ha:
- Varsle ved hurtigbufferoppdatering rapporterer at eksportdata ble forberedt.
- Varsle ved kjøring rapporterer en vellykket publisering til brokeren.
Tillat varsler når du blir bedt om det. Disse varslene rapporterer aktivitet; de planlegger ikke en kjøring.
Konfigurer tilkoblingen
- Velg MQTT som Automatiseringstype.
- Angi brokerens vertsnavn eller IP-adresse og port. Standardporten er 1883.
- Angi Emne, for eksempel
health/metrics. - Angi et unikt Klient-id for hver automatisering og angi brukernavn og passord hvis brokeren krever det.
Brokeren må være tilgjengelig fra enheten. Abonnenter må bruke det eksakte emnet, inkludert store og små bokstaver. Gjenbruk av et klient-id kan få brokertilkoblinger til å erstatte hverandre.
Innstillinger for datatype
Velg en Datatype for denne automatiseringen: Helsemål, Treningsøkter, Symptomer, ECG, Hjertefrekvensvarsler, Sinnstilstand, Syklussporing eller Medisiner. Sinnstilstand krever iOS 18 eller nyere; Medisiner krever iOS 26 eller nyere og separat medisintilgang.
Helsemål
Velg Helsemål, åpne deretter Velg helsemål og velg målene du trenger.
For å begrense målinger til bestemte apper eller enheter åpner du Foretrukne kilder, velger et mål og velger kildene. Alle tillater hver kilde som ikke er ekskludert. Bruk Ekskluderte kilder for å ignorere en kilde over denne automatiseringens helsemål. Ekskluderinger har forrang; en ikke-valgt kilde erstattes ikke når en foretrukket kilde mangler data. Velg Lagre for å bruke kildevalgene eller Avbryt for å forkaste dem.
Treningsøkter
Velg Treningsøkter for å eksportere treningsposter. Inkluder rutedata legger til tilgjengelige rutepunkter i JSON-treningsdata. Det oppretter ikke separate GPX-opplastinger.
For Versjon 2 slår du på Inkluder treningsmål for å legge til målinger som puls, aktiv energi og steg. Velg Minutter eller Sekunder for Tidsgruppering for treningsmål; sekunder gir mer detaljer og større eksporter. Versjon 1 inkluderer alltid treningsmål.
Eksportinnstillinger
MQTT publiserer bare JSON. Meldinger bruker QoS 0 for forgrunnspublisering og QoS 1 for bakgrunnspublisering. Meldinger beholdes ikke.
Eksportversjon
Velg Versjon 2 for den aktuelle datastrukturen. Bruk Versjon 1 når en eksisterende arbeidsflyt avhenger av det eldre formatet.
Datointervall
| Valg | Data som inkluderes |
|---|---|
| Standard | Forrige dag og i dag frem til kjøringstidspunktet |
| Siden siste synkronisering | Siden forrige synkronisering frem til kjøringstidspunktet |
| I dag | I dag frem til kjøringstidspunktet |
| I går | Forrige hele dag |
| Forrige 7 dager | De forrige sju hele dagene |
Summer data og tidsgruppering
For JSON + Helsemål slår du på Summer data for å kombinere målinger i tidsgrupper, eller av for enkeltmålinger der det er tilgjengelig. Summeringen avhenger av målet—for eksempel summeres steg og vektmålinger gjennomsnittsberegnes. CSV-eksporter av helsemål bruker summerte data.
Når Tidsgruppering er tilgjengelig, velger du hvor mye detaljer du vil beholde. Time- eller dagsgrupper gir færre rader enn minutt- eller sekundgrupper. Tilgjengelige valg avhenger av datointervall og format. Tidsgruppering for treningsøkter konfigureres separat under Treningsøkter.
Planlegg påminnelser
Hvis du vil ha en oppfordring til å låse opp og åpne appen, slår du på Aktiver påminnelser. Velg Hver time, Hver dag eller Valgte dager, og angi deretter minutt, tid og dager etter behov. Tillat varslingstilgang når du blir bedt om det; hvis tilgang nektes, bruker du Åpne varslingsinnstillinger.
En påminnelse kjører ikke automatiseringen og bekrefter ikke en vellykket synkronisering. Trykk på den for å åpne automatiseringen, eller bruk Åpne og synkroniser på varselet for å be om en kjøring. Automatiseringen må være aktivert; en påminnelse kan fortsatt vises etter en vellykket bakgrunnskjøring. Endringer i påminnelser gjelder når du lagrer.
Synkroniseringsfrekvens og lagre
Velg et tall og Minutter, Timer, Dager eller Uker under Synkroniseringsfrekvens—for eksempel hvert 15. minutt. Dette er en ønsket bakgrunnskadens, ikke en garantert tidsplan.
Enheten må være ulåst når helsedata leses. Aktiver Bakgrunnsoppdatering for Health Auto Export og slå av Lavstrømsmodus for automatiske kjøringer. iOS kan fortsatt forsinke kjøringer når enheten har vært inaktiv eller systemressursene er begrenset.
Slå på Aktivert når du er klar for automatiske kjøringer, og velg deretter Oppdater for å lagre automatiseringen. Du kan umiddelbart laste opp et valgt datointervall med trinnene nedenfor.
Eksportere historiske eller manglende data
Bruk Manuell opplasting når du først konfigurerer automatiseringen for å eksportere historiske data, eller senere for å dekke datoer den automatiske synkroniseringen har misset. Du kan også bruke den for å sjekke konfigurasjonen.
- Koble en MQTT-abonnent til brokeren og abonner på det konfigurerte emnet.
- Åpne i Health Auto Export automatiseringen og velg Manuell opplasting under Eksporter eksisterende data.
- Angi datoene Start og Slutt, og velg deretter Start eksport.
- Sjekk den mottatte JSON-en og datoene dens.
Nyttelasten følger JSON-eksportformatet. For eksempel:
{
"data": {
"metrics": [
{
"name": "step_count",
"units": "count",
"data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
}
]
}
}
Feilsøking
- Tilkobling mislyktes: Sjekk vert, port, nettverkstilgang og brokerens tilkoblingskrav.
- Autentisering mislyktes: Sjekk påloggingsinformasjon og tillatelse til å publisere til emnet.
- Ingen melding: Bekreft at abonnenten bruker samme broker og det eksakte emnet, og gjennomgå deretter aktivitetslogger.
- Melding for stor: Velg færre mål, et kortere intervall eller grovere tidsgruppering.
Åpne automatiseringen og velg Vis aktivitetslogger for å gjennomgå en kjøring. Advarsler markerer mulige problemer som treg datahenting; feil identifiserer mislykkede trinn. For hjelp til å rapportere et problem, se Få hjelp.