이 페이지에서는 Health Connect API의 주요 기능을 설명합니다.
기록 및 데이터 동기화에 관한 CRUD 작업
플랫폼에서는 기록된 데이터의 표준 삽입, 업데이트, 삭제 기능을 제공합니다. 헬스 커넥트에는 클라이언트 앱이 헬스 커넥트 외부에서 데이터를 동기화할 수 있는 기능도 포함되어 있습니다. 이를 통해 특정 데이터 유형을 다른 앱이 삽입했는지 또는 삭제했는지를 개발자와 사용자에게 보여주는 데이터 변경사항 로그가 생성됩니다.
기본 집계 함수
클라이언트는 기본 데이터에 집계 함수를 적용하여 다음을 제공할 수 있습니다.
- 평균, 최솟값 또는 최댓값 값 (예: 활동 세션 중 최소 심박수, 최대 심박수)
- 총합계 (예: 일일 간격의 총 걸음 수)
- 기본 측정 횟수에 관한 간단한 수 (예: 지정된 주의 활동 세션 수)
- 지원되는 데이터 유형에 관한 총 시간 (예: 이번 주의 숙면 시간 또는 오늘의 총 활동 세션 시간)
사용 가능 여부 확인
헬스 커넥트는 Android SDK 버전 28(Pie) 이상과 호환됩니다. SDK를 사용하면 클라이언트 앱에서 Health Connect API가 사용자의 Android 기기에 있는지 확인할 수 있습니다. 기기에 없으면 헬스 커넥트에서 사용 가능 여부 확인을 트리거하여 사용자 기기가 호환되는지 확인합니다.
권한 확인
헬스 커넥트에서는 앱별로 건강 및 피트니스 데이터를 읽거나 쓰기 위해 사용자의 권한을 요청해야 합니다. 사용자가 이미 부여했거나 거부한 권한을 확인할 수도 있습니다.
헬스 커넥트로 읽기
포그라운드 읽기
포그라운드에서 실행되는 애플리케이션만 헬스 커넥트로 데이터를 읽을 수 있습니다. 이 제한사항은 사용자 개인 정보 보호를 더욱 강화하기 위해 마련되었습니다.
애플리케이션에 읽기를 표시하는 것과 같이 앱에 중단이 발생할 수 있는 상황에서는 헬스 커넥트에서 클라이언트 애플리케이션으로 직접 읽어보세요.
헬스 커넥트에서 다양한 데이터를 읽고 다른 곳에서 이를 쓰고 업로드하는 등 중단 없이 앱을 실행하고자 하는 경우에는 쉽게 닫을 수 있는 활동이 아닌 ForegroundService를 사용하세요.
백그라운드 읽기
애플리케이션이 백그라운드에서 실행되고 헬스 커넥트에서 데이터를 읽도록 요청할 수 있습니다. 백그라운드 읽기 권한을 요청하면 사용자는 앱에 백그라운드에서 데이터를 읽을 수 있는 액세스 권한을 부여할 수 있습니다.