헬스 커넥트는 건강 및 피트니스 데이터와 의료 기록 데이터를 모두 저장하고 구조화합니다. 앱의 요구사항을 계획할 수 있도록 먼저 헬스 커넥트에서 제공하는 데이터 유형과 권한을 이해하는 것이 중요합니다.
개발 후 Play 스토어에 앱을 게시할 준비를 할 때 앱의 데이터 사용을 선언하고 앱이 사용하는 헬스 커넥트 데이터 유형에 대한 액세스 권한을 선언해야 합니다. 그렇지 않으면 특별 승인이 필요하여 앱이 헬스 커넥트 데이터 유형에 액세스할 수 없다는 오류 메시지가 사용자에게 표시될 수 있습니다.
자세한 내용은 Play Console에서 건강 앱 선언 완료하기를 참고하세요.
데이터 유형 카테고리
헬스 커넥트는 가능한 한 다양한 데이터를 제공하기 위해 대부분의 건강 및 피트니스 앱에서 사용되는 데이터 유형을 지원합니다. 헬스 커넥트는 건강 및 피트니스 데이터를 포괄적으로 확인하고 저장하는 것을 목표로 합니다. 이러한 데이터 유형은 다음 카테고리로 분류됩니다.
카테고리 | 설명 | |
---|---|---|
directions_run | 활동 | 사용자가 하는 모든 활동을 캡처합니다. 달리기, 수영과 같은 건강 및 피트니스 활동을 포함할 수 있습니다. |
straighten | 신체 측정 | 사용자의 체중 및 기초 대사율과 같이 신체와 관련된 일반적인 데이터를 캡처합니다. |
비옥한 | 월경 주기 추적 | 월경 주기 및 관련 데이터 포인트(예: 배란 테스트의 바이너리 결과)를 캡처합니다. |
식료품 | Nutrition | 수분 섭취 및 영양 데이터 유형을 캡처합니다. 수분 섭취는 사용자가 한 번에 마신 물의 양을 나타냅니다. 영양 데이터 유형에는 칼로리, 당분, 마그네슘과 같은 선택 필드가 포함되어 있습니다. |
sleep_auto | 수면 | 사용자의 수면 시간 및 유형과 관련된 인터벌 데이터를 캡처합니다. |
vital_signs | Vitals | 사용자의 일반적인 건강에 관한 필수 정보를 캡처합니다. 여기에는 체온, 혈당, 혈압, 혈중 산소 포화도 등의 데이터가 포함됩니다. |
마음챙김 | 웰빙 | 사용자의 정신 건강 및 웰빙과 관련된 데이터를 캡처합니다. |
건강 및 피트니스 데이터 유형
권한을 요청하기 전에 먼저 앱은 매니페스트에서 권한을 선언해야 합니다. 자세한 내용은 빠른 시작 가이드의 권한 선언 섹션을 참고하세요.
앱이 백그라운드에 있는 동안 데이터를 읽거나 기록 데이터를 읽으려면 데이터 유형 권한과 별도로 추가 읽기 권한 집합을 선언해야 합니다.
추가 읽기 권한 | 권한 선언 |
---|---|
백그라운드에서 데이터 읽기
백그라운드 읽기 예시 가이드 |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
과거 데이터 읽기
30일이 지난 데이터 읽기 가이드 |
android.permission.health.READ_HEALTH_DATA_HISTORY |
1. Jetpack 버전 선택
권한 선언은 Jetpack 버전에 따라 다르므로 앱에서 사용하는 Jetpack 버전 범위를 선택해야 합니다.
2. 데이터 유형 표 필터링
다음 표에는 카테고리, 기능 플래그 및 가이드, 권한 선언이 포함된 전체 데이터 유형 목록이 나와 있습니다.
데이터 유형 기능 가이드 |
카테고리 | 레코드 유형 권한 선언 기능 플래그 |
---|---|---|
활동 칼로리 소모량 |
활동 |
ActiveCaloriesBurnedRecord android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
활동 강도 |
활동 |
ActivityIntensityRecord android.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITY |
기초 체온 |
월경 주기 추적 |
BasalBodyTemperatureRecord android.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
기초대사율 |
신체 측정 |
BasalMetabolicRateRecord android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE |
혈당 |
Vitals |
BloodGlucoseRecord android.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
혈압 |
Vitals |
BloodPressureRecord android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE |
체지방 |
신체 측정 |
BodyFatRecord android.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
체온 |
Vitals |
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 |
Distance |
활동 |
DistanceRecord android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE |
상승 고도 |
활동 |
ElevationGainedRecord android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED |
운동 운동 경로 추가 가이드 |
활동 |
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_UNKNOWN EXERCISE_TYPE_BADMINTON EXERCISE_TYPE_BASEBALL EXERCISE_TYPE_BASKETBALL EXERCISE_TYPE_BIKING EXERCISE_TYPE_BIKING_STATIONARY EXERCISE_TYPE_BOOT_CAMP EXERCISE_TYPE_BOXING EXERCISE_TYPE_CALISTHENICS EXERCISE_TYPE_CRICKET EXERCISE_TYPE_DANCING EXERCISE_TYPE_ELLIPTICAL EXERCISE_TYPE_EXERCISE_CLASS EXERCISE_TYPE_FENCING EXERCISE_TYPE_FOOTBALL_AMERICAN EXERCISE_TYPE_FOOTBALL_AUSTRALIAN EXERCISE_TYPE_FRISBEE_DISC EXERCISE_TYPE_GOLF EXERCISE_TYPE_GUIDED_BREATHING EXERCISE_TYPE_GYMNASTICS EXERCISE_TYPE_HANDBALL EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING EXERCISE_TYPE_HIKING EXERCISE_TYPE_ICE_HOCKEY EXERCISE_TYPE_ICE_SKATING EXERCISE_TYPE_MARTIAL_ARTS EXERCISE_TYPE_PADDLING EXERCISE_TYPE_PARAGLIDING EXERCISE_TYPE_PILATES EXERCISE_TYPE_RACQUETBALL EXERCISE_TYPE_ROCK_CLIMBING EXERCISE_TYPE_ROLLER_HOCKEY EXERCISE_TYPE_ROWING EXERCISE_TYPE_ROWING_MACHINE EXERCISE_TYPE_RUGBY EXERCISE_TYPE_RUNNING EXERCISE_TYPE_RUNNING_TREADMILL EXERCISE_TYPE_SAILING EXERCISE_TYPE_SCUBA_DIVING EXERCISE_TYPE_SKATING EXERCISE_TYPE_SKIING EXERCISE_TYPE_SNOWBOARDING EXERCISE_TYPE_SNOWSHOEING EXERCISE_TYPE_SOCCER EXERCISE_TYPE_SOFTBALL EXERCISE_TYPE_SQUASH EXERCISE_TYPE_STAIR_CLIMBING EXERCISE_TYPE_STAIR_CLIMBING_MACHINE EXERCISE_TYPE_STRENGTH_TRAINING EXERCISE_TYPE_STRETCHING EXERCISE_TYPE_SURFING EXERCISE_TYPE_SWIMMING_OPEN_WATER EXERCISE_TYPE_SWIMMING_POOL EXERCISE_TYPE_TABLE_TENNIS EXERCISE_TYPE_TENNIS EXERCISE_TYPE_VOLLEYBALL EXERCISE_TYPE_WALKING EXERCISE_TYPE_WATER_POLO EXERCISE_TYPE_WEIGHTLIFTING EXERCISE_TYPE_WHEELCHAIR EXERCISE_TYPE_OTHER_WORKOUT EXERCISE_TYPE_YOGA |
오른 계단수 |
활동 |
FloorsClimbedRecord android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED |
심박수 |
Vitals |
HeartRateRecord android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE |
심박 변이도 |
Vitals |
HeartRateVariabilityRmssdRecord android.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
Height |
신체 측정 |
HeightRecord android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT |
수분 |
영양 |
HydrationRecord android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION |
월경간출혈 |
월경 주기 추적 |
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 |
Menstruation |
월경 주기 추적 |
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 |
영양 |
영양 |
NutritionRecord android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION |
배란 테스트 |
월경 주기 추적 |
OvulationTestRecord android.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
산소 포화도 |
Vitals |
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 |
호흡수 |
Vitals |
RespiratoryRateRecord android.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
안정 시 심박수 |
Vitals |
RestingHeartRateRecord android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE |
성적인 활동 |
활동 |
SexualActivityRecord android.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
피부 온도 피부 온도 측정 가이드 |
Vitals |
SkinTemperatureRecord android.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATURE |
수면 세션 수면 세션 추적 가이드 |
절전 모드 |
SleepSessionRecord android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP |
속도 |
활동 |
SpeedRecord android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED |
단계 |
활동 |
StepsRecord StepsCadenceRecord android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS |
총 칼로리 소모량 |
활동 |
TotalCaloriesBurnedRecord android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
최대 산소 소비량 |
활동 |
Vo2MaxRecord android.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
가중치 |
신체 측정 |
WeightRecord android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT |
휠체어 밀기 |
활동 |
WheelchairPushesRecord android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES |