Health Connect хранит и структурирует как данные о здоровье и физической активности, так и данные медицинских карт. Важно сначала понять, какие типы данных и права доступа предоставляет Health Connect, чтобы вы могли спланировать требования к своему приложению.
После завершения разработки, при подготовке к публикации приложения в Play Store, необходимо указать, какие данные использует приложение, а также предоставить доступ к типам данных Health Connect, которые оно использует. В противном случае пользователи могут получить сообщение об ошибке, указывающее на невозможность доступа приложения к типам данных Health Connect из-за необходимости специального разрешения.
Дополнительную информацию см. в разделе «Заполните декларацию медицинских приложений в консоли Play» .
Категории типов данных
Health Connect поддерживает типы данных, используемые в большинстве приложений для здоровья и фитнеса, чтобы обеспечить максимальное разнообразие. Цель Health Connect — предоставить всесторонний обзор и хранение данных о здоровье и фитнесе. Эти типы данных делятся на следующие категории:
| Категория | Описание | |
|---|---|---|
| directions_run | Активность | Это позволяет фиксировать любую активность пользователя. Сюда могут входить занятия, связанные со здоровьем и фитнесом, такие как бег и плавание. |
| выпрямить | Параметры тела | Это позволяет собирать общие данные, касающиеся организма, такие как вес пользователя и его основной обмен веществ. |
| плодородный | Отслеживание цикла | Эта система фиксирует менструальные циклы и связанные с ними данные, такие как бинарный результат теста на овуляцию. |
| бакалея | Питание | Здесь отображаются данные о потреблении воды и питательных веществах. Первые показывают, сколько воды пользователь выпивает за один прием. Вторые включают необязательные поля, такие как калории, сахар и магний. |
| sleep_auto | Спать | Эта функция собирает данные об интервалах, связанных с продолжительностью и типом сна пользователя. |
| жизненно важные признаки | Жизненно важные показатели | Это позволяет получить важную информацию об общем состоянии здоровья пользователя. Включает такие данные, как температура тела, уровень глюкозы в крови, артериальное давление и насыщение крови кислородом. |
| осознанность | Здоровье | Это позволяет собирать данные, касающиеся психического здоровья и благополучия пользователя. |
Руководства по улучшению пользовательского опыта для разработчиков
Health Connect предоставляет руководства для разработчиков, ориентированные на конкретные сценарии использования в сфере здравоохранения и фитнеса. Эти руководства показывают, как использовать соответствующие типы данных вместе для создания функций для:
В приведенной ниже таблице типов данных также указано, какие руководства по работе с пользовательским интерфейсом связаны с каждым типом данных.
Поля типа данных
В таблице типов данных Health Connect содержится несколько столбцов, которые помогут вам понять структуру и требования к каждому типу данных. Эти столбцы следующие:
| Поле | Описание | |
|---|---|---|
| расписание | Тип записи | Указывает, записаны ли данные в определенный момент времени или за определенный интервал. Возможные значения: Интервал , Мгновенный , Серия . |
| выпрямить | Единица | Единица измерения для данного типа данных (например, калории, метры, количество). |
| звезда | Обязательные поля | Это основные поля, которые необходимо включить при записи данных этого типа, чтобы обеспечить целостность и полезность данных. |
Типы данных о здоровье и фитнесе
Прежде чем запрашивать какие-либо разрешения, ваше приложение должно объявить их в манифесте. Дополнительную информацию см. в разделе «Объявление разрешений» руководства по быстрому запуску.
Для чтения данных, когда ваше приложение работает в фоновом режиме, или для чтения исторических данных, необходимо отдельно, помимо разрешений для типов данных, объявить дополнительный набор разрешений на чтение:
| Дополнительное разрешение на чтение | Заявление о разрешении |
|---|---|
| Считывание данных в фоновом режиме. Пример руководства по ознакомлению с фоновой информацией. | android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
| Ознакомьтесь с историческими данными Ознакомьтесь с руководством по работе с данными старше 30 дней. | android.permission.health.READ_HEALTH_DATA_HISTORY |
1. Выберите версию Jetpack.
Условия предоставления разрешений различаются в зависимости от версии Jetpack, поэтому убедитесь, что вы выбрали диапазон версий Jetpack, используемый вашим приложением.
2. Отфильтруйте таблицу типов данных.
В таблице ниже представлен полный список типов данных, для каждого из которых указаны категория, флаги функций и руководства, а также декларации разрешений.
| Тип данных Гиды | Категория | Тип записи Заявления о разрешении Флаг функции |
|---|---|---|
| Сожженные активные калории Руководство по тренировкам
| Активность | ActiveCaloriesBurnedRecordandroid.permission.health.READ_ACTIVE_CALORIES_BURNEDandroid.permission.health.WRITE_ACTIVE_CALORIES_BURNED Агрегированные типы данныхACTIVE_CALORIES_TOTAL |
| Интенсивность активности Руководство по тренировкам
| Активность | ActivityIntensityRecordandroid.permission.health.READ_ACTIVITY_INTENSITYandroid.permission.health.WRITE_ACTIVITY_INTENSITYFEATURE_ACTIVITY_INTENSITY Агрегированные типы данныхDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
Базальная температура тела
| Отслеживание цикла | BasalBodyTemperatureRecordandroid.permission.health.READ_BASAL_BODY_TEMPERATUREandroid.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
Базальный метаболизм
| Параметры тела | BasalMetabolicRateRecordandroid.permission.health.READ_BASAL_METABOLIC_RATEandroid.permission.health.WRITE_BASAL_METABOLIC_RATE Агрегированные типы данныхBASAL_CALORIES_TOTAL |
| уровень глюкозы в крови Руководство по жизненно важным показателям
| Жизненно важные показатели | BloodGlucoseRecordandroid.permission.health.READ_BLOOD_GLUCOSEandroid.permission.health.WRITE_BLOOD_GLUCOSE |
| Артериальное давление Руководство по жизненно важным показателям
| Жизненно важные показатели | BloodPressureRecordandroid.permission.health.READ_BLOOD_PRESSUREandroid.permission.health.WRITE_BLOOD_PRESSURE Агрегированные типы данныхDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
Жировая ткань
| Параметры тела | BodyFatRecordandroid.permission.health.READ_BODY_FATandroid.permission.health.WRITE_BODY_FAT |
| Температура тела Руководство по жизненно важным показателям
| Жизненно важные показатели | BodyTemperatureRecordandroid.permission.health.READ_BODY_TEMPERATUREandroid.permission.health.WRITE_BODY_TEMPERATURE |
масса воды в организме
| Параметры тела | BodyWaterMassRecordandroid.permission.health.READ_BODY_WATER_MASSandroid.permission.health.WRITE_BODY_WATER_MASS |
Костная масса
| Параметры тела | BoneMassRecordandroid.permission.health.READ_BONE_MASSandroid.permission.health.WRITE_BONE_MASS |
цервикальная слизь
| Отслеживание цикла | CervicalMucusRecordandroid.permission.health.READ_CERVICAL_MUCUSandroid.permission.health.WRITE_CERVICAL_MUCUS |
| частота вращения педалей при езде на велосипеде Руководство по тренировкам
| Активность | CyclingPedalingCadenceRecordandroid.permission.health.READ_EXERCISEandroid.permission.health.WRITE_EXERCISE Агрегированные типы данныхRPM_AVGRPM_MAXRPM_MIN |
| Расстояние Руководство по тренировкам
| Активность | DistanceRecordandroid.permission.health.READ_DISTANCEandroid.permission.health.WRITE_DISTANCE Агрегированные типы данныхDISTANCE_TOTAL |
| Набранная высота Руководство по тренировкам
| Активность | ElevationGainedRecordandroid.permission.health.READ_ELEVATION_GAINEDandroid.permission.health.WRITE_ELEVATION_GAINED Агрегированные типы данныхELEVATION_GAINED_TOTAL |
| Упражнение Руководство по тренировкам Добавить руководство по маршрутам для тренировок
| Активность | ExerciseSessionRecordandroid.permission.health.READ_EXERCISEandroid.permission.health.READ_EXERCISE_ROUTEandroid.permission.health.WRITE_EXERCISEandroid.permission.health.WRITE_EXERCISE_ROUTE Виды упражненийПросмотреть все виды упражненийEXERCISE_TYPE_UNKNOWNEXERCISE_TYPE_BADMINTONEXERCISE_TYPE_BASEBALLEXERCISE_TYPE_BASKETBALLEXERCISE_TYPE_BIKINGEXERCISE_TYPE_BIKING_STATIONARYEXERCISE_TYPE_BOOT_CAMPEXERCISE_TYPE_BOXINGEXERCISE_TYPE_CALISTHENICSEXERCISE_TYPE_CRICKETEXERCISE_TYPE_DANCINGEXERCISE_TYPE_ELLIPTICALEXERCISE_TYPE_EXERCISE_CLASSEXERCISE_TYPE_FENCINGEXERCISE_TYPE_FOOTBALL_AMERICANEXERCISE_TYPE_FOOTBALL_AUSTRALIANEXERCISE_TYPE_FRISBEE_DISCEXERCISE_TYPE_GOLFEXERCISE_TYPE_GUIDED_BREATHINGEXERCISE_TYPE_GYMNASTICSEXERCISE_TYPE_HANDBALLEXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAININGEXERCISE_TYPE_HIKINGEXERCISE_TYPE_ICE_HOCKEYEXERCISE_TYPE_ICE_SKATINGEXERCISE_TYPE_MARTIAL_ARTSEXERCISE_TYPE_PADDLINGEXERCISE_TYPE_PARAGLIDINGEXERCISE_TYPE_PILATESEXERCISE_TYPE_RACQUETBALLEXERCISE_TYPE_ROCK_CLIMBINGEXERCISE_TYPE_ROLLER_HOCKEYEXERCISE_TYPE_ROWINGEXERCISE_TYPE_ROWING_MACHINEEXERCISE_TYPE_RUGBYEXERCISE_TYPE_RUNNINGEXERCISE_TYPE_RUNNING_TREADMILLEXERCISE_TYPE_SAILINGEXERCISE_TYPE_SCUBA_DIVINGEXERCISE_TYPE_SKATINGEXERCISE_TYPE_SKIINGEXERCISE_TYPE_SNOWBOARDINGEXERCISE_TYPE_SNOWSHOEINGEXERCISE_TYPE_SOCCEREXERCISE_TYPE_SOFTBALLEXERCISE_TYPE_SQUASHEXERCISE_TYPE_STAIR_CLIMBINGEXERCISE_TYPE_STAIR_CLIMBING_MACHINEEXERCISE_TYPE_STRENGTH_TRAININGEXERCISE_TYPE_STRETCHINGEXERCISE_TYPE_SURFINGEXERCISE_TYPE_SWIMMING_OPEN_WATEREXERCISE_TYPE_SWIMMING_POOLEXERCISE_TYPE_TABLE_TENNISEXERCISE_TYPE_TENNISEXERCISE_TYPE_VOLLEYBALLEXERCISE_TYPE_WALKINGEXERCISE_TYPE_WATER_POLOEXERCISE_TYPE_WEIGHTLIFTINGEXERCISE_TYPE_WHEELCHAIREXERCISE_TYPE_OTHER_WORKOUTEXERCISE_TYPE_YOGA Агрегированные типы данныхEXERCISE_DURATION_TOTAL |
| Поднялись на этажи Руководство по тренировкам
| Активность | FloorsClimbedRecordandroid.permission.health.READ_FLOORS_CLIMBEDandroid.permission.health.WRITE_FLOORS_CLIMBED Агрегированные типы данныхFLOORS_CLIMBED_TOTAL |
| Частота сердечных сокращений Руководство по жизненно важным показателям
| Жизненно важные показатели | HeartRateRecordandroid.permission.health.READ_HEART_RATEandroid.permission.health.WRITE_HEART_RATE Агрегированные типы данныхBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| вариабельность сердечного ритма Руководство по жизненно важным показателям
| Жизненно важные показатели | HeartRateVariabilityRmssdRecordandroid.permission.health.READ_HEART_RATE_VARIABILITYandroid.permission.health.WRITE_HEART_RATE_VARIABILITY |
Высота
| Параметры тела | HeightRecordandroid.permission.health.READ_HEIGHTandroid.permission.health.WRITE_HEIGHT Aggregate data typesHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
Увлажнение
| Питание | HydrationRecordandroid.permission.health.READ_HYDRATIONandroid.permission.health.WRITE_HYDRATION Агрегированные типы данныхVOLUME_TOTAL |
Межменструальное кровотечение
| Отслеживание цикла | IntermenstrualBleedingRecordandroid.permission.health.READ_INTERMENSTRUAL_BLEEDINGandroid.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
Сухая масса тела
| Параметры тела | LeanBodyMassRecordandroid.permission.health.READ_LEAN_BODY_MASSandroid.permission.health.WRITE_LEAN_BODY_MASS |
| Менструация Для MenstruationFlowRecord:
Для записи о менструальном цикле:
| Отслеживание цикла | MenstruationFlowRecordMenstruationPeriodRecordandroid.permission.health.READ_MENSTRUATIONandroid.permission.health.WRITE_MENSTRUATION |
| Осознанность Отслеживайте руководство по осознанности
| Здоровье | MindfulnessSessionRecordandroid.permission.health.READ_MINDFULNESSandroid.permission.health.WRITE_MINDFULNESSFEATURE_MINDFULNESS_SESSION Типы сеансов осознанностиПросмотреть все типы сеансов осознанностиMINDFULNESS_SESSION_TYPE_UNKNOWNMINDFULNESS_SESSION_TYPE_MEDITATIONMINDFULNESS_SESSION_TYPE_BREATHINGMINDFULNESS_SESSION_TYPE_MUSICMINDFULNESS_SESSION_TYPE_MOVEMENTMINDFULNESS_SESSION_TYPE_UNGUIDED Агрегированные типы данныхMINDFULNESS_DURATION_TOTAL |
Питание
| Питание | NutritionRecordandroid.permission.health.READ_NUTRITIONandroid.permission.health.WRITE_NUTRITION Агрегированные типы данныхBIOTIN_TOTALCAFFEINE_TOTALCALCIUM_TOTALCHLORIDE_TOTALCHOLESTEROL_TOTALCHROMIUM_TOTALCOPPER_TOTALDIETARY_FIBER_TOTALENERGY_FROM_FAT_TOTALENERGY_TOTALFOLATE_TOTALFOLIC_ACID_TOTALIODINE_TOTALIRON_TOTALMAGNESIUM_TOTALMANGANESE_TOTALMOLYBDENUM_TOTALMONOUNSATURATED_FAT_TOTALNIACIN_TOTALPANTOTHENIC_ACID_TOTALPHOSPHORUS_TOTALPOLYUNSATURATED_FAT_TOTALPOTASSIUM_TOTALPROTEIN_TOTALRIBOFLAVIN_TOTALSATURATED_FAT_TOTALSELENIUM_TOTALSODIUM_TOTALSUGAR_TOTALTHIAMIN_TOTALTOTAL_CARBOHYDRATE_TOTALTOTAL_FAT_TOTALTRANS_FAT_TOTALUNSATURATED_FAT_TOTALVITAMIN_A_TOTALVITAMIN_B12_TOTALVITAMIN_B6_TOTALVITAMIN_C_TOTALVITAMIN_D_TOTALVITAMIN_E_TOTALVITAMIN_K_TOTALZINC_TOTAL |
Тест на овуляцию
| Отслеживание цикла | OvulationTestRecordandroid.permission.health.READ_OVULATION_TESTandroid.permission.health.WRITE_OVULATION_TEST |
| Насыщение кислородом Руководство по жизненно важным показателям
| Жизненно важные показатели | OxygenSaturationRecordandroid.permission.health.READ_OXYGEN_SATURATIONandroid.permission.health.WRITE_OXYGEN_SATURATION |
| Запланированные упражнения Руководство по тренировкам руководство по планам обучения
| Активность | PlannedExerciseSessionRecordandroid.permission.health.READ_PLANNED_EXERCISEandroid.permission.health.WRITE_PLANNED_EXERCISEFEATURE_PLANNED_EXERCISE |
| Власть Руководство по тренировкам
| Активность | PowerRecordandroid.permission.health.READ_POWERandroid.permission.health.WRITE_POWER Агрегированные типы данныхPOWER_AVGPOWER_MAXPOWER_MIN |
| Частота дыхания Руководство по жизненно важным показателям
| Жизненно важные показатели | RespiratoryRateRecordandroid.permission.health.READ_RESPIRATORY_RATEandroid.permission.health.WRITE_RESPIRATORY_RATE |
| Частота сердечных сокращений в состоянии покоя Руководство по жизненно важным показателям
| Жизненно важные показатели | RestingHeartRateRecordandroid.permission.health.READ_RESTING_HEART_RATEandroid.permission.health.WRITE_RESTING_HEART_RATE Агрегированные типы данныхBPM_AVGBPM_MAXBPM_MIN |
Сексуальная активность
| Отслеживание цикла | SexualActivityRecordandroid.permission.health.READ_SEXUAL_ACTIVITYandroid.permission.health.WRITE_SEXUAL_ACTIVITY |
| Температура кожи Руководство по жизненно важным показателям Руководство по измерению температуры кожи
| Жизненно важные показатели | SkinTemperatureRecordandroid.permission.health.READ_SKIN_TEMPERATUREandroid.permission.health.WRITE_SKIN_TEMPERATUREFEATURE_SKIN_TEMPERATURE Агрегированные типы данныхTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| Сеанс сна Руководство по сну Руководство по отслеживанию сеансов сна
| Спать | SleepSessionRecordandroid.permission.health.READ_SLEEPandroid.permission.health.WRITE_SLEEP Агрегированные типы данныхSLEEP_DURATION_TOTAL |
| Скорость Руководство по тренировкам
| Активность | SpeedRecordandroid.permission.health.READ_SPEEDandroid.permission.health.WRITE_SPEED Агрегированные типы данныхSPEED_AVGSPEED_MAXSPEED_MIN |
| Шаги Руководство по тренировкам Для StepsRecord:
Для записи частоты шагов:
| Активность | StepsRecordStepsCadenceRecordandroid.permission.health.READ_STEPSandroid.permission.health.WRITE_STEPS Агрегированные типы данных для StepsRecordCOUNT_TOTAL Агрегированные типы данных для StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| Общее количество сожженных калорий Руководство по тренировкам
| Активность | TotalCaloriesBurnedRecordandroid.permission.health.READ_TOTAL_CALORIES_BURNEDandroid.permission.health.WRITE_TOTAL_CALORIES_BURNED Агрегированные типы данныхENERGY_TOTAL |
| VO2 max Руководство по тренировкам
| Активность | Vo2MaxRecordandroid.permission.health.READ_VO2_MAXandroid.permission.health.WRITE_VO2_MAX |
Масса
| Параметры тела | WeightRecordandroid.permission.health.READ_WEIGHTandroid.permission.health.WRITE_WEIGHT Агрегированные типы данныхWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| Толкание инвалидной коляски Руководство по тренировкам
| Активность | WheelchairPushesRecordandroid.permission.health.READ_WHEELCHAIR_PUSHESandroid.permission.health.WRITE_WHEELCHAIR_PUSHES Агрегированные типы данныхCOUNT_TOTAL |