Обзорное руководство по автоматизациям

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

Обзор

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

Преимущества:

• Автоматическое резервное копирование и синхронизация данных
• Не требуется ручное вмешательство
• Настраиваемая частота синхронизации
• Несколько типов автоматизаций для разных сценариев
• Работа в фоне (приложение не обязательно должно быть открыто)

Сценарии использования:

• Автоматическое облачное резервное копирование
• Интеграция с системами умного дома
• API-интеграции для пользовательских приложений
• Платформы анализа и визуализации данных
• Обмен данными о здоровье с медицинскими учреждениями

Ограничения:

• Доступ к данным о здоровье: Приложениям запрещён доступ к данным о здоровье, пока iPhone заблокирован. Автоматизации выполняются только в периоды, когда устройство разблокировано. Это ограничение Apple, его нельзя обойти. Подробнее
• Фоновая обработка: iOS ограничивает фоновую обработку для экономии заряда батареи. Автоматизации зависят от фонового обновления приложений и могут не запускаться сразу, если:
  • для приложения отключено фоновое обновление приложений
  • устройство в режиме энергосбережения
  • устройство длительное время неактивно
  • системные ресурсы ограничены
  • несколько приложений конкурируют за время фонового выполнения
• Планирование: В связи с фоновой обработкой iOS также не позволяет приложениям работать в фоне в заданное время. Это означает, что даже при установке определённого интервала синхронизации автоматизации не гарантированно запустятся точно в указанное время. Устройство должно быть разблокировано, и iOS определит, когда автоматизация выполнится в фоне. Автоматизации также можно запустить вручную следующими способами:
  • Виджет автоматизаций: нажмите значок виджета, чтобы запустить автоматизацию
  • Команды — Выполнить автоматизацию: используйте действие Выполнить автоматизацию, чтобы запустить настроенную автоматизацию (см. Расписание через «Команды»)
  • Ручной запуск в приложении: откройте автоматизацию в Health Auto Export и выполните Ручной экспорт
• Синхронизация на переднем плане: Пока Health Auto Export открыт на переднем плане, подходящие автоматизации могут снова выполняться с регулярным интервалом (примерно каждые 60 секунд). Устройство остаётся активным при использовании на переднем плане, поэтому синхронизация может продолжаться. Цикл на переднем плане приостанавливается только при достижении устройством критического теплового состояния; при более тёплых (некритических) условиях синхронизация на переднем плане всё ещё возможна. Ограничения фонового планирования выше по-прежнему действуют, когда приложение не на переднем плане.

Производительность

Имейте в виду, что iOS оптимизирован для кратковременных задач на мобильном устройстве с очень строгими ограничениями производительности. Фоновые задачи обычно должны завершиться в течение 30 секунд и ограничены по объёму памяти. Health Auto Export предлагает высокую гибкость и настраиваемость, поэтому важно понимать, как определённые конфигурации влияют на производительность приложения и результаты.

• Конфигурация: Автоматизации, создающие большие объёмы данных, могут привести к завершению процесса системой, и автоматизации перестанут работать в фоне. Следующие конфигурации могут создавать большие объёмы данных:
  • Автоматизации, настроенные на экспорт всех показателей здоровья.
    • Рекомендация: выбирайте только показатели здоровья, для которых в Apple Health есть сохранённые данные, и только те данные, которые вы действительно планируете использовать. Даже пустые типы данных влияют на производительность. Можно также разделить выбранные показатели между несколькими автоматизациями — это облегчает обработку для системы.
  • Автоматизации с группировкой по времени в секундах или минутах или с отключённым суммированием данных. Такие детальные запросы могут долго выполняться и сталкиваться с системными ограничениями.
    • Рекомендация: хотя кажется идеальным иметь максимально подробные данные, подумайте, нужен ли такой уровень детализации для каждого показателя или типа данных. Рассмотрите несколько автоматизаций с разными настройками.
  • При экспорте тренировок на открытом воздухе, таких как велосипед, бег, походы и т. п. с данными маршрута, GPS и связанные показатели здоровья могут создавать большие объёмы данных.
• Размер данных: Особенно при экспорте через REST API учитывайте, что большие объёмы данных могут вызывать ошибки сервера. Убедитесь, что ваш бэкенд настроен на обработку объёмов данных, возможно, в несколько сотен мегабайт.
• Частота синхронизации: Добавьте виджет автоматизаций на главный экран, чтобы автоматизации надёжнее работали в фоне (см. Руководство по настройке виджета автоматизаций).

Доступные типы автоматизаций

Health Auto Export поддерживает несколько типов автоматизаций, каждый из которых предназначен для определённых сценариев:

REST API

Отправка данных о здоровье в любой веб-сервис, принимающий HTTP POST-запросы. Идеально для пользовательских серверов, вебхуков и сторонних API.

Руководство: Руководство по автоматизации REST API

Home Assistant

Синхронизация показателей здоровья с Home Assistant в виде состояний датчиков. Отлично подходит для интеграции данных о здоровье в автоматизации умного дома.

Руководство: Руководство по автоматизации Home Assistant

MQTT

Публикация данных о здоровье в MQTT-брокер. Подходит для IoT-платформ и систем на базе MQTT.

Руководство: Руководство по автоматизации MQTT

Dropbox

Автоматическое резервное копирование данных о здоровье в Dropbox. Файлы организованы в папках и доступны с любого устройства.

Руководство: Руководство по автоматизации Dropbox

Google Drive

Автоматическое резервное копирование данных о здоровье в Google Drive. CSV-файлы можно преобразовать в Google Таблицы для удобного просмотра.

Руководство: Руководство по автоматизации Google Drive

iCloud Drive

Сохранение данных о здоровье непосредственно в iCloud Drive. Простая настройка без аутентификации.

Руководство: Руководство по автоматизации iCloud Drive

Календарь

Создание событий календаря на основе ваших данных о здоровье. Визуализация тренировок, вех здоровья и других событий в календаре.

Руководство: Руководство по автоматизации Календаря

Создание первой автоматизации

1. Перейдите на экран «Автоматические экспорты» из главной навигации
2. Нажмите «Новая автоматизация»
3. Выберите тип автоматизации
4. Настройте параметры, специфичные для автоматизации (см. отдельные руководства)
5. Настройте общие параметры (тип данных, частота синхронизации и т. д.)
6. Нажмите «Обновить» для сохранения
7. Включите автоматизацию

Резервное копирование и восстановление автоматизаций

Health Auto Export может создавать резервную копию настроек автоматизаций в iCloud Drive, чтобы вы могли восстановить их на новом устройстве или после переустановки приложения. Это отдельно от данных о здоровье, которые экспортируют ваши автоматизации.

• Где хранятся резервные копии: Настройки автоматизаций сохраняются как JSON-файлы в iCloud Drive в папке Auto Export/Automations (видно в приложении «Файлы»).
• Когда создаётся резервная копия: Каждый раз, когда вы сохраняете автоматизацию (нажимая Обновить или покидая экран редактирования), автоматизация автоматически резервируется.
• Включение или отключение: Откройте список автоматизаций и перейдите в Настройки автоматизации, затем используйте Резервное копирование в iCloud Drive. По умолчанию включено. При отключении вас спросят, удалить ли существующие файлы резервной копии из iCloud Drive — автоматизации останутся на устройстве в любом случае.

Восстановление

Если вы откроете «Автоматические экспорты» и ещё не имеете автоматизаций, но в iCloud Drive есть резервные копии, появится кнопка Восстановить из iCloud Drive. Нажав её, вы вернёте свои автоматизации.

Несколько моментов после восстановления:

• Повторно подключите учётные записи: В целях конфиденциальности токены входа для сервисов вроде Dropbox и Google Drive не входят в резервные копии. После восстановления снова подключите эти сервисы в каждой автоматизации.
• Снова включите автоматизации: Восстановленные автоматизации начинают как отключённые, чтобы ничего не запустилось неожиданно с устаревшими настройками. Просмотрите каждую и включите, когда будете готовы.
• Частичное восстановление: Если некоторые автоматизации нельзя восстановить (например, файл ещё не загружен, ключ шифрования ещё недоступен или автоматизация создана более новой версией приложения), остальные всё равно восстанавливаются, и вы увидите, какие пропущены.

Примечание: Заголовки запросов и учётные данные, которые вы ввели в автоматизацию (например, пароль MQTT), зашифрованы в файлах резервной копии iCloud Drive. Восстановление на новом устройстве требует iCloud Keychain, чтобы приложение могло их расшифровать. Файлы, которыми вы поделились или экспортировали вручную, остаются незашифрованным обычным JSON.

Журналы активности

У каждой автоматизации есть журналы активности с историей её запусков.

1. Откройте автоматизацию и нажмите Просмотреть журналы активности.
2. События сгруппированы по запуску (сначала самые новые). Разверните запуск, чтобы увидеть отдельные события.
3. Предупреждения (например, медленный запрос данных о здоровье) означают, что запуск завершён, но один из шагов занял дольше ожидаемого. Ошибки означают, что шаг не выполнен (загрузка, чтение HealthKit, аутентификация и т. п.).
4. Очистить (панель инструментов) удаляет только историю активности этой автоматизации, а не общие диагностические журналы приложения.
5. Поделиться (панель инструментов) экспортирует полный диагностический ZIP App Event Logs — тот же пакет, что и Настройки → Дополнительно → Экспорт журналов событий. См. Руководство по журналам событий приложения.

Медленные запросы в журналах активности

• Если автоматизация долго получает данные о здоровье, в журналах активности могут появиться предупреждения медленный запрос данных о здоровье, а не ошибки.
• Чтобы ускорить запуски: выберите меньше показателей здоровья, используйте более короткий диапазон дат, включите Суммировать данные и выберите более крупную Группировку по времени (часы, дни или недели).
• Автоматизации в реальном времени по замыслу используют более мелкую группировку и могут чаще регистрировать предупреждения о медленных запросах.

Предупреждение настроек экспорта

При настройке автоматизации показателей здоровья (не Home Assistant) под Настройками экспорта может отображаться примечание, если конфигурация может работать медленно:

• Суммировать данные выключено или группировка по времени — минуты или секунды, и
• выбрано более 10 показателей здоровья

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

Рекомендации

1. Автоматическая синхронизация:

• Заряжайте устройство и используйте «Зеркалирование iPhone»
  • При зарядке iOS меньше ограничивает производительность, поэтому данные могут синхронизироваться чаще
  • При зеркалировании iPhone устройство ведёт себя так же, как при разблокировке, и Health Auto Export может получать данные о здоровье для автоматических действий

2. Частота синхронизации:

• Баланс между актуальностью данных и использованием ресурсов
• Ежедневная синхронизация подходит для большинства сценариев
• Более частая синхронизация для задач в реальном времени
• Реже — для сводных данных

3. Выбор данных:

• Выбирайте только нужные показатели
• Сокращает время обработки и объём данных
• Рассмотрите отдельные автоматизации для разных групп показателей

4. Тестирование:

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

5. Мониторинг:

• Регулярно просматривайте журналы активности
• Проверяйте индикаторы состояния автоматизаций
• Настройте уведомления для важных автоматизаций
• Проверяйте получение данных в назначении

6. Безопасность:

• Используйте надёжные методы аутентификации
• Обновляйте учётные данные
• Используйте HTTPS/TLS, когда доступно
• Проверяйте настройки конфиденциальности

7. Производительность:

• Используйте подходящую группировку по времени
• Учитывайте настройки диапазона дат для облачного хранилища
• Следите за расходом батареи и трафика
• Просматривайте журналы активности на предупреждения о медленных запросах

8. Стратегия резервного копирования:

• Используйте несколько типов автоматизаций для избыточности
• Сочетайте облачное хранилище с API-интеграциями
• Сохраняйте локальные резервные копии, когда возможно
• Проверяйте процедуры восстановления

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

• Сначала проверьте журналы активности
• Проверьте сетевое подключение
• Проверьте учётные данные
• См. отдельные руководства по автоматизациям для конкретных проблем

Виджет автоматизаций

Добавьте виджет «Автоматизации» на главный экран, чтобы:

• видеть состояние автоматизаций с первого взгляда
• запускать автоматизации вручную
• оптимизировать фоновые загрузки

Получение помощи

Если нужна помощь с конкретным типом автоматизации:

1. Обратитесь к соответствующему руководству по автоматизации
2. Проверьте журналы активности на сообщения об ошибках
3. Изучите разделы устранения неполадок
4. Обратитесь в службу поддержки, если проблема сохраняется