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

Публикуйте показатели здоровья в Home Assistant как отдельные состояния сущностей. Это назначение поддерживает только показатели здоровья.

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

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

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

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

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

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

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

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

Подключение Home Assistant

1. Выберите Home Assistant как Тип автоматизации.
2. Введите базовый URL вашего экземпляра Home Assistant, например http://homeassistant.local:8123.
3. Создайте Long-Lived Access Token в профиле Home Assistant.
4. В HTTP-заголовки добавьте Authorization со значением Bearer YOUR_LONG_LIVED_ACCESS_TOKEN.

Экземпляр Home Assistant должен быть доступен с iPhone или iPad. Для HTTPS используйте сертификат, которому доверяет устройство.

Настройки показателей здоровья

Откройте Выберите показатели здоровья и выберите показания для публикации.

Откройте Предпочтительные источники, чтобы выбрать источники для каждой метрики. Используйте Все для всех неисключённых источников или Исключенные источники, чтобы игнорировать источник во всей этой автоматизации. Исключения имеют приоритет, и невыбранные источники не заменяют предпочтительный источник без данных. Выберите Сохранить, чтобы применить выбор, или Отмена, чтобы отменить.

Настройки экспорта

Home Assistant использует свой формат состояния сущности JSON; выбора формата файла или версии экспорта нет.

Диапазон дат

• По умолчанию: Включает предыдущий день и сегодня до времени запуска.
• Сегодня: Включает сегодня до времени запуска.
• Вчера: Включает предыдущий полный день.

Группировка по времени

Выберите По умолчанию, чтобы оставить показания несгруппированными, или Дни для ежедневных сводок. У Home Assistant нет переключателя Суммировать данные.

Напоминания о расписании

Если нужен запрос разблокировать и открыть приложение, включите Включить напоминания. Выберите Почасово, Каждый день или Выбранные дни, затем задайте минуту, время и дни по необходимости. Разрешите доступ к уведомлениям, когда будет предложено; если доступ отклонён, используйте Открыть настройки уведомлений.

Напоминание не запускает автоматизацию и не подтверждает успешную синхронизацию. Нажмите его, чтобы открыть автоматизацию, или используйте Открыть и синхронизировать в уведомлении, чтобы запросить запуск. Автоматизация должна быть включена; напоминание может появиться и после успешного фонового запуска. Изменения напоминаний применяются при сохранении.

Частота синхронизации и сохранение

Выберите число и Минуты или Часы в Частота синхронизации. Это желаемый фоновый ритм, а не гарантированное расписание.

Устройство должно быть разблокировано при чтении данных о здоровье. Включите фоновое обновление приложений для Health Auto Export и отключите Режим энергосбережения для автоматических запусков. iOS всё равно может откладывать запуски, когда устройство было неактивно или системные ресурсы ограничены.

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

Опубликованные сущности

Каждая выбранная метрика может создать одну или несколько сущностей. Идентификатор начинается с hae., затем имя автоматизации в нижнем регистре без пробелов, затем метрика и любое имя компонента.

Например, автоматизация с именем Health Metrics может публиковать шаги по адресу:

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

Состояние — последнее показание за выбранный день, с атрибутами единицы измерения. Метрики вроде артериального давления и пульса используют отдельные сущности компонентов.

Когда за день нет данных, итоги вроде шагов и часов стояния публикуют 0. Другие показания, такие как вес или пульс, не обновляются, пока данные не появятся, поэтому Home Assistant может продолжать показывать последнее полученное значение. Рано утром итоги могут оставаться 0, пока данные Watch не достигнут iPhone.

Экспорт исторических или пропущенных данных

Используйте Ручная загрузка при первой настройке автоматизации для экспорта исторических данных или позже, чтобы покрыть даты, пропущенные автоматической синхронизацией. Также можно использовать его для проверки настройки.

1. Откройте автоматизацию и выберите Ручная загрузка в Экспортировать существующие данные.
2. Задайте даты Начало и Окончание, затем выберите Начать экспорт.
3. В Home Assistant откройте Developer Tools → States и найдите префикс hae. вашей автоматизации.
4. Проверьте значения сущностей и время обновления.

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

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

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