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

Публикуйте экспорты о здоровье как JSON в тему на вашем MQTT-брокере.

Важно — ограничения автоматизаций: Устройство должно быть разблокировано для чтения данных о здоровье, и iOS не гарантирует фоновые запуски с выбранной частотой. Изучите Ограничения автоматизаций, прежде чем полагаться на автоматические экспорты.

Открытие автоматизации

Откройте Экспорт → Автоматизация на iPhone или Автоматизации в боковой панели iPad. Выберите Новая автоматизация или откройте существующую автоматизацию для редактирования.

Имя, статус и уведомления

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

Выберите любые уведомления о запуске, которые хотите:

• Уведомлять при обновлении кэша сообщает, что данные экспорта подготовлены.
• Уведомлять при запуске сообщает об успешной публикации на брокер.

Разрешите уведомления, когда будет предложено. Эти уведомления сообщают об активности; они не планируют запуск.

Настройка соединения

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

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

Настройки типа данных

Выберите один Тип данных для этой автоматизации: Показатели здоровья, Тренировки, Симптомы, ЭКГ, Уведомления о пульсе, Состояние разума, Отслеживание цикла менструации или Лекарства. Состояние разума требует 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}]
      }
    ]
  }
}

Устранение неполадок

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

Откройте автоматизацию и выберите Смотреть журналы активности, чтобы просмотреть запуск. Предупреждение отмечает потенциальные проблемы, такие как медленное получение данных; Ошибки: указывают на неудачные шаги. За помощью в сообщении о проблеме см. Получение помощи.