Платформа "Здоровье и спорт" хранит и структурирует данные о здоровье и физической активности, а также медицинские записи. Чтобы определить требования к приложению, важно понимать, какие типы данных и разрешения предлагает платформа "Здоровье и спорт".
Когда вы будете готовы опубликовать приложение в Google Play, вам нужно будет задекларировать использование данных в приложении, а также доступ к типам данных платформы "Здоровье и спорт", которые используются в приложении. В противном случае пользователи могут увидеть сообщение об ошибке, в котором говорится, что у приложения нет доступа к типам данных платформы "Здоровье и спорт", поскольку для этого требуется специальное разрешение.
Подробнее о том, как заполнить декларацию для приложений категории "Здоровье" в Play Console…
Категории типов данных
Платформа "Здоровье и спорт" поддерживает типы данных, которые используются в большинстве приложений для здоровья и фитнеса, чтобы обеспечить максимальное разнообразие. Платформа "Здоровье и спорт" позволяет хранить данные о здоровье и физической активности и получать к ним доступ. Эти типы данных делятся на следующие категории:
| Категория | Описание | |
|---|---|---|
| directions_run | Действия | Это позволяет фиксировать любые действия пользователя. Это могут быть занятия спортом, например бег или плавание. |
| straighten | Физические параметры | Включает общие данные о теле, например вес пользователя и скорость метаболизма. |
| fertile | Отслеживание цикла | Этот тип данных позволяет регистрировать менструальные циклы и связанные с ними элементы, например бинарный результат теста на овуляцию. |
| grocery | Питание | Это относится к типам данных о питании и потреблении воды. Первый параметр представляет собой количество воды, которое пользователь выпивает за один раз. Последний включает необязательные поля, такие как калории, сахар и магний. |
| sleep_auto | Для сна | Это позволяет собирать данные о продолжительности и типе сна пользователя. |
| vital_signs | Vitals | Это позволяет получить важную информацию об общем состоянии здоровья пользователя. К ним относятся, например, температура тела, уровень глюкозы в крови, артериальное давление и насыщение крови кислородом. |
| mindfulness | Красота и здоровье | Данные о психическом здоровье и самочувствии пользователя. |
Руководства для разработчиков
В руководствах по разработке для платформы "Здоровье и спорт" рассматриваются конкретные сценарии использования, связанные со здоровьем и физической активностью. В этих руководствах рассказывается, как использовать типы данных вместе, чтобы создавать функции для следующих областей:
В таблице ниже также указано, какие руководства по взаимодействию связаны с каждым типом данных.
Поля типов данных
В таблице типов данных платформы "Здоровье и спорт" есть несколько столбцов, которые помогут вам понять структуру и требования каждого типа данных. Эти столбцы перечислены далее.
| Поле | Описание | |
|---|---|---|
| schedule | Тип записи | Указывает, записываются ли данные в определенный момент времени или за интервал. Возможные значения: Interval, Instantaneous, Series. |
| straighten | Единица измерения | Единица измерения для типа данных (например, калории, метры, количество). |
| star | Обязательные поля | Это основные поля, которые необходимо включать при записи данных этого типа, чтобы обеспечить целостность и полезность данных. |
Типы данных о здоровье и физической активности
Прежде чем запрашивать разрешения, приложение должно объявить их в манифесте. Подробную информацию можно найти в разделе Объявление разрешений краткого руководства.
Чтобы читать данные, когда приложение работает в фоновом режиме, или читать статистику, необходимо объявить дополнительный набор разрешений на чтение отдельно от разрешений для типов данных:
| Дополнительное разрешение на чтение | Декларация разрешений |
|---|---|
|
Чтение данных в фоновом режиме
Руководство Пример чтения данных в фоновом режиме |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
|
Чтение статистики
Руководство Чтение данных за период более 30 дней |
android.permission.health.READ_HEALTH_DATA_HISTORY |
В таблице ниже приведен полный список типов данных с указанием категории, флагов функций, руководств и деклараций разрешений.
Эта таблица предназначена для Health Connect SDK версии 1.0.0-alpha10 и выше. Если вы используете более раннюю версию SDK, ознакомьтесь со статьей Типы данных Здоровья и спорта для SDK версии 1.0.0-alpha09 и более ранних.
| Тип данных Руководства |
Категория | Тип записи Декларация разрешений Флаг функции |
|---|---|---|
| Сожжено калорий во время активности Руководство по тренировкам Руководство по встроенному отслеживанию
|
Действия | ActiveCaloriesBurnedRecord
android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED Типы агрегированных данныхACTIVE_CALORIES_TOTAL |
| Интенсивность тренировок Руководство по тренировкам
|
Действия | ActivityIntensityRecord
android.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITYТипы агрегированных данныхDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
Базальная температура тела
|
Отслеживание цикла | BasalBodyTemperatureRecord
android.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
Скорость метаболизма (BMR)
|
Физические параметры | BasalMetabolicRateRecord
android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE Типы агрегированных данныхBASAL_CALORIES_TOTAL |
| Уровень глюкозы в крови Руководство по жизненным показателям
|
Жизненные показатели | BloodGlucoseRecord
android.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
| Артериальное давление Руководство по жизненным показателям
|
Жизненные показатели | BloodPressureRecord
android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE Типы агрегированных данныхDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
Жировая ткань
|
Физические параметры | BodyFatRecord
android.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
| Температура тела Руководство по жизненным показателям
|
Жизненные показатели | BodyTemperatureRecord
android.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
Масса воды в организме
|
Физические параметры | BodyWaterMassRecord
android.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
Масса костей
|
Физические параметры | BoneMassRecord
android.permission.health.READ_BONE_MASS android.permission.health.WRITE_BONE_MASS |
Цервикальная слизь
|
Отслеживание цикла | CervicalMucusRecord
android.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
| Частота вращения педалей Руководство по тренировкам
|
Действия | CyclingPedalingCadenceRecord
android.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE Типы агрегированных данныхRPM_AVGRPM_MAXRPM_MIN |
| Расстояние Руководство по тренировкам Руководство по встроенному отслеживанию
|
Действия | DistanceRecord
android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE Типы агрегированных данныхDISTANCE_TOTAL |
| Набор высоты Руководство по тренировкам
|
Действия | ElevationGainedRecord
android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED Типы агрегированных данныхELEVATION_GAINED_TOTAL |
| Тренировки Руководство по тренировкам Руководство по добавлению маршрутов тренировок
|
Действия | ExerciseSessionRecord
android.permission.health.READ_EXERCISE android.permission.health.READ_EXERCISE_ROUTE android.permission.health.WRITE_EXERCISE android.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 |
| Пройденные этажи Руководство по тренировкам
|
Действия | FloorsClimbedRecord
android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED Типы агрегированных данныхFLOORS_CLIMBED_TOTAL |
| Пульс Руководство по жизненным показателям
|
Жизненные показатели | HeartRateRecord
android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE Типы агрегированных данныхBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| Вариабельность сердечного ритма Руководство по жизненным показателям
|
Жизненные показатели | HeartRateVariabilityRmssdRecord
android.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
Высота
|
Физические параметры | HeightRecord
android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT Типы агрегированных данныхHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
Потребление воды
|
Питание | HydrationRecord
android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION Типы агрегированных данныхVOLUME_TOTAL |
Межменструальные кровотечения
|
Отслеживание цикла | IntermenstrualBleedingRecord
android.permission.health.READ_INTERMENSTRUAL_BLEEDING android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
Сухая масса тела
|
Физические параметры | LeanBodyMassRecord
android.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| Менструация Для MenstruationFlowRecord:
Для MenstruationPeriodRecord:
|
Отслеживание цикла | MenstruationFlowRecord
MenstruationPeriodRecord
android.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| Осознанность Руководство по отслеживанию осознанности
|
Здоровье | MindfulnessSessionRecord
android.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS FEATURE_MINDFULNESS_SESSIONТипы занятий по развитию осознанностиПосмотреть все типы занятий по развитию осознанностиMINDFULNESS_SESSION_TYPE_UNKNOWNMINDFULNESS_SESSION_TYPE_MEDITATIONMINDFULNESS_SESSION_TYPE_BREATHINGMINDFULNESS_SESSION_TYPE_MUSICMINDFULNESS_SESSION_TYPE_MOVEMENTMINDFULNESS_SESSION_TYPE_UNGUIDEDТипы агрегированных данныхMINDFULNESS_DURATION_TOTAL |
Питание
|
Питание | NutritionRecord
android.permission.health.READ_NUTRITION android.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 |
Тест на овуляцию
|
Отслеживание цикла | OvulationTestRecord
android.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
| Уровень кислорода в крови Руководство по жизненным показателям
|
Жизненные показатели | OxygenSaturationRecord
android.permission.health.READ_OXYGEN_SATURATION android.permission.health.WRITE_OXYGEN_SATURATION |
| Запланированные тренировки Руководство по тренировкам Руководство по планам тренировок
|
Действия | PlannedExerciseSessionRecord
android.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
| Мощность Руководство по тренировкам
|
Действия | PowerRecord
android.permission.health.READ_POWER android.permission.health.WRITE_POWER Типы агрегированных данныхPOWER_AVGPOWER_MAXPOWER_MIN |
| Частота дыхания Руководство по жизненным показателям
|
Жизненные показатели | RespiratoryRateRecord
android.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
| Частота сердечных сокращений в покое Руководство по жизненным показателям
|
Жизненные показатели | RestingHeartRateRecord
android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE Типы агрегированных данныхBPM_AVGBPM_MAXBPM_MIN |
Действия сексуального характера
|
Отслеживание цикла | SexualActivityRecord
android.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| Температура кожи Руководство по жизненным показателям Руководство по измерению температуры кожи
|
Жизненные показатели | SkinTemperatureRecord
android.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATUREТипы агрегированных данныхTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| Сеанс сна Руководство по сну Руководство по отслеживанию сеансов сна
|
Сон | SleepSessionRecord
android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP Типы агрегированных данныхSLEEP_DURATION_TOTAL |
| Скорость Руководство по тренировкам
|
Действия | SpeedRecord
android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED Типы агрегированных данныхSPEED_AVGSPEED_MAXSPEED_MIN |
| Шаги Руководство по тренировкам Руководство по встроенному отслеживанию Руководство по отслеживанию шагов Для StepsRecord:
Для StepsCadenceRecord:
|
Действия | StepsRecord
StepsCadenceRecord
android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS Типы агрегированных данных для StepsRecordCOUNT_TOTALТипы агрегированных данных для StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| Общее количество сожженных калорий Руководство по тренировкам
|
Действия | TotalCaloriesBurnedRecord
android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED Типы агрегированных данныхENERGY_TOTAL |
| МПК Руководство по тренировкам
|
Действия | Vo2MaxRecord
android.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
Вес
|
Физические параметры | WeightRecord
android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT Типы агрегированных данныхWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| Толчки на кресле-коляске Руководство по тренировкам
|
Действия | WheelchairPushesRecord
android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES Типы агрегированных данныхCOUNT_TOTAL |