Synkroniser Apple Health-data til MQTT
Publicer sundhedsdata til en MQTT-broker.
Senest opdateret: 31. oktober 2026
På denne side
Publicer sundhedseksporter som JSON til et emne på din MQTT-broker.
Vigtigt — begrænsninger for automatiseringer: Din enhed skal være ulåst for at læse sundhedsdata, og iOS garanterer ikke baggrundskørsler med den frekvens, du vælger. Gennemgå begrænsninger for automatiseringer, før du stoler på automatiske eksporter.
Åbn automatiseringen
Åbn Eksporter → Automatiseret på iPhone, eller Automatiseringer i iPad-sidebjælken. Vælg Ny automatisering, eller åbn en eksisterende for at redigere den.
Navn, status og notifikationer
Indtast et navn, der identificerer denne automatisering. Aktiveret tillader automatiske kørsler; lad den være slået fra, indtil du er klar.
Vælg de kørselsnotifikationer, du ønsker:
- Giv besked ved cacheopdatering rapporterer, at eksportdata blev forberedt.
- Giv besked ved kørsel rapporterer en vellykket publicering til brokeren.
Tillad notifikationer, når du bliver bedt om det. Disse notifikationer rapporterer aktivitet; de planlægger ikke en kørsel.
Opsæt forbindelsen
- Vælg MQTT som Automatiseringstype.
- Indtast din brokers værtsnavn eller IP-adresse og port. Standardporten er 1883.
- Indtast Emne, for eksempel
health/metrics. - Angiv et unikt Klient-id for hver automatisering, og indtast brugernavn og adgangskode, hvis brokeren kræver det.
Brokeren skal være tilgængelig fra din enhed. Abonnenter skal bruge det nøjagtige emne, inklusive store og små bogstaver. Genbrug af et klient-id kan få brokerforbindelser til at erstatte hinanden.
Indstillinger for datatype
Vælg én Datatype til denne automatisering: Sundhedsmålinger, Træninger, Symptomer, ECG, Pulsnotifikationer, Sindstilstand, Cyklussporing eller Medicin. Sindstilstand kræver iOS 18 eller nyere; Medicin kræver iOS 26 eller nyere og separat medicinadgang.
Sundhedsmålinger
Vælg Sundhedsmålinger, åbn derefter Vælg sundhedsmålinger, og vælg de målinger, du har brug for.
For at begrænse målinger til bestemte apps eller enheder skal du åbne Foretrukne kilder, vælge en måling og vælge dens kilder. Alle tillader enhver kilde, der ikke er udelukket. Brug Udelukkede kilder for at ignorere en kilde på tværs af denne automatiserings sundhedsmålinger. Udelukkelser har forrang; en ikke-valgt kilde erstattes ikke, når en foretrukken kilde ikke har data. Vælg Gem for at anvende kildevalgene eller Annuller for at kassere dem.
Træninger
Vælg Træninger for at eksportere træningsposter. Inkluder rutedata tilføjer tilgængelige rutepunkter til JSON-træningsdata. Det opretter ikke separate GPX-uploads.
For Version 2 skal du slå Inkluder træningsmålinger til for at tilføje målinger som puls, aktiv energi og skridt. Vælg Minutter eller Sekunder til Tidsgruppering for træningsmålinger; sekunder giver mere detaljer og større eksporter. Version 1 inkluderer altid træningsmålinger.
Eksportindstillinger
MQTT publicerer kun JSON. Beskeder bruger QoS 0 til forgrundspublicering og QoS 1 til baggrundspublicering. Beskeder bevares ikke.
Eksportversion
Vælg Version 2 til den aktuelle datastruktur. Brug Version 1, når en eksisterende arbejdsgang afhænger af det ældre format.
Datointerval
| Valg | Data inkluderet |
|---|---|
| Standard | Den forrige dag og i dag frem til kørselstidspunktet |
| Siden sidste synkronisering | Siden den forrige synkronisering frem til kørselstidspunktet |
| I dag | I dag frem til kørselstidspunktet |
| I går | Den forrige fulde dag |
| Forrige 7 dage | De forrige syv fulde dage |
Opsummer data og tidsgruppering
For JSON + Sundhedsmålinger skal du slå Opsummer data til for at kombinere målinger i tidsgrupper, eller fra for individuelle målinger, hvor det er tilgængeligt. Opsummeringen afhænger af målingen—for eksempel summeres skridt, og vægtmålinger gennemsnitberegnes. CSV-eksporter af sundhedsmålinger bruger opsummerede data.
Når Tidsgruppering er tilgængelig, skal du vælge, hvor meget detaljer du vil beholde. Time- eller dagsgrupper giver færre rækker end minut- eller sekundgrupper. Tilgængelige valg afhænger af datointerval og format. Tidsgruppering for træninger konfigureres separat under Træninger.
Planlæg påmindelser
Hvis du ønsker en prompt til at låse op og åbne appen, skal du slå Aktiver påmindelser til. Vælg Hver time, Hver dag eller Valgte dage, og indstil derefter minut, tidspunkt og dage efter behov. Tillad adgang til notifikationer, når du bliver bedt om det; hvis adgang nægtes, skal du bruge Åbn notifikationsindstillinger.
En påmindelse kører ikke automatiseringen og bekræfter ikke en vellykket synkronisering. Tryk på den for at åbne automatiseringen, eller brug Åbn og synkroniser på notifikationen for at anmode om en kørsel. Automatiseringen skal være aktiveret; en påmindelse kan stadig vises efter en vellykket baggrundskørsel. Ændringer af påmindelser gælder, når du gemmer.
Synkroniseringsfrekvens og gem
Vælg et tal og Minutter, Timer, Dage eller Uger under Synkroniseringsfrekvens—for eksempel hvert 15. minut. Dette er en ønsket baggrundskadens, ikke en garanteret tidsplan.
Din enhed skal være ulåst, når sundhedsdata læses. Aktivér Baggrundsopdatering af apps for Health Auto Export, og slå Lavstrømstilstand fra for automatiske kørsler. iOS kan stadig forsinke kørsler, når enheden har været inaktiv, eller systemressourcerne er begrænsede.
Slå Aktiveret til, når du er klar til automatiske kørsler, og vælg derefter Opdater for at gemme automatiseringen. Du kan straks uploade et valgt datointerval med trinnene nedenfor.
Eksporter historiske eller manglende data
Brug Manuel upload, når du først sætter automatiseringen op for at eksportere historiske data, eller senere for at dække datoer, som den automatiske synkronisering har misset. Du kan også bruge den til at tjekke din opsætning.
- Opret forbindelse mellem en MQTT-abonnent og din broker, og abonner på det konfigurerede emne.
- Åbn i Health Auto Export automatiseringen, og vælg Manuel upload under Eksporter eksisterende data.
- Indstil datoerne Start og Slut, og vælg derefter Start eksport.
- Tjek den modtagne JSON og dens datoer.
Payloaden følger JSON-eksportformatet. For eksempel:
{
"data": {
"metrics": [
{
"name": "step_count",
"units": "count",
"data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
}
]
}
}
Fejlfinding
- Forbindelse mislykkedes: Tjek vært, port, netværksadgang og brokernes forbindelseskrav.
- Godkendelse mislykkedes: Tjek legitimationsoplysninger og tilladelse til at publicere til emnet.
- Ingen besked: Bekræft, at abonnenten bruger den samme broker og det nøjagtige emne, og gennemgå derefter aktivitetslogfiler.
- Besked for stor: Vælg færre målinger, et kortere interval eller grovere tidsgruppering.
Åbn automatiseringen, og vælg Vis aktivitetslogfiler for at gennemgå en kørsel. Advarsler markerer potentielle problemer såsom langsom datahentning; fejl identificerer mislykkede trin. For hjælp til at rapportere et problem, se Få hjælp.