헬스 커넥트는 건강 및 피트니스 데이터와 의료 기록 데이터를 모두 저장하고 구조화합니다. 앱의 요구사항을 계획할 수 있도록 먼저 헬스 커넥트에서 제공하는 데이터 유형과 권한을 이해하는 것이 중요합니다.
개발 후 앱을 Google Play에 게시할 준비를 할 때 앱의 데이터 사용을 선언하고 앱에서 사용하는 헬스 커넥트 데이터 유형에 대한 액세스 권한을 선언해야 합니다. 그렇지 않으면 특별 승인이 필요하여 앱이 헬스 커넥트 데이터 유형에 액세스할 수 없다는 오류 메시지가 사용자에게 표시될 수 있습니다.
자세한 내용은 Play Console에서 건강 앱 선언 완료하기를 참고하세요.
데이터 유형 카테고리
헬스 커넥트는 가능한 한 다양한 데이터를 제공하기 위해 대부분의 건강 및 피트니스 앱에서 사용되는 데이터 유형을 지원합니다. 헬스 커넥트는 건강 및 피트니스 데이터를 포괄적으로 확인하고 저장하는 것을 목표로 합니다. 이러한 데이터 유형은 다음과 같은 카테고리로 분류됩니다.
| 카테고리 | 설명 | |
|---|---|---|
| directions_run | 활동 | 사용자가 하는 모든 활동을 캡처합니다. 달리기, 수영과 같은 건강 및 피트니스 활동을 포함할 수 있습니다. |
| straighten | 신체 측정 | 사용자의 체중 및 기초 대사율과 같은 신체와 관련된 일반적인 데이터를 캡처합니다. |
| fertile | 월경 주기 추적 | 월경 주기 및 관련 데이터 포인트(예: 배란 테스트의 바이너리 결과)를 캡처합니다. |
| grocery | Nutrition | 수분 섭취 및 영양 데이터 유형을 캡처합니다. 수분 섭취는 사용자가 한 번에 마신 물의 양을 나타냅니다. 영양 데이터 유형에는 칼로리, 당분, 마그네슘과 같은 선택 필드가 포함되어 있습니다. |
| sleep_auto | 수면 | 사용자의 수면 시간 및 유형과 관련된 인터벌 데이터를 캡처합니다. |
| vital_signs | Vitals | 사용자의 일반적인 건강에 관한 필수 정보를 캡처합니다. 여기에는 체온, 혈당, 혈압, 혈중 산소 포화도 등의 데이터가 포함됩니다. |
| mindfulness | 웰빙 | 사용자의 정신 건강 및 웰빙과 관련된 데이터를 캡처합니다. |
개발자 환경 가이드
헬스 커넥트는 특정 건강 및 피트니스 사용 사례에 중점을 둔 개발자 환경 가이드를 제공합니다. 이 가이드에서는 관련 데이터 유형을 함께 사용하여 다음 영역의 기능을 빌드하는 방법을 보여줍니다.
다음 데이터 유형 표에는 각 데이터 유형과 연결된 환경 가이드도 표시되어 있습니다.
데이터 유형 필드
헬스 커넥트 데이터 유형 표에는 각 데이터 유형의 구조와 요구사항을 이해하는 데 도움이 되는 여러 필드 열이 포함되어 있습니다. 이러한 열은 다음과 같습니다.
| 필드 | 설명 | |
|---|---|---|
| schedule | 레코드 유형 | 데이터가 특정 시점에 기록되는지 아니면 일정 간격으로 기록되는지를 나타냅니다. 가능한 값은 Interval, Instantaneous, Series입니다. |
| straighten | 단위 | 데이터 유형의 측정 단위입니다 (예: 칼로리, 미터, 개수). |
| star | 필수 입력란 | 데이터 무결성과 유용성을 유지하기 위해 이 데이터 유형의 데이터를 작성할 때 포함해야 하는 필수 필드입니다. |
건강 및 피트니스 데이터 유형
권한을 요청하기 전에 먼저 앱은 매니페스트에서 권한을 선언해야 합니다. 자세한 내용은 빠른 시작 가이드의 권한 선언 섹션을 참고하세요.
다음 표에는 카테고리, 기능 플래그 및 가이드, 권한 선언이 포함된 전체 데이터 유형 목록이 나와 있습니다.
이 표는 헬스 커넥트 SDK 버전 1.0.0-alpha09 이하에 해당합니다. SDK의 상위 버전을 사용하는 경우 SDK 1.0.0-alpha10 이상의 헬스 커넥트 데이터 유형을 참고하세요.
| 데이터 유형 가이드 |
카테고리 | 레코드 유형 권한 선언 기능 플래그 |
|---|---|---|
| 활동 칼로리 소모량 운동 가이드
|
활동 | ActiveCaloriesBurnedRecord
androidx.health.permission.ActiveCaloriesBurned.READ androidx.health.permission.ActiveCaloriesBurned.WRITE 집계 데이터 유형ACTIVE_CALORIES_TOTAL |
| 활동 강도 운동 가이드
|
활동 | ActivityIntensityRecord
FEATURE_ACTIVITY_INTENSITY집계 데이터 유형DURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
기초 체온
|
생리 주기 모니터링 | BasalBodyTemperatureRecord
androidx.health.permission.BasalBodyTemperature.READ androidx.health.permission.BasalBodyTemperature.WRITE |
기초 대사율
|
신체 측정 | BasalMetabolicRateRecord
androidx.health.permission.BasalMetabolicRate.READ androidx.health.permission.BasalMetabolicRate.WRITE 집계 데이터 유형BASAL_CALORIES_TOTAL |
| 혈당 바이탈 가이드
|
Vitals | BloodGlucoseRecord
androidx.health.permission.BloodGlucose.READ androidx.health.permission.BloodGlucose.WRITE |
| 혈압 활력 징후 가이드
|
Vitals | BloodPressureRecord
androidx.health.permission.BloodPressure.READ androidx.health.permission.BloodPressure.WRITE 집계 데이터 유형DIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
체지방
|
신체 측정 | BodyFatRecord
androidx.health.permission.BodyFat.READ androidx.health.permission.BodyFat.WRITE |
| 체온 바이탈 가이드
|
Vitals | BodyTemperatureRecord
androidx.health.permission.BodyTemperature.READ androidx.health.permission.BodyTemperature.WRITE |
체내 수분량
|
신체 측정 | BodyWaterMassRecord
androidx.health.permission.BodyWaterMass.READ androidx.health.permission.BodyWaterMass.WRITE |
골질량
|
신체 측정 | BoneMassRecord
androidx.health.permission.BoneMass.READ androidx.health.permission.BoneMass.WRITE |
자궁경관 점액
|
생리 주기 모니터링 | CervicalMucusRecord
androidx.health.permission.CervicalMucus.READ androidx.health.permission.CervicalMucus.WRITE |
| 사이클링 페달 회전수 운동 가이드
|
활동 | CyclingPedalingCadenceRecord
androidx.health.permission.Exercise.READ androidx.health.permission.Exercise.WRITE 집계 데이터 유형RPM_AVGRPM_MAXRPM_MIN |
| 거리 운동 가이드
|
활동 | DistanceRecord
androidx.health.permission.Distance.READ androidx.health.permission.Distance.WRITE 집계 데이터 유형DISTANCE_TOTAL |
| 획득한 고도 운동 가이드
|
활동 | ElevationGainedRecord
androidx.health.permission.ElevationGained.READ androidx.health.permission.ElevationGained.WRITE 집계 데이터 유형ELEVATION_GAINED_TOTAL |
| 운동 운동 가이드 운동 경로 추가 가이드
|
활동 | ExerciseSessionRecord
androidx.health.permission.ExerciseSession.READ androidx.health.permission.ExerciseSession.WRITE 운동 유형모든 운동 유형 보기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
androidx.health.permission.FloorsClimbed.READ androidx.health.permission.FloorsClimbed.WRITE 집계 데이터 유형FLOORS_CLIMBED_TOTAL |
| 심박수 활력 징후 가이드
|
Vitals | HeartRateRecord
androidx.health.permission.HeartRate.READ androidx.health.permission.HeartRate.WRITE 집계 데이터 유형BPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| 심박 변이도 바이탈 가이드
|
Vitals | HeartRateVariabilityRmssdRecord
androidx.health.permission.HeartRateVariability.READ androidx.health.permission.HeartRateVariability.WRITE |
키
|
신체 측정 | HeightRecord
androidx.health.permission.Height.READ androidx.health.permission.Height.WRITE 집계 데이터 유형HEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
수분 공급
|
영양 | HydrationRecord
androidx.health.permission.Hydration.READ androidx.health.permission.Hydration.WRITE 집계 데이터 유형VOLUME_TOTAL |
월경간출혈
|
생리 주기 모니터링 | IntermenstrualBleedingRecord
androidx.health.permission.IntermenstrualBleeding.READ androidx.health.permission.IntermenstrualBleeding.WRITE |
제지방량
|
신체 측정 | LeanBodyMassRecord
androidx.health.permission.LeanBodyMass.READ androidx.health.permission.LeanBodyMass.WRITE |
| Menstruation MenstruationFlowRecord의 경우:
MenstruationPeriodRecord의 경우:
|
생리 주기 모니터링 | MenstruationFlowRecord
MenstruationPeriodRecord
androidx.health.permission.Menstruation.READ androidx.health.permission.Menstruation.WRITE |
| 마음챙김 마음챙김 추적 가이드
|
웰빙 | MindfulnessSessionRecord
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
androidx.health.permission.Nutrition.READ androidx.health.permission.Nutrition.WRITE 집계 데이터 유형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
androidx.health.permission.OvulationTest.READ androidx.health.permission.OvulationTest.WRITE |
| 산소 포화도 활력 징후 가이드
|
Vitals | OxygenSaturationRecord
androidx.health.permission.OxygenSaturation.READ androidx.health.permission.OxygenSaturation.WRITE |
| 계획된 운동 운동 가이드 트레이닝 계획 가이드
|
활동 | PlannedExerciseSessionRecord
androidx.health.permission.PlannedExerciseSession.READ androidx.health.permission.PlannedExerciseSession.WRITE FEATURE_PLANNED_EXERCISE |
| 파워 운동 가이드
|
활동 | PowerRecord
androidx.health.permission.Power.READ androidx.health.permission.Power.WRITE 집계 데이터 유형POWER_AVGPOWER_MAXPOWER_MIN |
| 호흡수 활력 징후 가이드
|
Vitals | RespiratoryRateRecord
androidx.health.permission.RespiratoryRate.READ androidx.health.permission.RespiratoryRate.WRITE |
| 안정 시 심박수 바이탈 가이드
|
Vitals | RestingHeartRateRecord
androidx.health.permission.RestingHeartRate.READ androidx.health.permission.RestingHeartRate.WRITE 집계 데이터 유형BPM_AVGBPM_MAXBPM_MIN |
성적인 행위
|
생리 주기 모니터링 | SexualActivityRecord
androidx.health.permission.SexualActivity.READ androidx.health.permission.SexualActivity.WRITE |
| 피부 온도 활력 징후 가이드 피부 온도 측정 가이드
|
Vitals | SkinTemperatureRecord
FEATURE_SKIN_TEMPERATURE집계 데이터 유형TEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| 수면 세션 수면 가이드 수면 세션 추적 가이드
|
수면 | SleepSessionRecord
androidx.health.permission.SleepSession.READ androidx.health.permission.SleepSession.WRITE 집계 데이터 유형SLEEP_DURATION_TOTAL |
| 속도 운동 가이드
|
활동 | SpeedRecord
androidx.health.permission.Speed.READ androidx.health.permission.Speed.WRITE 집계 데이터 유형SPEED_AVGSPEED_MAXSPEED_MIN |
| 단계 운동 가이드 걸음 수 기록:
StepsCadenceRecord의 경우:
|
활동 | StepsRecord
StepsCadenceRecord
androidx.health.permission.Steps.READ androidx.health.permission.Steps.WRITE StepsRecord의 집계 데이터 유형COUNT_TOTALStepsCadenceRecord의 집계 데이터 유형RATE_AVGRATE_MAXRATE_MIN |
| 총 소모 칼로리 운동 가이드
|
활동 | TotalCaloriesBurnedRecord
androidx.health.permission.TotalCaloriesBurned.READ androidx.health.permission.TotalCaloriesBurned.WRITE 집계 데이터 유형ENERGY_TOTAL |
| 최대 산소 섭취량 운동 가이드
|
활동 | Vo2MaxRecord
androidx.health.permission.VO2Max.READ androidx.health.permission.VO2Max.WRITE |
무게
|
신체 측정 | WeightRecord
androidx.health.permission.Weight.READ androidx.health.permission.Weight.WRITE 집계 데이터 유형WEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| 휠체어 밀기 운동 가이드
|
활동 | WheelchairPushesRecord
androidx.health.permission.WheelchairPushes.READ androidx.health.permission.WheelchairPushes.WRITE 집계 데이터 유형COUNT_TOTAL |