Планирование и проверка типов данных Health Connect

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

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

Категории типов данных

Health Connect поддерживает типы данных, используемые в большинстве приложений для здоровья и фитнеса, чтобы обеспечить максимальное разнообразие. Health Connect стремится обеспечить комплексное представление и хранение данных о здоровье и фитнесе. Эти типы данных делятся на следующие категории:

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

Формат типа данных

Типы данных в Health Connect хранятся в объектах, которые являются подклассами Record .

Для каждого типа данных существуют связанные поля, которые являются либо общими, например, time и zoneOffset , либо специфическими, например, title , count и percentage . Некоторые поля используют простые типы, например, long , double или string , в то время как другие используют сложные типы, например, перечисления и классы, например, Instant и ZoneOffset . Атрибуты этих полей могут быть обязательными или необязательными. Некоторые атрибуты доступны только для чтения, а некоторые ограничены определённым диапазоном значений.

Полный список доступных типов данных и их полей смотрите в классах в Jetpack .

Дополнительные атрибуты данных

Данные в API Health Connect также включают атрибуты метаданных , описанные в следующем списке:

• Идентификатор Health Connect: Каждой точке данных при создании присваивается уникальный идентификатор (UID). Это полезно для стандартных операций чтения и записи. Подробнее см. в разделе «Идентификатор Health Connect» .
• Время последнего изменения: это метка времени последнего обновления записи. Она автоматически генерируется при первом создании записи или при каждом её обновлении.
• Источник данных: Health Connect хранит информацию о приложении, откуда были получены данные. В нём содержится имя пакета этого источника, которое автоматически добавляется при создании.
• Устройство: Health Connect хранит информацию об устройстве, с которого были получены данные. В ней указаны производитель и модель устройства, значения которых вы вводите вручную.
• Идентификатор клиента: Health Connect предоставляет идентификаторы клиентов, чтобы клиентские приложения могли обращаться к данным, используя собственные идентификаторы. Это помогает разрешать конфликты и упрощает синхронизацию. Эти идентификаторы добавляются в запись вручную.
• Версия записи клиента: Наряду с идентификатором клиента, Health Connect обеспечивает управление версиями для отслеживания изменений во время синхронизации данных. Эта информация добавляется в запись вручную.
• Метод записи: Health Connect позволяет понять, как записываются данные. Эти методы включают пассивную (автоматическую) запись данных приложениями и активную (ручную) запись данных пользователями.

Идентификатор Health Connect

Health Connect присваивает уникальные идентификаторы (UID) новым добавленным объектам данных, которые идентифицируют объекты данных и отличают их от других. Идентификаторы Health Connect полезны в запросах на чтение и запись. Идентификаторы Health Connect не идентичны идентификаторам клиента. Клиентское приложение назначает идентификаторы клиента, в то время как Health Connect назначает их исключительно сам.

При работе с идентификаторами Health Connect помните о следующих моментах:

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

Время в Health Connect

Все данные, записываемые в Health Connect, должны содержать информацию о смещении часового пояса. Указание смещения часового пояса позволяет приложениям считывать данные и отображать их в гражданском времени. Гражданское время — это местное время, актуальное для пользователя, но не обязательно в формате UTC.

В редких случаях смещение часового пояса может быть недоступно. В таких случаях в Android 14 (API уровня 34) Health Connect устанавливает смещение часового пояса на основе системного часового пояса устройства по умолчанию. В Android 13 и более ранних версиях (API уровня 33 и ниже) можно записывать данные в Health Connect без указания смещения часового пояса, чего следует по возможности избегать.

Настройка времени и пояса

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

Разрешения

Прежде чем запрашивать какие-либо разрешения, ваше приложение должно сначала объявить их в манифесте. Полное сопоставление типов данных и их разрешений см. в таблицах ниже.

Для 1.0.0-альфа10 и выше

Для 1.0.0-alpha09 и ниже

Проверьте свои типы данных и разрешения

Теперь, когда вы спланировали типы данных и разрешения, вы можете реализовать их в процессе разработки .

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

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