Synkronoi Apple Health -tiedot Home Assistantiin
Integroi terveystiedot Home Assistantiin.
Päivitetty viimeksi: 31. lokakuuta 2026
Tällä sivulla
Julkaise terveysmittareita Home Assistantiin erillisinä entiteettitiloina. Tämä kohde tukee vain terveysmittareita.
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 Home Assistantiin.
Salli ilmoitukset kehotettaessa. Nämä ilmoitukset raportoivat toiminnasta; ne eivät aikatauluta suoritusta.
Home Assistantin yhdistäminen
- Valitse Automaatiotyypiksi Home Assistant.
- Anna Home Assistant -instanssisi perus-URL, esimerkiksi
http://homeassistant.local:8123. - Luo Long-Lived Access Token Home Assistant -profiilissasi.
- Kohdassa HTTP-otsikot lisää
AuthorizationarvollaBearer YOUR_LONG_LIVED_ACCESS_TOKEN.
Home Assistant -instanssisi on oltava saavutettavissa iPhonesta tai iPadista. HTTPS:lle käytä sertifikaattia, johon laitteesi luottaa.
Terveysmittarien asetukset
Avaa Valitse terveysmittarit ja valitse julkaistavat lukemat.
Avaa Suositellut lähteet valitaksesi lähteet kullekin mittarille. Käytä Kaikki kaikille ei-poissuljetuille lähteille tai Poissuljetut lähteet ohittaaksesi lähteen tässä automaatiossa. Poissulkemiset menevät edelle, eivätkä valitsemattomat lähteet korvaa suositeltua lähdettä ilman tietoja. Valitse Tallenna soveltaaksesi valinnat tai Peruuta hylätäksesi ne.
Vientiasetukset
Home Assistant käyttää omaa JSON-entiteettitilamuotoaan; tiedostomuotoa tai vientiversiota ei ole valittavana.
Päivämääräväli
- Oletus: Sisältää edellisen päivän ja tämän päivän suoritusaikaan asti.
- Tänään: Sisältää tämän päivän suoritusaikaan asti.
- Eilen: Sisältää edellisen täyden päivän.
Aikaryhmitys
Valitse Oletus jättääksesi lukemat ryhmittämättä tai Päivät päivittäisiin yhteenvetoihin. Home Assistantissa ei ole Tiivistä tiedot -kytkintä.
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 tai Tunnit. 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.
Julkaistut entiteetit
Kukin valittu mittari voi tuottaa yhden tai useamman entiteetin. Tunniste alkaa hae.-etuliitteellä, jota seuraa automaation nimi pienillä kirjaimilla ilman välilyöntejä, sitten mittari ja mahdollinen komponentin nimi.
Esimerkiksi automaatio nimeltä Health Metrics voi julkaista askeleet osoitteeseen:
http://homeassistant.local:8123/api/states/hae.healthmetrics_step_count
Tila on uusin lukema valitulle päivälle mittayksikön attribuuteilla. Mittarit kuten verenpaine ja syke käyttävät erillisiä komponenttientiteettejä.
Kun päivällä ei ole tietoja, summat kuten askeleet ja seisontatunnit julkaisevat 0. Muut lukemat, kuten paino tai syke, eivät päivity ennen kuin tietoja on saatavilla, joten Home Assistant voi jatkaa viimeksi vastaanotetun arvon näyttämistä. Aikaisin päivällä summat voivat pysyä 0:ssa, kunnes Watch-tiedot saapuvat iPhoneen.
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.
- Avaa automaatio ja valitse kohdasta Vie olemassa olevat tiedot Manuaalinen lataus.
- Aseta Aloitus- ja Lopetus-päivämäärät, valitse sitten Aloita vienti.
- Home Assistantissa avaa Developer Tools → States ja etsi automaatiosi
hae.-etuliitettä. - Tarkista entiteettiarvot ja päivitysajat.
Vianmääritys
- Todennusvirhe: Tarkista token ja otsikko
Authorization: Bearer .... - Yhteys epäonnistui: Tarkista perus-URL, portti, verkkoyhteys ja sertifikaatin luottamus.
- Joitakin lukemia puuttuu: Tarkista valittu päivä, lähteet ja Aktiviteettilokit. Suoritus voi päivittää joitakin entiteettejä, kun toiset epäonnistuvat.
Avaa automaatio ja valitse Näytä aktiviteettilokit epäonnistuneiden vaiheiden tarkistamiseen. Tukeen katso Apua.