스마트폰 속 삼성 헬스 데이터를
내 앱에서 활용하기

Data SDK란 무엇인가?

삼성 헬스 Data SDK는 스마트폰에 저장되어 있는 삼성 헬스 데이터를 다른 앱에서 사용할 수 있도록 제공하는 SDK입니다.

사용자의 갤럭시 워치·갤럭시 링·스마트폰 센서가 측정한 건강 데이터는 삼성 헬스 앱의 암호화된 저장소(Health Data Store)에 모입니다. Data SDK는 이 "기기 안(on-device)"에 저장된 데이터에 사용자 동의를 받아 접근하는 통로 역할을 합니다. 즉, 서버 API가 아니라 스마트폰 로컬 데이터를 직접 읽고 쓰는 방식입니다.

왜 Data SDK를 사용할까?

삼성이 공식적으로 내세우는 세 가지 핵심 가치입니다.

시작 전 요구사항

Data SDK를 사용하려면 아래 환경이 갖춰져야 합니다.

Samsung Health Data SDK로 얻을 수 있는 데이터

신규 Samsung Health Data SDK는 25종의 데이터 타입을 DataTypes로 제공합니다. 아래는 6개 카테고리로 정리한 실제 지원 타입이며, 각 타입의 읽기·쓰기 지원 여부를 색으로 표시했습니다.

권한 모델 — 사용자 동의가 핵심

건강 데이터는 민감 정보이므로, 앱은 데이터 타입별 + 접근 종류별로 권한을 따로 요청해야 합니다. 권한 단위는 Permission.of(데이터타입, 접근종류) 형태입니다.

object Permissions {
    val PERMISSIONS = setOf<Permission>(
        Permission.of(DataTypes.STEPS,      AccessType.READ),
        Permission.of(DataTypes.STEPS_GOAL, AccessType.READ),
        Permission.of(DataTypes.HEART_RATE, AccessType.READ)
    )
}

핵심 구성요소

Data SDK를 다룰 때 꼭 알아야 할 클래스들입니다.

데이터 연산 5종

Data SDK가 제공하는 작업(operation)입니다. 데이터 타입마다 지원하는 연산이 다릅니다.

사용 흐름 5단계

실제 앱에서 데이터를 활용하기까지의 전체 과정입니다.

실전 코드 예제

① Gradle 의존성

// app/libs 폴더에 samsung-health-data-api-1.1.0.aar 추가 후
dependencies {
    implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar"))))
    implementation(libs.gson)
}

② Store 생성 & 권한 요청

val healthDataStore = HealthDataService.getStore(applicationContext)

// 권한 요청 (사용자 동의 화면 표시)
healthDataStore.requestPermissions(Permissions.PERMISSIONS, activity)

// 실제 승인된 권한 확인
val granted = healthDataStore.getGrantedPermissions(Permissions.PERMISSIONS)
if (granted.containsAll(Permissions.PERMISSIONS)) {
    // 데이터 접근 가능
}

③ 심박수 읽기 (기간 필터)

suspend fun readHeartRate(start: LocalDateTime, end: LocalDateTime) {
    val store = HealthDataService.getStore(applicationContext)
    val timeFilter = LocalTimeFilter.of(start, end)

    val request = DataTypes.HEART_RATE.readDataRequestBuilder
        .setLocalTimeFilter(timeFilter)
        .setOrdering(Ordering.DESC)
        .build()

    val heartRateList = store.readData(request).dataList
    heartRateList.forEach { point -> /* point 값 사용 */ }
}

④ 특정 기기 데이터만 조회 (출처 필터)

// 갤럭시 워치가 측정한 데이터만
val request = DataTypes.HEART_RATE.readDataRequestBuilder
    .setSourceFilter(ReadSourceFilter.fromDeviceType(DeviceGroup.WATCH))
    .setLocalTimeFilter(timeFilter)
    .setOrdering(Ordering.ASC)
    .build()

// 또는 현재 스마트폰(로컬 기기)이 측정한 데이터만
// .setSourceFilter(ReadSourceFilter.fromLocalDevice())

⑤ 걸음 수 집계 (TOTAL)

val result = healthDataStore.aggregateData(aggregateRequest)
var stepCount = 0L
result.dataList.forEach { aggregated ->
    aggregated.value?.let { stepCount = it }   // 기간 내 총 걸음 수 합산
}

참고 자료

아래는 본 강의 자료의 출처이자, 더 깊이 학습할 수 있는 공식 문서 링크입니다.