이 페이지에는 자주 묻는 질문과 답변이 나열되어 있습니다.
Q: 헬스 커넥트는 Android 플랫폼에서만 사용할 수 있나요?
A: 예. Health Connect API와 헬스 커넥트 앱은 모두 Android 플랫폼에서만 사용할 수 있습니다.
Wear OS의 건강 센서 데이터 사용 사례는 Health Services API 문서를 참고하세요.
Q: 헬스 커넥트에 액세스하려면 어떻게 해야 하나요?
A: 헬스 커넥트에 액세스하는 방법은 기기에서 실행되는 Android 버전에 따라 다릅니다.
- Android 14에서 헬스 커넥트는 Android 시스템의 일부입니다. 설정 > 보안 및 개인 정보 보호 > 개인 정보 보호로 이동하여 헬스 커넥트를 찾아 헬스 커넥트에 액세스할 수 있습니다.
Android 13을 비롯하여 헬스 커넥트를 지원하는 이전 버전의 Android에서는 헬스 커넥트가 Google Play 스토어에서 다운로드할 수 있는 공개 앱입니다. 다음 방법 중 하나를 통해 앱에 액세스할 수 있습니다.
- 설정 > 앱으로 이동하여 헬스 커넥트를 찾아 엽니다.
- 작업 표시줄에 있는 빠른 설정을 사용하여 헬스 커넥트에 대한 빠른 액세스를 구성합니다.
- 헬스 커넥트의 Google Play 스토어 페이지로 이동하여 열기를 탭합니다.
Q: Android 13에서 Android 14로 건강 데이터를 이전하려면 어떻게 해야 하나요?
A: Android 14로 업그레이드하는 즉시 Android 13용 헬스 커넥트 APK에서 Android 14용 헬스 커넥트 시스템 앱으로의 이전이 자동으로 시작됩니다.
이전 중에 Android 14 API는 '이전 진행 중' 상태로 정지됩니다. 상태는 헬스 커넥트 UI에도 표시됩니다. 이전이 완료되면 독립형 헬스 커넥트 APK를 제거할 수 있습니다.
자세한 내용은 Android 13에서 Android 14로의 이전 가이드를 참고하세요.
Q: 헬스 커넥트는 Google Play 서비스가 설치되어 있지 않은 Android 휴대전화를 지원하나요?
A: 아니요. 헬스 커넥트에는 휴대기기에 Android 9(API 28) 이상이 적용되고 Google Play 서비스가 설치되어야 하는 등 특정 호환성 요구사항이 있습니다.
Q: 헬스 커넥트는 Google 피트니스와 어떻게 다른가요?
A: 다음 표는 두 API의 주요 아키텍처 차이를 설명합니다.
| 헬스 커넥트 | Google 피트니스 |
|---|---|
| 기기 중심 헬스 커넥트는 기기 중심입니다. 데이터는 특정 Google 계정과 연결되지 않고 사용자 기기에 저장됩니다. | Google 계정 중심 Google 피트니스는 계정 중심입니다. 데이터는 서버 측 인프라에 저장됩니다. 데이터 모델은 사용자의 기기가 아닌 특정 Google 계정에 전적으로 연결되어 있습니다. 따라서, 서버가 Google 피트니스의 정보 소스가 됩니다. |
| 세분화된 권한
사용자는 헬스 커넥트를 통해 각 데이터 유형의 읽기 또는 쓰기 액세스 권한을 가진 앱을 세밀하게 제어할 수 있습니다. |
OAuth 기반 권한
Google 피트니스의 권한은 OAuth 인증을 기반으로 하므로 추가 작업이 필요합니다. OAuth 범위에는 더 많은 수의 데이터 유형이 포함될 수도 있습니다. |
| 가벼운 데이터 처리 헬스 커넥트는 데이터 처리와 여기에서 파생되는 작업이 거의 없으며 기초 칼로리 및 기초 대사율(BMR)과 같은 일부 데이터 유형의 소수 예외가 있습니다. 따라서 개발자는 헬스 커넥트로 더 많은 원시 데이터에 액세스할 수 있습니다. | 서비스별 데이터 처리 Google 피트니스는 더 많은 데이터를 처리하여 일부 데이터 유형을 다른 데이터 유형으로 변환하거나 병합합니다. Google 피트니스는 헬스 커넥트와 같이 원시 데이터에 액세스할 수 있는 권한을 제공하는 대신 특정 서비스의 데이터를 처리합니다. |
Q: 헬스 커넥트 저장소는 기기에 있나요? 아니면 클라우드를 기반으로 하나요?
A: 헬스 커넥트는 기기 내 저장소를 제공합니다. Google의 목표는 사용자가 데이터를 공유하는 앱 및 서비스와 더불어 데이터도 완전히 제어할 수 있는 시스템을 만드는 것입니다.
Q: 헬스 커넥트 앱을 사용할 수 있는 휴대기기는 무엇인가요?
A: Android 9 (API 28) 이상이 적용된 휴대기기에서만 헬스 커넥트 앱을 사용할 수 있습니다. 이러한 기기에는 Google Play 서비스도 설치되어 있어야 합니다.
Q: Jetpack에 자바 SDK가 있나요? 최종적으로 추가될 예정인가요?
A: 헬스 커넥트 SDK는 Kotlin으로만 사용할 수 있습니다. 현재 Jetpack 라이브러리에 Java SDK를 추가할 계획은 없습니다. 그러나 개발자 의견에 따라 최종적으로 두 프로그래밍 언어를 모두 지원할 수도 있습니다.
Q: 헬스 커넥트에서 읽거나 쓸 수 있는 과거 데이터의 범위는 무엇인가요?
A: 헬스 커넥트를 사용하면 앱의 첫 번째 성공적인 권한 요청 전 최대 30일의 time 또는 startTime이 포함된 기록을 앱에서 읽을 수 있습니다. 앱에서 30일 후에 레코드를 읽도록 하려면 PERMISSION_READ_HEALTH_DATA_HISTORY 권한을 사용하세요. 앱을 제거한 후 다시 설치하면 날짜가 재설정되어 처음 사용하는 것처럼 새 시작일로 표시됩니다.
헬스 커넥트와 공유하는 데이터에는 제한이 없지만 지금은 많은 양의 과거 데이터를 쓰지 않는 것이 좋습니다. 마찬가지로, 예측된 MenstruationPeriodRecord와 같은 향후 이벤트와 관련된 데이터를 작성하지 마세요.
Q: 헬스 커넥트 통합과 관련하여 도움이 필요한 경우 어디에 문의해야 하나요?
A: 헬스 커넥트 통합에 관한 기술적인 질문이나 문제 또는 우려사항이 있으면 health-connect-support@google.com으로 문의하세요.
Google 지원 담당자는 개발자의 질문에 최대한 빠르고 종합적으로 답변해 드리기 위해 노력하고 있습니다. 그동안 도움이 필요하면 헬스 커넥트 문서를 참고하세요.
Q: 데이터 유형 읽기 또는 쓰기 액세스 권한을 선언하려면 어떻게 해야 하나요?
A: 앱이 헬스 커넥트 데이터 유형에 대한 읽기 또는 쓰기 액세스 권한을 갖게 하려면 Play Console을 사용하여 앱이 이러한 유형에 액세스한다고 선언하세요.