헬스 커넥트 시작하기

이 가이드에서는 앱에서 헬스 커넥트를 사용하는 방법을 설명합니다.

1단계: 헬스 커넥트 앱 준비하기

헬스 커넥트 앱은 헬스 커넥트 SDK를 통해 전송합니다. 이러한 요청에는 읽기/쓰기 액세스 권한을 관리합니다

헬스 커넥트에 대한 액세스는 휴대전화에 설치된 Android 버전에 따라 다릅니다. 다음 섹션에서는 최신 Android 버전을 처리하는 방법을 간략히 설명합니다.

Android 14

Android 14 (API 수준 34)부터 헬스 커넥트는 Android 프레임워크입니다. 이 버전의 헬스 커넥트는 프레임워크 모듈입니다. 다음으로 바꿉니다. 별도의 설정이 필요하지 않습니다.

Android 13 및 이전 버전

Android 13 (API 수준 33) 이하 버전에서는 헬스 커넥트가 Android 프레임워크입니다. 이제 컨테이너 이미지를 Google Play 스토어에서 헬스 커넥트 앱을 다운로드합니다.

Android 13 이하에서 앱을 헬스 커넥트와 통합한 경우 Android 14에서 이전하려는 경우 다음을 참고하세요. Android 13에서 14로 이전

헬스 커넥트 앱 열기

헬스 커넥트가 더 이상 홈 화면에 기본적으로 표시되지 않습니다. 건강 앱 열기 연결하려면 설정 > 앱 > 헬스 커넥트 또는 헬스 커넥트 추가 대상: 빠른 설정 메뉴

또한 헬스 커넥트를 사용하려면 사용자에게 다음과 같이 화면 잠금을 사용 설정해야 합니다. 건강 데이터가 건강에 저장될 수 있도록 PIN, 패턴 또는 비밀번호 기기가 잠겨 있는 동안 악의적인 행위자로부터 Connect가 보호됩니다. 설정 설정 > 보안 > 화면 잠금

2단계: 앱에 헬스 커넥트 SDK 추가

Health Connect SDK는 Health Connect API를 사용하여 다음을 수행합니다. Health의 데이터 저장소에 대한 작업 수행 중 요청 전송 앱 연결

모듈 수준 build.gradle 파일에 헬스 커넥트 SDK 종속 항목을 추가합니다.

dependencies {
  ...
  implementation "androidx.health.connect:connect-client:1.1.0-alpha02"
  ...
}

최신 버전은 헬스 커넥트 출시 버전을 참고하세요.

3단계: 앱 구성

다음 섹션에서는 헬스 커넥트

권한 선언

건강/피트니스 데이터에 대한 액세스는 민감한 정보입니다. 헬스 커넥트는 읽기 및 쓰기 작업을 수행할 수 있도록 보안을 강화하여 사용자의 신뢰를 유지합니다.

다음을 기반으로 AndroidManifest.xml 파일에 대한 읽기 및 쓰기 권한 선언 필수 데이터 유형입니다. 자신이 만든 권한 집합을 사용해야 합니다. 귀하가 [양식]{:.external}을 작성한 후 에 대한 액세스를 요청했습니다.

헬스 커넥트는 표준 Android 권한 선언 형식을 사용합니다. <uses-permission> 태그를 사용하여 권한을 할당합니다. 다음 내에 중첩합니다. <manifest> 태그.

<manifest>
  <uses-permission android:name="android.permission.health.READ_HEART_RATE"/>
  <uses-permission android:name="android.permission.health.WRITE_HEART_RATE"/>
  <uses-permission android:name="android.permission.health.READ_STEPS"/>
  <uses-permission android:name="android.permission.health.WRITE_STEPS"/>

  <application>
  ...
  </application>
</manifest>

권한 및 해당 데이터 유형의 전체 목록은 다음을 참고하세요. 데이터 유형 목록.

앱의 개인정보처리방침 대화상자 표시

Android 매니페스트에는 앱의 앱이 요청된 권한의 근거인 개인정보처리방침을 제공합니다. 사용자의 데이터가 사용 및 처리되는 방식을 설명합니다.

ACTION_SHOW_PERMISSIONS_RATIONALE를 처리하도록 이 활동을 선언합니다. 사용자가 광고를 클릭할 때 이 인텐트가 앱으로 전송되는 인텐트에 헬스 커넥트 권한 화면의 개인정보처리방침 링크.

...
<application>
  ...
  <!-- For supported versions through Android 13, create an activity to show the rationale
       of Health Connect permissions once users click the privacy policy link. -->
  <activity
      android:name=".PermissionsRationaleActivity"
      android:exported="true">
    <intent-filter>
      <action android:name="androidx.health.ACTION_SHOW_PERMISSIONS_RATIONALE" />
    </intent-filter>
  </activity>

  <!-- For versions starting Android 14, create an activity alias to show the rationale
       of Health Connect permissions once users click the privacy policy link. -->
  <activity-alias
      android:name="ViewPermissionUsageActivity"
      android:exported="true"
      android:targetActivity=".PermissionsRationaleActivity"
      android:permission="android.permission.START_VIEW_PERMISSION_USAGE">
    <intent-filter>
      <action android:name="android.intent.action.VIEW_PERMISSION_USAGE" />
      <category android:name="android.intent.category.HEALTH_PERMISSIONS" />
    </intent-filter>
  </activity-alias>
  ...
</application>
...

헬스 커넥트 클라이언트 가져오기

HealthConnectClient는 Health Connect API의 진입점입니다. 앱이 헬스 커넥트 앱의 데이터 스토어를 사용할 수 있습니다. 그것은 기본 스토리지 레이어에 대한 연결을 자동으로 관리하고 발신 요청 및 수신 응답의 모든 IPC 및 직렬화

클라이언트 인스턴스를 가져오려면 다음과 같이 헬스 커넥트 패키지 이름을 선언합니다. Android 매니페스트를 참조하세요

<application> ... </application>
...
<!-- Check if Health Connect is installed -->
<queries>
    <package android:name="com.google.android.apps.healthdata" />
</queries>

그런 다음 활동에서 헬스 커넥트가 설치되어 있는지 확인합니다. getSdkStatus 사용 사용 가능한 경우 HealthConnectClient 인스턴스.

val availabilityStatus = HealthConnectClient.getSdkStatus(context, providerPackageName)
if (availabilityStatus == HealthConnectClient.SDK_UNAVAILABLE) {
  return // early return as there is no viable integration
}
if (availabilityStatus == HealthConnectClient.SDK_UNAVAILABLE_PROVIDER_UPDATE_REQUIRED) {
  // Optionally redirect to package installer to find a provider, for example:
  val uriString = "market://details?id=$providerPackageName&url=healthconnect%3A%2F%2Fonboarding"
  context.startActivity(
    Intent(Intent.ACTION_VIEW).apply {
      setPackage("com.android.vending")
      data = Uri.parse(uriString)
      putExtra("overlay", true)
      putExtra("callerId", context.packageName)
    }
  )
  return
}
val healthConnectClient = HealthConnectClient.getOrCreate(context)
// Issue operations with healthConnectClient

4단계: 사용자에게 권한 요청하기

클라이언트 인스턴스를 만든 후 앱은 있습니다. 사용자는 언제든지 권한을 부여하거나 거부할 수 있어야 합니다.

이를 위해 필요한 데이터 유형에 대한 권한 집합을 만듭니다. 집합의 권한이 Android 매니페스트에 먼저 선언됩니다.

// Create a set of permissions for required data types
val PERMISSIONS =
setOf(
  HealthPermission.getReadPermission(HeartRateRecord::class),
  HealthPermission.getWritePermission(HeartRateRecord::class),
  HealthPermission.getReadPermission(StepsRecord::class),
  HealthPermission.getWritePermission(StepsRecord::class)
)

getGrantedPermissions를 사용하여 앱에 이미 다음이 있는지 확인합니다. 필수 권한이 부여되었습니다. 그렇지 않은 경우 요청할 금액: createRequestPermissionResultContract 액세스할 수 있습니다 그러면 헬스 커넥트 권한 화면이 표시됩니다.

// Create the permissions launcher
val requestPermissionActivityContract = PermissionController.createRequestPermissionResultContract()

val requestPermissions = registerForActivityResult(requestPermissionActivityContract) { granted ->
  if (granted.containsAll(PERMISSIONS)) {
    // Permissions successfully granted
  } else {
    // Lack of required permissions
  }
}

suspend fun checkPermissionsAndRun(healthConnectClient: HealthConnectClient) {
  val granted = healthConnectClient.permissionController.getGrantedPermissions()
  if (granted.containsAll(PERMISSIONS)) {
    // Permissions already granted; proceed with inserting or reading data
  } else {
    requestPermissions.launch(PERMISSIONS)
  }
}

권한이 일정하다고 가정하지 않습니다. 사용자가 권한을 부여하거나 취소할 수 있기 때문입니다. 언제든지 변경할 수 있습니다. 앱이 부여된 권한을 주기적으로 확인해야 하며 권한이 손실되는 시나리오를 처리할 수 있습니다

5단계: 작업 수행하기

이제 모든 설정이 완료되었으므로 앱에서 읽기 및 쓰기 작업을 실행합니다.

데이터 쓰기

데이터를 레코드로 구조화합니다. 다음 목록을 확인해 보세요. 헬스 커넥트에서 사용할 수 있는 데이터 유형.

val stepsRecord = StepsRecord(
    count = 120,
    startTime = START_TIME,
    endTime = END_TIME,
    startZoneOffset = START_ZONE_OFFSET,
    endZoneOffset = END_ZONE_OFFSET,
)

그런 다음 insertRecords를 사용하여 레코드를 작성합니다.

suspend fun insertSteps(healthConnectClient: HealthConnectClient) {
    try {
        val stepsRecord = StepsRecord(
            count = 120,
            startTime = START_TIME,
            endTime = END_TIME,
            startZoneOffset = START_ZONE_OFFSET,
            endZoneOffset = END_ZONE_OFFSET,
        )
        healthConnectClient.insertRecords(listOf(stepsRecord))
    } catch (e: Exception) {
        // Run error handling here
    }
}

데이터 읽기

readRecords를 사용하여 데이터를 개별적으로 읽을 수 있습니다.

suspend fun readStepsByTimeRange(
    healthConnectClient: HealthConnectClient,
    startTime: Instant,
    endTime: Instant
) {
    try {
        val response =
            healthConnectClient.readRecords(
                ReadRecordsRequest(
                    StepsRecord::class,
                    timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
                )
            )
        for (stepRecord in response.records) {
            // Process each step record
        }
    } catch (e: Exception) {
        // Run error handling here.
    }
}

또한 다음을 사용하여 집계된 방식으로 데이터를 읽을 수 있습니다. aggregate

suspend fun aggregateSteps(
    healthConnectClient: HealthConnectClient,
    startTime: Instant,
    endTime: Instant
) {
    try {
        val response = healthConnectClient.aggregate(
            AggregateRequest(
                metrics = setOf(StepsRecord.COUNT_TOTAL),
                timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
            )
        )
        // The result may be null if no data is available in the time range
        val stepCount = response[StepsRecord.COUNT_TOTAL]
    } catch (e: Exception) {
        // Run error handling here
    }
}

동영상 튜토리얼

헬스 커넥트 기능을 자세히 설명하는 다음 동영상을 시청하세요. 다음은 원활한 통합을 위한 권장사항 가이드라인으로,

리소스

다음 리소스를 확인해 보세요. 살펴보겠습니다

  • 헬스 커넥트 SDK (Jetpack에서 사용 가능):SDK를 Health Connect API를 사용할 수 있습니다.
  • API 참조: 헬스 커넥트 API.
  • 데이터 유형 사용 선언: Play Console에서 헬스 커넥트 데이터 유형에 대한 액세스를 선언합니다. 데이터를 읽고 씁니다
  • GitHub 코드 샘플 및 Codelab(선택사항): GitHub 코드 샘플 참고 저장소Codelab 실습을 통해 시작됩니다
를 통해 개인정보처리방침을 정의할 수 있습니다.

다음 단계

일반적인 워크플로를 확인하여 헬스 커넥트: