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