Синхронізація даних 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 відкрийте Інструменти розробника → Стани і знайдіть префікс hae. вашої автоматизації.
4. Перевірте значення сутностей і час оновлення.

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

• Помилка автентифікації: Перевірте маркер і заголовок Authorization: Bearer ....
• З’єднання не вдалося: Перевірте базову URL-адресу, порт, мережевий доступ і довіру до сертифіката.
• Деякі значення відсутні: Перегляньте вибраний день, джерела та журнали активності. Запуск може оновити деякі сутності, тоді як інші зазнають невдачі.

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