Synchronizácia údajov Apple Health do Home Assistant

Publikujte zdravotné metriky do Home Assistant ako samostatné stavy entít. Tento cieľ podporuje len zdravotné metriky.

Dôležité — obmedzenia automatizácií: Zariadenie musí byť odomknuté na čítanie zdravotných údajov a iOS negarantuje beh na pozadí vo zvolenej frekvencii. Pred spoľahnutím sa na automatické exporty skontrolujte Obmedzenia automatizácií.

Otvorenie automatizácie

Na iPhone otvorte Export → Automatizované, alebo na iPade Automatizácie na bočnom paneli. Vyberte Nová automatizácia alebo otvorte existujúcu automatizáciu na úpravu.

Názov, stav a oznámenia

Zadajte názov, ktorý identifikuje túto automatizáciu. Zapnuté umožňuje automatické spustenia; nechajte vypnuté, kým nebudete pripravení.

Vyberte ľubovoľné oznámenia o spustení:

• Upozorniť pri aktualizácii vyrovnávacej pamäte hlási, že exportné údaje boli pripravené.
• Upozorniť pri spustení hlási úspešné publikovanie do Home Assistant.

Pri výzve povoľte oznámenia. Tieto oznámenia hlásia aktivitu; neplánujú spustenie.

Pripojenie Home Assistant

1. Ako Typ automatizácie zvoľte Home Assistant.
2. Zadajte základnú URL vašej inštancie Home Assistant, napríklad http://homeassistant.local:8123.
3. Vo svojom profile Home Assistant vytvorte dlhodobý prístupový token (Long-Lived Access Token).
4. V časti HTTP hlavičky pridajte Authorization s hodnotou Bearer YOUR_LONG_LIVED_ACCESS_TOKEN.

Vaša inštancia Home Assistant musí byť dostupná z iPhonu alebo iPadu. Pre HTTPS použite certifikát, ktorému zariadenie dôveruje.

Nastavenia zdravotných metrík

Otvorte Vybrať zdravotné metriky a zvoľte hodnoty na publikovanie.

Otvorte Preferované zdroje a vyberte zdroje pre každú metriku. Použite Všetky pre všetky nevylúčené zdroje, alebo Vylúčené zdroje na ignorovanie zdroja v tejto automatizácii. Vylúčenia majú prednosť a nevybrané zdroje nenahrádzajú preferovaný zdroj bez údajov. Vyberte Uložiť na použitie volieb alebo Zrušiť na ich zahodenie.

Nastavenia exportu

Home Assistant používa vlastný formát stavov entít JSON; nie je voľba formátu súboru ani verzie exportu.

Rozsah dátumov

• Predvolené: Zahŕňa predchádzajúci deň a dnešok až do času spustenia.
• Dnes: Zahŕňa dnešok až do času spustenia.
• Včera: Zahŕňa predchádzajúci celý deň.

Časové zoskupenie

Zvoľte Predvolené na ponechanie hodnôt bez zoskupenia alebo Dni na denné súhrny. Home Assistant nemá prepínač Sumarizovať údaje.

Plánovanie pripomienok

Ak chcete výzvu odomknúť a otvoriť aplikáciu, zapnite Zapnúť pripomienky. Zvoľte Každú hodinu, Každý deň alebo Vybrané dni a potom podľa potreby nastavte minútu, čas a dni. Pri výzve povoľte prístup k oznámeniam; ak je prístup zamietnutý, použite Otvoriť nastavenia oznámení.

Pripomienka nespúšťa automatizáciu ani nepotvrdzuje úspešnú synchronizáciu. Klepnutím ju otvoríte, alebo na oznámení použite Otvoriť a synchronizovať na požiadanie spustenia. Automatizácia musí byť zapnutá; pripomienka sa môže zobraziť aj po úspešnom behu na pozadí. Zmeny pripomienok platia pri uložení.

Frekvencia synchronizácie a uloženie

V časti Frekvencia synchronizácie zvoľte číslo a Minúty alebo Hodiny. Ide o požadovanú kadenciu na pozadí, nie o zaručený rozvrh.

Zariadenie musí byť odomknuté, keď sa čítajú zdravotné údaje. Pre automatické spustenia zapnite Obnovenie aplikácií na pozadí pre Health Auto Export a vypnite režim nízkej spotreby. iOS môže spustenia stále oneskoriť, keď bolo zariadenie neaktívne alebo sú systémové zdroje obmedzené.

Keď ste pripravení na automatické spustenia, zapnite Zapnuté a potom vyberte Aktualizovať na uloženie automatizácie. Vybraný rozsah dátumov môžete okamžite nahrať podľa krokov nižšie.

Publikované entity

Každá vybraná metrika môže vytvoriť jednu alebo viac entít. Identifikátor začína hae., nasleduje názov automatizácie malými písmenami bez medzier, potom metrika a prípadný názov komponentu.

Napríklad automatizácia s názvom Health Metrics môže publikovať kroky na:

http://homeassistant.local:8123/api/states/hae.healthmetrics_step_count

Stav je najnovšia hodnota pre vybraný deň, s atribútmi mernej jednotky. Metriky ako krvný tlak a srdcová frekvencia používajú samostatné entity komponentov.

Keď deň nemá údaje, súčty ako kroky a hodiny státia publikujú 0. Iné hodnoty, napríklad hmotnosť alebo srdcová frekvencia, sa neaktualizujú, kým nie sú údaje dostupné, takže Home Assistant môže naďalej zobrazovať poslednú prijatú hodnotu. Skoro ráno môžu súčty zostať 0, kým údaje z Watch nedôjdu na iPhone.

Export historických alebo vynechaných údajov

Použite Manuálne nahratie, keď automatizáciu prvýkrát nastavujete na export historických údajov, alebo neskôr na pokrytie dátumov, ktoré automatická synchronizácia vynechala. Môžete ho použiť aj na overenie nastavenia.

1. Otvorte automatizáciu a v časti Exportovať existujúce údaje vyberte Manuálne nahratie.
2. Nastavte dátumy Začiatok a Koniec a potom vyberte Začať export.
3. V Home Assistant otvorte Developer Tools → States a vyhľadajte predponu hae. vašej automatizácie.
4. Skontrolujte hodnoty entít a časy aktualizácie.

Riešenie problémov

• Chyba overenia: Skontrolujte token a hlavičku Authorization: Bearer ....
• Pripojenie zlyhalo: Skontrolujte základnú URL, port, sieťový prístup a dôveru certifikátu.
• Niektoré hodnoty chýbajú: Skontrolujte vybraný deň, zdroje a denníky aktivity. Spustenie môže aktualizovať niektoré entity, zatiaľ čo iné zlyhajú.

Otvorte automatizáciu a vyberte Zobraziť denníky aktivity na kontrolu zlyhaných krokov. Pre podporu pozrite Získanie pomoci.