Синхронізація даних Apple Health із MQTT

Публікуйте експорти здоров’я як JSON у тему на вашому брокері MQTT.

Важливо — обмеження автоматизацій: Пристрій має бути розблоковано для читання даних про здоров’я, і iOS не гарантує фонові запуски з вибраною частотою. Перегляньте Обмеження автоматизацій перед покладанням на автоматичні експорти.

Відкриття автоматизації

Відкрийте Експорт → Автоматизовано на iPhone або Автоматизації на бічній панелі iPad. Виберіть Нова автоматизація або відкрийте наявну автоматизацію для редагування.

Назва, стан і сповіщення

Введіть назву, яка ідентифікує цю автоматизацію. Увімкнено дозволяє автоматичні запуски; залиште вимкненим, доки не будете готові.

Виберіть потрібні сповіщення про запуск:

• Сповіщати про оновлення кешу повідомляє, що дані експорту підготовлено.
• Сповіщати про запуск повідомляє про успішну публікацію на брокер.

Дозвольте сповіщення, коли запропоновано. Ці сповіщення повідомляють про активність; вони не планують запуск.

Налаштування підключення

1. Виберіть MQTT як Тип автоматизації.
2. Введіть ім’я хоста або IP-адресу брокера та порт. Порт за замовчуванням — 1883.
3. Введіть Тему, наприклад health/metrics.
4. Встановіть унікальний Client ID для кожної автоматизації та введіть ім’я користувача й пароль, якщо брокер цього вимагає.

Брокер має бути доступним з пристрою. Підписники мають використовувати точну тему, включно з регістром. Повторне використання Client ID може призвести до заміни з’єднань брокера одне одним.

Параметри типу даних

Виберіть один Тип даних для цієї автоматизації: Показники здоров’я, Тренування, Симптоми, ECG, Сповіщення про частоту серцевих скорочень, Стан розуму, Відстеження циклу або Ліки. Стан розуму потребує iOS 18 або новішої; Ліки потребують iOS 26 або новішої та окремого доступу до ліків.

Показники здоров’я

Виберіть Показники здоров’я, потім відкрийте Вибрати показники здоров’я і виберіть потрібні вимірювання.

Щоб обмежити значення певними застосунками або пристроями, відкрийте Бажані джерела, виберіть показник і його джерела. Усі дозволяє кожне джерело, яке не виключено. Використовуйте Виключені джерела, щоб ігнорувати джерело в показниках здоров’я цієї автоматизації. Виключення мають пріоритет; невибране джерело не підставляється, коли бажане джерело не має даних. Виберіть Зберегти, щоб застосувати вибір джерел, або Скасувати, щоб відхилити.

Тренування

Виберіть Тренування, щоб експортувати записи тренувань. Включити дані маршруту додає доступні точки маршруту до JSON-даних тренування. Окремі GPX-завантаження не створюються.

Для Версії 2 увімкніть Включити показники тренування, щоб додати значення, наприклад частоту серцевих скорочень, активну енергію та кроки. Виберіть Хвилини або Секунди для Групування часу показників тренування; секунди дають більше деталей і більші експорти. Версія 1 завжди включає показники тренування.

Параметри експорту

MQTT публікує лише JSON. Повідомлення використовують QoS 0 для публікації на передньому плані та QoS 1 для фонової публікації. Повідомлення не зберігаються (not retained).

Версія експорту

Виберіть Версію 2 для поточної структури даних. Використовуйте Версію 1, коли наявний робочий процес залежить від старішого формату.

Діапазон дат

Вибір	Включені дані
За замовчуванням	Попередній день і сьогодні до часу запуску
З останньої синхронізації	З попередньої синхронізації до часу запуску
Сьогодні	Сьогодні до часу запуску
Вчора	Попередній повний день
Попередні 7 днів	Попередні сім повних днів

Узагальнити дані та групування часу

Для JSON + Показники здоров’я увімкніть Узагальнити дані, щоб об’єднати значення в групи часу, або вимкніть для окремих значень, де доступно. Узагальнення залежить від показника — наприклад, кроки підсумовуються, а значення ваги усереднюються. CSV-експорти показників здоров’я використовують узагальнені дані.

Коли доступне Групування часу, виберіть, скільки деталей зберігати. Годинні або денні групи створюють менше рядків, ніж хвилинні або секундні. Доступні варіанти залежать від діапазону дат і формату. Групування часу тренувань налаштовується окремо в Тренуваннях.

Планування нагадувань

Якщо потрібне нагадування розблокувати та відкрити застосунок, увімкніть Увімкнути нагадування. Виберіть Щогодини, Щодня або Вибрані дні, потім встановіть хвилину, час і дні за потреби. Дозвольте доступ до сповіщень, коли запропоновано; якщо відхилено, використайте Відкрити параметри сповіщень.

Нагадування не запускає автоматизацію і не підтверджує успішну синхронізацію. Торкніться, щоб відкрити автоматизацію, або використайте Відкрити та синхронізувати на сповіщенні, щоб запросити запуск. Автоматизація має бути увімкнена; нагадування може все ще з’явитися після успішного фонового запуску. Зміни нагадувань набувають чинності під час збереження.

Частота синхронізації та збереження

Виберіть число та Хвилини, Години, Дні або Тижні в Частоті синхронізації — наприклад, кожні 15 хвилин. Це бажана фонова частота, а не гарантований розклад.

Пристрій має бути розблоковано під час читання даних про здоров’я. Увімкніть Оновлення програм у фоні для Health Auto Export і вимкніть режим енергозбереження для автоматичних запусків. iOS все ще може затримувати запуски, коли пристрій неактивний або системні ресурси обмежені.

Увімкніть Увімкнено, коли готові до автоматичних запусків, потім виберіть Оновити, щоб зберегти автоматизацію. Ви можете одразу завантажити вибраний діапазон дат за кроками нижче.

Експорт історичних або пропущених даних

Використовуйте Завантаження вручну, коли вперше налаштовуєте автоматизацію для експорту історичних даних, або пізніше, щоб покрити дати, пропущені автоматичною синхронізацією. Також можна використати для перевірки налаштування.

1. Підключіть підписника MQTT до брокера та підпишіться на налаштовану тему.
2. У Health Auto Export відкрийте автоматизацію та виберіть Завантаження вручну в Експортувати наявні дані.
3. Встановіть дати Початок і Кінець, потім виберіть Почати експорт.
4. Перевірте отриманий JSON і його дати.

Корисне навантаження відповідає формату експорту JSON. Наприклад:

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

Усунення несправностей

• З’єднання не вдалося: Перевірте хост, порт, мережевий доступ і вимоги до підключення брокера.
• Автентифікація не вдалася: Перевірте облікові дані та дозвіл публікувати в тему.
• Немає повідомлення: Підтвердьте, що підписник використовує той самий брокер і точну тему, потім перегляньте журнали активності.
• Повідомлення занадто велике: Виберіть менше показників, коротший діапазон або грубше групування часу.

Відкрийте автоматизацію та виберіть Переглянути журнали активності, щоб переглянути запуск. Попередження позначають потенційні проблеми, наприклад повільне отримання даних; помилки визначають невдалі кроки. Для допомоги зі звітом про проблему див. Отримання допомоги.