Synkronoi Apple Health -tiedot MQTT:hen

Julkaise terveysvientejä JSON-muodossa aiheeseen MQTT-brokerillasi.

Tärkeää — automaatioiden rajoitukset: Laitteen on oltava lukitsematta, jotta terveystietoja voidaan lukea, eikä iOS takaa taustasuorituksia valitsemallasi tiheydellä. Ennen kuin luotat automaattisiin vienteihin, tutustu Automaatioiden rajoituksiin.

Automaation avaaminen

iPhonessa avaa Vie → Automatisoitu tai iPadissa Automaatiot sivupalkissa. Valitse Uusi automaatio tai avaa olemassa oleva automaatio muokattavaksi.

Nimi, tila ja ilmoitukset

Anna nimi, joka tunnistaa tämän automaation. Käytössä sallii automaattiset suoritukset; jätä se pois päältä, kunnes olet valmis.

Valitse haluamasi suoritusilmoitukset:

• Ilmoita välimuistin päivityksestä ilmoittaa, että vientitiedot valmisteltiin.
• Ilmoita suorituksesta ilmoittaa onnistuneesta julkaisusta brokerille.

Salli ilmoitukset kehotettaessa. Nämä ilmoitukset raportoivat toiminnasta; ne eivät aikatauluta suoritusta.

Yhteyden asetus

1. Valitse Automaatiotyypiksi MQTT.
2. Anna brokerin isäntänimi tai IP-osoite sekä portti. Oletusportti on 1883.
3. Anna Aihe, esimerkiksi health/metrics.
4. Aseta yksilöllinen Asiakastunnus kullekin automaatiolle ja anna käyttäjänimi sekä salasana, jos broker niitä vaatii.

Brokerin on oltava saavutettavissa laitteeltasi. Tilaajien on käytettävä tarkkaa aihetta kirjainkoon mukaan. Asiakastunnuksen uudelleenkäyttö voi aiheuttaa broker-yhteyksien korvautumisen toisillaan.

Tietotyyppiasetukset

Valitse tälle automaatiolle yksi Tietotyyppi: Terveysmittarit, Treenit, Oireet, ECG, Sykeilmoitukset, Mielen tila, Syklin seuranta tai Lääkkeet. Mielen tila edellyttää iOS 18:aa tai uudempaa; Lääkkeet edellyttävät iOS 26:ta tai uudempaa sekä erillistä lääkkeiden käyttöoikeutta.

Terveysmittarit

Valitse Terveysmittarit, avaa sitten Valitse terveysmittarit ja valitse tarvitsemasi mittaukset.

Rajoittaaksesi lukemat tiettyihin sovelluksiin tai laitteisiin avaa Suositellut lähteet, valitse mittari ja valitse sen lähteet. Kaikki sallii jokaisen lähteen, jota ei ole suljettu pois. Käytä Poissuljetut lähteet ohittaaksesi lähteen tämän automaation terveysmittareissa. Poissulkemiset menevät edelle; valitsematonta lähdettä ei käytetä korvikkeena, kun suositellulla lähteellä ei ole tietoja. Valitse Tallenna soveltaaksesi lähdevalinnat tai Peruuta hylätäksesi ne.

Treenit

Valitse Treenit treenitietueiden vientiin. Sisällytä reittitiedot lisää käytettävissä olevat reittipisteet JSON-treenitietoihin. Se ei luo erillisiä GPX-latauksia.

Versiolle 2 ota käyttöön Sisällytä treenimittarit lisätäksesi lukemia, kuten syke, aktiivinen energia ja askeleet. Valitse treenimittarien Aikaryhmitykseksi Minuutit tai Sekunnit; sekunnit tuottavat enemmän yksityiskohtia ja suurempia vientejä. Versio 1 sisältää aina treenimittarit.

Vientiasetukset

MQTT julkaisee vain JSON:ia. Viestit käyttävät QoS 0 -tasoa etualan julkaisuun ja QoS 1 -tasoa taustajulkaisuun. Viestejä ei säilytetä.

Vientiversio

Valitse Versio 2 nykyiseen tietorakenteeseen. Käytä Versiota 1, kun olemassa oleva työnkulku riippuu vanhemmasta muodosta.

Päivämääräväli

Valinta	Sisältyvät tiedot
Oletus	Edellinen päivä ja tämä päivä suoritusaikaan asti
Viimeisestä synkronoinnista	Edellisestä synkronoinnista suoritusaikaan
Tänään	Tämä päivä suoritusaikaan asti
Eilen	Edellinen täysi päivä
Edelliset 7 päivää	Edelliset seitsemän täyttä päivää

Tiivistä tiedot ja aikaryhmitys

JSON + Terveysmittarit -yhdistelmälle ota käyttöön Tiivistä tiedot yhdistääksesi lukemat aikaryhmiin tai poista käytöstä yksittäisille lukemille, kun ne ovat saatavilla. Tiivistys riippuu mittarista — esimerkiksi askeleet lasketaan yhteen ja painolukemat keskiarvoistetaan. CSV-terveysmittariviennit käyttävät tiivistettyjä tietoja.

Kun Aikaryhmitys on käytettävissä, valitse kuinka paljon yksityiskohtia säilytetään. Tuntiset tai päivittäiset ryhmät tuottavat vähemmän rivejä kuin minuuttiset tai sekuntiset. Käytettävissä olevat valinnat riippuvat päivämäärävälistä ja muodosta. Treenien aikaryhmitys määritetään erikseen Treenit-kohdassa.

Muistutusten aikataulutus

Jos haluat muistutuksen lukituksen avaamisesta ja sovelluksen avaamisesta, ota käyttöön Ota muistutukset käyttöön. Valitse Tunneittain, Joka päivä tai Valitut päivät, aseta sitten minuutti, aika ja päivät tarvittaessa. Salli ilmoitusten käyttöoikeus kehotettaessa; jos käyttöoikeus evätään, käytä Avaa ilmoitusasetukset.

Muistutus ei käynnistä automaatiota eikä vahvista onnistunutta synkronointia. Napauta sitä avataksesi automaation tai käytä ilmoituksen Avaa ja synkronoi -vaihtoehtoa suorituspyyntöön. Automaation on oltava käytössä; muistutus voi silti näkyä onnistuneen taustasuorituksen jälkeen. Muistutusmuutokset soveltuvat, kun tallennat.

Synkronointitiheys ja tallennus

Kohdassa Synkronointitiheys valitse määrä sekä Minuutit, Tunnit, Päivät tai Viikot — esimerkiksi 15 minuutin välein. Tämä on toivottu taustarytmi, ei taattu aikataulu.

Laitteen on oltava lukitsematta, kun terveystietoja luetaan. Ota Taustasovelluksen päivitys käyttöön Health Auto Exportille ja poista Vähävirtaustila käytöstä automaattisia suorituksia varten. iOS voi silti viivästyttää suorituksia, kun laite on ollut käyttämättömänä tai järjestelmäresurssit ovat rajoitetut.

Ota Käytössä käyttöön, kun olet valmis automaattisiin suorituksiin, valitse sitten Päivitä tallentaaksesi automaation. Voit ladata valitun päivämäärävälin heti alla olevilla vaiheilla.

Historiallisten tai väliin jääneiden tietojen vienti

Käytä Manuaalista latausta, kun määrität automaatiota ensimmäistä kertaa historiallisten tietojen vientiin tai myöhemmin peittääksesi päivämäärät, jotka automaattinen synkronointi ohitti. Voit myös käyttää sitä asetusten tarkistamiseen.

1. Yhdistä MQTT-tilaaja brokeriin ja tilaa määritetty aihe.
2. Health Auto Exportissa avaa automaatio ja valitse kohdasta Vie olemassa olevat tiedot Manuaalinen lataus.
3. Aseta Aloitus- ja Lopetus-päivämäärät, valitse sitten Aloita vienti.
4. Tarkista vastaanotettu JSON ja sen päivämäärät.

Payload noudattaa JSON-vientimuotoa. Esimerkiksi:

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

Vianmääritys

• Yhteys epäonnistui: Tarkista isäntä, portti, verkkoyhteys ja brokerin yhteysvaatimukset.
• Todennus epäonnistui: Tarkista tunnukset ja julkaisuoikeus aiheeseen.
• Ei viestiä: Vahvista, että tilaaja käyttää samaa brokeria ja tarkkaa aihetta, tarkista sitten Aktiviteettilokit.
• Viesti on liian suuri: Valitse vähemmän mittareita, lyhyempi väli tai karkeampi aikaryhmitys.

Avaa automaatio ja valitse Näytä aktiviteettilokit suoritusten tarkistamiseen. Varoitukset merkitsevät mahdollisia ongelmia, kuten hidasta tietojen hakua; virheet tunnistavat epäonnistuneet vaiheet. Ongelman ilmoittamiseen katso Apua.