Centrum pomocy HealthyApps
Polski
Centrum pomocy
Strona główna ↗

Szukaj tematów pomocy

Synchronizuj dane Apple Health z Home Assistant

Zintegruj dane zdrowotne z Home Assistant.

Ostatnia aktualizacja: 31 października 2026

Na tej stronie
Otwórz automatyzacjęNazwa, stan i powiadomieniaPołącz Home AssistantUstawienia metryk zdrowia
Ustawienia eksportu Ustawienia eksportu Zakres datGrupowanie czasu
Planuj przypomnieniaCzęstotliwość synchronizacji i zapisOpublikowane encjeEksportuj dane historyczne lub pominięteRozwiązywanie problemów

Publikuj metryki zdrowia w Home Assistant jako osobne stany encji. To miejsce docelowe obsługuje wyłącznie metryki zdrowia.

Ważne — ograniczenia automatyzacji: Urządzenie musi być odblokowane, aby odczytać dane zdrowotne, a iOS nie gwarantuje uruchomień w tle z wybraną częstotliwością. Przejrzyj Ograniczenia automatyzacji, zanim polegiesz na automatycznych eksportach.

Otwórz automatyzację

Otwórz Eksport → Automatyczne na iPhonie albo Automatyzacje w pasku bocznym iPada. Wybierz Nowa automatyzacja albo otwórz istniejącą, aby ją edytować.

Nazwa, stan i powiadomienia

Podaj nazwę identyfikującą tę automatyzację. Włączone zezwala na automatyczne uruchomienia; zostaw wyłączone, aż będziesz gotowy.

Wybierz powiadomienia o uruchomieniu, których chcesz:

  • Powiadom przy aktualizacji pamięci podręcznej zgłasza, że dane eksportu zostały przygotowane.
  • Powiadom po uruchomieniu zgłasza udaną publikację w Home Assistant.

Zezwól na powiadomienia, gdy zostaniesz o to poproszony. Te powiadomienia zgłaszają aktywność; nie planują uruchomienia.

Połącz Home Assistant

  1. Wybierz Home Assistant jako Typ automatyzacji.
  2. Podaj bazowy URL instancji Home Assistant, na przykład http://homeassistant.local:8123.
  3. Utwórz Long-Lived Access Token w profilu Home Assistant.
  4. W Nagłówki HTTP dodaj Authorization z wartością Bearer YOUR_LONG_LIVED_ACCESS_TOKEN.

Twoja instancja Home Assistant musi być osiągalna z iPhone’a lub iPada. W przypadku HTTPS użyj certyfikatu, któremu urządzenie ufa.

Ustawienia metryk zdrowia

Otwórz Wybierz metryki zdrowia i wybierz odczyty do publikacji.

Otwórz Preferowane źródła, aby wybrać źródła dla każdej metryki. Użyj Wszystkie dla wszystkich niewykluczonych źródeł albo Wykluczone źródła, aby ignorować źródło w tej automatyzacji. Wykluczenia mają pierwszeństwo, a niewybrane źródła nie zastępują preferowanego źródła bez danych. Wybierz Zapisz, aby zastosować wybór, albo Anuluj, aby go odrzucić.

Ustawienia eksportu

Home Assistant używa własnego formatu stanu encji JSON; nie ma wyboru formatu pliku ani wersji eksportu.

Zakres dat

  • Domyślny: Obejmuje poprzedni dzień oraz dziś do chwili uruchomienia.
  • Dziś: Obejmuje dziś do chwili uruchomienia.
  • Wczoraj: Obejmuje poprzedni pełny dzień.

Grupowanie czasu

Wybierz Domyślny, aby zachować odczyty bez grupowania, albo Dni dla dziennych podsumowań. Home Assistant nie ma przełącznika Sumuj dane.

Planuj przypomnienia

Jeśli chcesz monitu o odblokowanie i otwarcie aplikacji, włącz Włącz przypomnienia. Wybierz Co godzinę, Codziennie lub Wybrane dni, a następnie ustaw minutę, godzinę i dni stosownie do potrzeby. Zezwól na dostęp do powiadomień, gdy zostaniesz o to poproszony; jeśli dostęp zostanie odrzucony, użyj Otwórz ustawienia powiadomień.

Przypomnienie nie uruchamia automatyzacji ani nie potwierdza udanej synchronizacji. Stuknij je, aby otworzyć automatyzację, albo użyj Otwórz i synchronizuj na powiadomieniu, aby zażądać uruchomienia. Automatyzacja musi być włączona; przypomnienie może nadal się pojawić po udanym uruchomieniu w tle. Zmiany przypomnień obowiązują przy zapisie.

Częstotliwość synchronizacji i zapis

Wybierz liczbę oraz Minuty lub Godziny w Częstotliwość synchronizacji. To żądana kadencja w tle, a nie gwarantowany harmonogram.

Urządzenie musi być odblokowane podczas odczytu danych zdrowotnych. Włącz Odświeżanie aplikacji w tle dla Health Auto Export i wyłącz tryb niskiego zużycia energii na potrzeby automatycznych uruchomień. iOS może nadal opóźniać uruchomienia, gdy urządzenie było nieaktywne lub zasoby systemowe są ograniczone.

Włącz Włączone, gdy będziesz gotowy na automatyczne uruchomienia, a następnie wybierz Aktualizuj, aby zapisać automatyzację. Możesz od razu przesłać wybrany zakres dat, korzystając z kroków poniżej.

Opublikowane encje

Każda wybrana metryka może utworzyć jedną lub więcej encji. Identyfikator zaczyna się od hae., po nim następuje nazwa automatyzacji małymi literami bez spacji, a następnie metryka i ewentualna nazwa komponentu.

Na przykład automatyzacja o nazwie Health Metrics może publikować kroki pod adresem:

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

Stan to najnowszy odczyt dla wybranego dnia z atrybutami jednostki miary. Metryki takie jak ciśnienie krwi i tętno używają osobnych encji komponentów.

Gdy dzień nie ma danych, sumy takie jak kroki i godziny stania publikują 0. Inne odczyty, takie jak waga lub tętno, nie są aktualizowane, dopóki nie ma danych, więc Home Assistant może nadal pokazywać ostatnią otrzymaną wartość. Wczesnym rankiem sumy mogą pozostać 0, aż dane z Watch dotrą do iPhone’a.

Eksportuj dane historyczne lub pominięte

Użyj Przesyłanie ręczne, gdy po raz pierwszy konfigurujesz automatyzację, aby wyeksportować dane historyczne, albo później, aby uzupełnić daty pominięte przez automatyczną synchronizację. Możesz też użyć tego, aby sprawdzić konfigurację.

  1. Otwórz automatyzację i wybierz Przesyłanie ręczne w Eksportuj istniejące dane.
  2. Ustaw daty Początek i Koniec, a następnie wybierz Rozpocznij eksport.
  3. W Home Assistant otwórz Narzędzia deweloperskie → Stany i wyszukaj prefiks hae. swojej automatyzacji.
  4. Sprawdź wartości encji i czasy aktualizacji.

Rozwiązywanie problemów

  • Błąd uwierzytelniania: Sprawdź token i nagłówek Authorization: Bearer ....
  • Połączenie nie powiodło się: Sprawdź bazowy URL, port, dostęp do sieci i zaufanie do certyfikatu.
  • Brakuje niektórych odczytów: Przejrzyj wybrany dzień, źródła i dzienniki aktywności. Uruchomienie może zaktualizować niektóre encje, podczas gdy inne się nie powiodą.

Otwórz automatyzację i wybierz Pokaż dzienniki aktywności, aby sprawdzić nieudane kroki. W sprawie wsparcia zobacz Uzyskaj pomoc.