[안드로이드] 헬스커넥터로 삼성 헬스케어 걸음수 연동하기

Health Connect란?

Google의 Health Connect는 다양한 건강 관련 데이터를 통합 관리할 수 있도록 도와주는 API이다.

이를 활용하면 삼성 헬스케어 같은 앱에서 걸음 수 데이터를 읽어와서 활용할 수 있다.

1. 프로젝트 설정 (Gradle 설정 포함)

먼저 build.gradle.kts(Module:app) 파일에 Health Connect 라이브러리를 추가한다.

dependencies {
    implementation("androidx.health.connect:connect-client:1.1.0-alpha10")
}

 

2. Health Connect SDK 상태 확인 및 설치 유도

Health Connect가 기기에 설치되지 않았거나 최신 버전이 아니라면, Play Store에서 설치하도록 유도해야 한다.

다음 코드는 앱이 실행될 때 Health Connect가 설치되지 않았다면 Play Store로 이동하도록 처리한다.

private fun checkInstallHC() {
    val providerPackageName = "com.google.android.apps.healthdata"
    val availabilityStatus = HealthConnectClient.getSdkStatus(this, providerPackageName)

    if (availabilityStatus == HealthConnectClient.SDK_UNAVAILABLE ||
        availabilityStatus == HealthConnectClient.SDK_UNAVAILABLE_PROVIDER_UPDATE_REQUIRED) {
        Toast.makeText(this, "헬스 커넥트 앱을 설치 또는 업데이트 해주세요", Toast.LENGTH_SHORT).show()
        openPlayStoreForHealthConnect()
    }
}

private fun openPlayStoreForHealthConnect() {
    val intent = Intent(Intent.ACTION_VIEW).apply {
        data = Uri.parse("https://play.google.com/store/apps/details?id=com.google.android.apps.healthdata")
        setPackage("com.android.vending")
    }
    startActivity(intent)
}

 

3. 권한 요청 및 처리 방법

Health Connect를 통해 걸음 수 데이터를 읽어오려면 READ 및 WRITE 권한이 필요하다.

아래 코드에서 권한을 요청하는 방법을 확인할 수 있다.

val PERMISSIONS = setOf(
    HealthPermission.getReadPermission(StepsRecord::class),
    HealthPermission.getWritePermission(StepsRecord::class)
)

private fun requestHealthPermissions() {
    val requestPermissionActivityContract = PermissionController.createRequestPermissionResultContract()
    val requestPermissions = registerForActivityResult(requestPermissionActivityContract) { granted ->
        if (granted.containsAll(PERMISSIONS)) {
            readStepsByTimeRange()
        } else {
            Toast.makeText(this, "앱 권한 → '걸음 수'를 활성화 해주세요.", Toast.LENGTH_LONG).show()
        }
    }
    requestPermissions.launch(PERMISSIONS)
}

 

4. 걸음 수 데이터 읽기

이제 readStepsByTimeRange 함수를 구현하여 사용자의 걸음 수 데이터를 가져올 수 있다.

private suspend fun readStepsByTimeRange() {
    try {
        val response = healthConnectClient.readRecords(
            ReadRecordsRequest(
                StepsRecord::class,
                timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
            )
        )
        
        if (response.records.isEmpty()) {
            mViewModel.totalSteps.value = "0"
        } else {
            mViewModel.totalSteps.value = response.records[0].count.toString()
        }
    } catch (e: Exception) {
        Log.e("HealthConnect", "걸음 수 데이터를 가져오는 중 오류 발생: $e")
    }
}

 

5. ViewModel을 이용한 데이터 관리

ViewModel을 활용하면 걸음 수 데이터를 앱의 UI에서 쉽게 관리할 수 있다.

class MainViewModel: ViewModel() {
    val totalSteps = MutableLiveData<String>()
}

 

6. 결과 확인 및 로그 출력

앱을 실행하면 Health Connect에서 삼성 헬스케어의 걸음 수 데이터를 불러와 UI에 반영할 수 있다.

로그를 통해 데이터를 확인할 수 있다.

Log.v("Total Steps", "걸음 수: ${mViewModel.totalSteps.value}")

 

전체코드

<MainActivity>

package com.lion.walk_hyein

import android.content.Context
import android.content.Intent
import android.net.Uri
import android.os.Bundle
import android.util.Log
import android.widget.Toast
import androidx.activity.enableEdgeToEdge
import androidx.activity.result.ActivityResultLauncher
import androidx.activity.viewModels
import androidx.appcompat.app.AppCompatActivity
import androidx.health.connect.client.HealthConnectClient
import androidx.health.connect.client.PermissionController
import androidx.health.connect.client.permission.HealthPermission
import androidx.health.connect.client.records.StepsRecord
import androidx.health.connect.client.request.ReadRecordsRequest
import androidx.health.connect.client.time.TimeRangeFilter
import androidx.lifecycle.lifecycleScope
import com.lion.test3.MainViewModel
import kotlinx.coroutines.launch
import java.time.LocalDateTime
import java.time.LocalTime
import java.time.ZoneOffset
import kotlin.getValue

class MainActivity : AppCompatActivity() {

    lateinit var requestPermissions : ActivityResultLauncher<Set<String>>
    lateinit var  healthConnectClient : HealthConnectClient
    private val mViewModel: MainViewModel by viewModels()

    val endTime = LocalDateTime.now()
    val startTime = LocalDateTime.of(endTime.toLocalDate(), LocalTime.MIDNIGHT)

    val startTimeInstant = startTime.atZone(ZoneOffset.UTC).toInstant()
    val endTimeInstant = endTime.atZone(ZoneOffset.UTC).toInstant()


    val PERMISSIONS = setOf(
            HealthPermission.getReadPermission(StepsRecord::class),
            HealthPermission.getWritePermission(StepsRecord::class))

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()
        setContentView(R.layout.activity_main)
        lifecycleScope.launch {
            checkInstallHC()
        }
    }

    //헬스커넥트 설치, 버전, 권한 여부 확인
    private fun checkInstallHC (){
        val providerPackageName = "com.google.android.apps.healthdata"
        val availabilityStatus = HealthConnectClient.getSdkStatus(this, providerPackageName)

        //헬스 커넥트 앱이 없을 때
        if (availabilityStatus == HealthConnectClient.SDK_UNAVAILABLE) {
            Toast.makeText(this, "헬스 커넥트 앱을 설치 또는 업데이트 해주세요", Toast.LENGTH_SHORT).show()
            finish()
            //헬스 커넥트 플레이스토어 이동
            openPlayStoreForHealthConnect()
        }

        //헬스 커넥트 앱이 최신 버전이 아닐때
        if (availabilityStatus == HealthConnectClient.SDK_UNAVAILABLE_PROVIDER_UPDATE_REQUIRED) {
            Toast.makeText(this, "헬스 커넥트 앱을 설치 또는 업데이트 해주세요", Toast.LENGTH_SHORT).show()
            finish()
            //헬스 커넥트 플레이스토어 이동
            openPlayStoreForHealthConnect()
        }

        healthConnectClient = HealthConnectClient.getOrCreate(this)

        // 권한(permission)이 부여되어 있는지 확인
        val requestPermissionActivityContract = PermissionController.createRequestPermissionResultContract()
        requestPermissions = registerForActivityResult(requestPermissionActivityContract) { granted ->
            //권한이 부여된 상태
            if (granted.containsAll(PERMISSIONS)) {
                Log.d("Permission", "PermissionO : $healthConnectClient")
                lifecycleScope.launch {
                    Log.d("TimeRange", "Start Time: $startTimeInstant, End Time: $endTimeInstant")
                    readStepsByTimeRange(healthConnectClient)
                }
            }
            //권한이 부여되지 않은 상태라면
            else {
                Log.d("Permission", "PermissionX : $healthConnectClient")
                //권한 설정 화면으로 이동
                movePermissionSetting(this)
            }
        }

        requestPermissions.launch(PERMISSIONS)
    }

    //헬스 커넥트 플레이스토어 이동
    private fun openPlayStoreForHealthConnect(){
        val intent = Intent(Intent.ACTION_VIEW).apply {
            data = Uri.parse("https://play.google.com/store/apps/details?id=com.google.android.apps.healthdata")
            setPackage("com.android.vending")
        }
        startActivity(intent)
    }

    //권한 설정 화면으로 이동
    private fun movePermissionSetting(context: Context) {
        val packageName = "com.google.android.apps.healthdata"
        val intent = packageManager.getLaunchIntentForPackage(packageName)
        context.startActivity(intent)
        Toast.makeText(context, "앱 권한 → '걸음 수'를 활성화 해주세요.", Toast.LENGTH_LONG).show()
    }


    private suspend fun readStepsByTimeRange(
        healthConnectClient: HealthConnectClient,
    ) {
        try {
            val response = healthConnectClient.readRecords(
                ReadRecordsRequest(
                    StepsRecord::class,
                    timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
                )
            )
            mViewModel.totalSteps.value = response.records[0].count.toString()

            // records가 비어있는지 확인하고, 로그 출력
            if (response.records.isEmpty()) {
                Log.v("Total Steps", "데이터 없음 - records 비어있음")
                mViewModel.totalSteps.value = "0"
            } else {
                mViewModel.totalSteps.value = response.records[0].count.toString()
                Log.v("Total Steps", "실행됨 : ${mViewModel.totalSteps.value}")
            }

        } catch (e: Exception) {
            Log.v("Total Steps", "실행 안됨 : $e")
        }
    }
}

 

<MainViewModel>

package com.lion.walk_hyein

import androidx.lifecycle.MutableLiveData
import androidx.lifecycle.ViewModel

class MainViewModel: ViewModel() {
    val totalSteps = MutableLiveData<String>()
}

 

<build.gradle.kts(Module:app)>

plugins {
    alias(libs.plugins.android.application)
    alias(libs.plugins.kotlin.android)
}

android {
    namespace = "com.lion.walk_hyein"
    compileSdk = 35

    defaultConfig {
        applicationId = "com.lion.walk_hyein"
        minSdk = 26
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"

        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_11
        targetCompatibility = JavaVersion.VERSION_11
    }
    kotlinOptions {
        jvmTarget = "11"
    }
}

dependencies {

    implementation(libs.androidx.core.ktx)
    implementation(libs.androidx.appcompat)
    implementation(libs.material)
    implementation(libs.androidx.activity)
    implementation(libs.androidx.constraintlayout)
    testImplementation(libs.junit)
    androidTestImplementation(libs.androidx.junit)
    androidTestImplementation(libs.androidx.espresso.core)
    implementation("androidx.health.connect:connect-client:1.1.0-alpha10")
}

 

⚠️ 헬스커넥터의 연동의 개인차가 크다. 나는 구현이 끝나자마자 바로 연동되어 정상적으로 작동하였지만, 다른 팀원분들은 몇시간 뒤에 정상 작동 되기도 하고, 며칠 뒤에 정상작동 되기도 하였다.

🚀 응용하여 소모 칼로리, 심박수, 수면 데이터 등 다양한 건강 데이터를 불러올수도 있다 

 

 

참고 문서

https://developer.android.com/health-and-fitness/guides/health-connect/develop/get-started?hl=ko

헬스 커넥트 시작하기  |  Android health & fitness  |  Android Developers

https://developer.android.com/health-and-fitness/guides/health-connect?hl=ko

헬스 커넥트  |  Android health & fitness  |  Android Developers