На этой странице описаны основные функции API Health Connect.
CRUD-операции по синхронизации записей и данных
Платформа предоставляет стандартные функции добавления, обновления и удаления записанных данных. Health Connect также включает в себя функцию, позволяющую клиентским приложениям синхронизировать данные из Health Connect. Это позволяет создавать журнал изменений данных, который показывает разработчику и пользователю, были ли определённые типы данных добавлены или удалены другими приложениями.
Базовые функции агрегации
Клиенты могут применять функцию агрегации к базовым данным, обеспечивая следующее:
- Среднее, минимальное или максимальное значения (например, минимальная и максимальная частота сердечных сокращений во время сеанса активности).
- Общая сумма (например, общее количество шагов за дневной интервал).
- Простой подсчет количества базовых измерений (например, количества сеансов активности за определенную неделю).
- Общая продолжительность поддерживаемых типов данных (например, время, проведенное в фазе глубокого сна на этой неделе, или общая продолжительность сеансов активности сегодня).
Проверка доступности
Health Connect совместим с Android SDK версии 28 (Pie) и выше. SDK позволяет клиентским приложениям определять, есть ли API Health Connect на устройстве пользователя Android. Если API отсутствует, Health Connect запускает проверку доступности, чтобы определить совместимость устройства пользователя.
Проверки разрешений
Health Connect требует, чтобы вы запросили у пользователя разрешение на чтение и запись данных о его здоровье и физической форме для каждого приложения. Кроме того, приложение позволяет увидеть, какие разрешения уже были предоставлены или отозваны пользователем.
Чтение с Health Connect
Чтение на переднем плане
Обычно вы можете читать данные из Health Connect, когда ваше приложение находится в активном режиме. В таких случаях вы можете использовать службу активного режима для выполнения этой операции, если пользователь или система переведут ваше приложение в фоновый режим во время операции чтения.
В ситуациях, когда ваше приложение может ожидать прерывания работы, например при отображении показаний в вашем приложении, считывайте данные непосредственно из Health Connect в ваше клиентское приложение.
В ситуациях, когда вы предпочитаете, чтобы ваше приложение работало без перебоев, используйте службу переднего плана :
FOREGROUND_SERVICE_TYPE_HEALTH: позволяет приложению оставаться на переднем плане для сбора данных датчиков, например, приложению для тренировок, которое продолжает собирать данные, даже если пользователь переводит приложение в фоновый режим.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: служба общего типа, которая позволяет приложению продолжать собирать критически важные данные для задач, которые занимают менее трех минут, даже если пользователь переводит приложение в фоновый режим до его завершения.
Фоновое чтение
Вы можете запросить запуск своего приложения в фоновом режиме и чтение данных из Health Connect. Если вы запросите разрешение на фоновое чтение , ваш пользователь сможет предоставить приложению доступ к чтению данных в фоновом режиме.