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

Szukaj tematów pomocy

Synchronizuj dane Apple Health z MQTT

Publikuj dane zdrowotne na brokerze MQTT.

Ostatnia aktualizacja: 31 października 2026

Na tej stronie
Otwórz automatyzacjęNazwa, stan i powiadomieniaSkonfiguruj połączenie
Ustawienia typu danych Ustawienia typu danych Metryki zdrowiaTreningi
Ustawienia eksportu Ustawienia eksportu Wersja eksportuZakres datSumuj dane i grupowanie czasu
Planuj przypomnieniaCzęstotliwość synchronizacji i zapisEksportuj dane historyczne lub pominięteRozwiązywanie problemów

Publikuj eksporty zdrowia jako JSON w temacie na brokerze MQTT.

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ę na brokerze.

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

Skonfiguruj połączenie

  1. Wybierz MQTT jako Typ automatyzacji.
  2. Podaj nazwę hosta lub adres IP brokera oraz port. Domyślny port to 1883.
  3. Podaj Temat, na przykład health/metrics.
  4. Ustaw unikalne ID klienta dla każdej automatyzacji i podaj nazwę użytkownika oraz hasło, jeśli broker tego wymaga.

Broker musi być osiągalny z urządzenia. Subskrybenci muszą używać dokładnego tematu, włącznie z wielkością liter. Ponowne użycie ID klienta może spowodować, że połączenia brokera będą się wzajemnie zastępować.

Ustawienia typu danych

Wybierz jeden Typ danych dla tej automatyzacji: Metryki zdrowia, Treningi, Objawy, EKG, Powiadomienia o tętnie, Stan umysłu, Śledzenie cyklu lub Leki. Stan umysłu wymaga iOS 18 lub nowszego; Leki wymagają iOS 26 lub nowszego oraz osobnego dostępu do leków.

Metryki zdrowia

Wybierz Metryki zdrowia, a następnie otwórz Wybierz metryki zdrowia i wybierz potrzebne pomiary.

Aby ograniczyć odczyty do konkretnych aplikacji lub urządzeń, otwórz Preferowane źródła, wybierz metrykę i wybierz jej źródła. Wszystkie zezwala na każde źródło, które nie zostało wykluczone. Użyj Wykluczone źródła, aby ignorować źródło we wszystkich metrykach zdrowia tej automatyzacji. Wykluczenia mają pierwszeństwo; niewybrane źródło nie jest podstawiane, gdy preferowane źródło nie ma danych. Wybierz Zapisz, aby zastosować wybór źródeł, albo Anuluj, aby go odrzucić.

Treningi

Wybierz Treningi, aby eksportować rekordy treningów. Uwzględnij dane trasy dodaje dostępne punkty trasy do danych treningu JSON. Nie tworzy osobnych przesłań GPX.

Dla Wersji 2 włącz Uwzględnij metryki treningu, aby dodać odczyty takie jak tętno, aktywna energia i kroki. Wybierz Minuty lub Sekundy dla Grupowania czasu metryk treningu; sekundy dają więcej szczegółów i większe eksporty. Wersja 1 zawsze uwzględnia metryki treningu.

Ustawienia eksportu

MQTT publikuje wyłącznie JSON. Wiadomości używają QoS 0 przy publikacji na pierwszym planie i QoS 1 przy publikacji w tle. Wiadomości nie są zatrzymywane (retained).

Wersja eksportu

Wybierz Wersję 2 dla bieżącej struktury danych. Użyj Wersji 1, gdy istniejący przepływ pracy zależy od starszego formatu.

Zakres dat

Wybór Uwzględnione dane
Domyślny Poprzedni dzień oraz dziś do chwili uruchomienia
Od ostatniej synchronizacji Od poprzedniej synchronizacji do chwili uruchomienia
Dziś Dziś do chwili uruchomienia
Wczoraj Poprzedni pełny dzień
Poprzednie 7 dni Poprzednie siedem pełnych dni

Sumuj dane i grupowanie czasu

Dla JSON + Metryki zdrowia włącz Sumuj dane, aby łączyć odczyty w grupy czasu, albo wyłącz, aby uzyskać poszczególne odczyty, gdy są dostępne. Podsumowanie zależy od metryki — na przykład kroki są sumowane, a odczyty wagi uśredniane. Eksporty CSV metryk zdrowia używają danych zsumowanych.

Gdy dostępne jest Grupowanie czasu, wybierz, ile szczegółów zachować. Grupy godzinowe lub dzienne dają mniej wierszy niż minutowe lub sekundowe. Dostępne wybory zależą od zakresu dat i formatu. Grupowanie czasu treningów konfiguruje się osobno w Treningach.

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, Godziny, Dni lub Tygodnie w Częstotliwość synchronizacji — na przykład co 15 minut. 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.

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. Połącz subskrybenta MQTT z brokerem i zasubskrybuj skonfigurowany temat.
  2. W Health Auto Export otwórz automatyzację i wybierz Przesyłanie ręczne w Eksportuj istniejące dane.
  3. Ustaw daty Początek i Koniec, a następnie wybierz Rozpocznij eksport.
  4. Sprawdź otrzymany JSON i jego daty.

Ładunek jest zgodny z formatem eksportu JSON. Na przykład:

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

Rozwiązywanie problemów

  • Połączenie nie powiodło się: Sprawdź host, port, dostęp do sieci i wymagania połączenia brokera.
  • Uwierzytelnianie nie powiodło się: Sprawdź poświadczenia i uprawnienie do publikacji w temacie.
  • Brak wiadomości: Potwierdź, że subskrybent używa tego samego brokera i dokładnego tematu, a następnie przejrzyj dzienniki aktywności.
  • Wiadomość za duża: Wybierz mniej metryk, krótszy zakres lub grubsze grupowanie czasu.

Otwórz automatyzację i wybierz Pokaż dzienniki aktywności, aby przejrzeć uruchomienie. Ostrzeżenia oznaczają potencjalne problemy, takie jak wolne pobieranie danych; błędy identyfikują nieudane kroki. W sprawie zgłoszenia problemu zobacz Uzyskaj pomoc.