Synchronizace dat Apple Health do Home Assistant

Publikujte zdravotní metriky do Home Assistant jako samostatné stavy entit. Tento cíl podporuje pouze zdravotní metriky.

Důležité — omezení automatizací: Zařízení musí být odemčené, aby bylo možné číst zdravotní data, a iOS negarantuje běhy na pozadí ve zvolené frekvenci. Před spoléháním na automatické exporty si prohlédněte Omezení automatizací.

Otevření automatizace

Na iPhonu otevřete Export → Automatizované, nebo na iPadu Automatizace v postranním panelu. Vyberte Nová automatizace, nebo otevřete existující automatizaci k úpravě.

Název, stav a oznámení

Zadejte název, který tuto automatizaci identifikuje. Zapnuto umožňuje automatické běhy; nechte vypnuté, dokud nebudete připraveni.

Zvolte libovolná oznámení o běhu:

• Oznámit při aktualizaci mezipaměti hlásí, že data exportu byla připravena.
• Oznámit při běhu hlásí úspěšnou publikaci do Home Assistant.

Na výzvu povolte oznámení. Tato oznámení hlásí aktivitu; nenaplánují běh.

Připojení Home Assistant

1. Jako Typ automatizace zvolte Home Assistant.
2. Zadejte základní URL vaší instance Home Assistant, například http://homeassistant.local:8123.
3. Ve svém profilu Home Assistant vytvořte Long-Lived Access Token.
4. Pod HTTP hlavičky přidejte Authorization s hodnotou Bearer YOUR_LONG_LIVED_ACCESS_TOKEN.

Vaše instance Home Assistant musí být dostupná z iPhonu nebo iPadu. Pro HTTPS použijte certifikát, kterému zařízení důvěřuje.

Nastavení zdravotních metrik

Otevřete Vybrat zdravotní metriky a zvolte čtení k publikování.

Otevřete Preferované zdroje pro výběr zdrojů pro každou metriku. Použijte Vše pro všechny nevyloučené zdroje, nebo Vyloučené zdroje k ignorování zdroje napříč touto automatizací. Vyloučení mají přednost a nevybrané zdroje nenahrazují preferovaný zdroj bez dat. Vyberte Uložit pro použití voleb, nebo Zrušit pro jejich zrušení.

Nastavení exportu

Home Assistant používá vlastní formát stavu entit JSON; není volba formátu souboru ani verze exportu.

Časové období

• Výchozí: Zahrnuje předchozí den a dnešek až do času běhu.
• Dnes: Zahrnuje dnešek až do času běhu.
• Včera: Zahrnuje předchozí celý den.

Časové seskupení

Zvolte Výchozí pro ponechání čtení neseskupených, nebo Dny pro denní souhrny. Home Assistant nemá přepínač Shrnout data.

Plánování připomínek

Chcete-li výzvu k odemčení a otevření aplikace, zapněte Povolit připomínky. Zvolte Hodinově, Každý den nebo Vybrané dny a nastavte minutu, čas a dny podle potřeby. Na výzvu povolte přístup k oznámením; pokud je přístup odepřen, použijte Otevřít nastavení oznámení.

Připomínka nespouští automatizaci ani nepotvrzuje úspěšnou synchronizaci. Klepnutím ji otevřete, nebo použijte Otevřít a synchronizovat na oznámení k vyžádání běhu. Automatizace musí být zapnutá; připomínka se může stále objevit po úspěšném běhu na pozadí. Změny připomínek se projeví při uložení.

Frekvence synchronizace a uložení

Pod Frekvence synchronizace zvolte číslo a Minuty nebo Hodiny. Jedná se o požadovaný rytmus na pozadí, nikoli o garantovaný plán.

Zařízení musí být odemčené, když se čtou zdravotní data. Povolte Obnovování na pozadí pro Health Auto Export a vypněte Režim nízké spotřeby pro automatické běhy. iOS může běhy stále zpozdit, když bylo zařízení neaktivní nebo jsou omezené systémové prostředky.

Zapněte Zapnuto, až budete připraveni na automatické běhy, a poté vyberte Aktualizovat pro uložení automatizace. Vybrané časové období můžete nahrát ihned pomocí kroků níže.

Publikované entity

Každá vybraná metrika může vytvořit jednu nebo více entit. Identifikátor začíná hae., následuje název automatizace malými písmeny bez mezer, poté metrika a případný název komponenty.

Například automatizace pojmenovaná Health Metrics může publikovat kroky na:

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

Stav je nejnovější čtení pro vybraný den, s atributy měrné jednotky. Metriky jako krevní tlak a tepová frekvence používají samostatné entity komponent.

Když den nemá data, součty jako kroky a hodiny stání publikují 0. Jiná čtení, jako hmotnost nebo tepová frekvence, se neaktualizují, dokud nejsou data dostupná, takže Home Assistant může nadále zobrazovat poslední přijatou hodnotu. Brzy během dne mohou součty zůstat 0, dokud data z Watch nedorazí na iPhone.

Export historických nebo zmeškaných dat

Použijte Manuální nahrání, když automatizaci poprvé nastavujete pro export historických dat, nebo později k pokrytí dat zmeškaných automatickou synchronizací. Můžete jej také použít ke kontrole nastavení.

1. Otevřete automatizaci a pod Exportovat existující data vyberte Manuální nahrání.
2. Nastavte data Začátek a Konec a poté vyberte Zahájit export.
3. V Home Assistant otevřete Developer Tools → States a vyhledejte prefix hae. vaší automatizace.
4. Zkontrolujte hodnoty entit a časy aktualizace.

Řešení problémů

• Chyba autentizace: Zkontrolujte token a hlavičku Authorization: Bearer ....
• Připojení selhalo: Zkontrolujte základní URL, port, přístup k síti a důvěru certifikátu.
• Některá čtení chybí: Prohlédněte vybraný den, zdroje a Protokoly aktivity. Běh může aktualizovat některé entity, zatímco jiné selžou.

Otevřete automatizaci a vyberte Zobrazit protokoly aktivity ke kontrole neúspěšných kroků. Pro podporu viz Získání pomoci.