이전 가이드

Google의 포트폴리오에는 헬스 커넥트를 비롯하여 다양한 건강 관리 제품 및 서비스가 있습니다. Google Fit API는 지원 중단되었으며 2025년 6월 30일까지 지원 중단될 예정입니다. 다음 가이드라인은 각 Google 피트니스 Android API에서 어느 API 또는 플랫폼으로 이전해야 하는지 보여줍니다.

피트니스 Android API에서 Health Connect API로 이전

Health Connect API로 이전하려면 3가지 주요 단계를 거쳐야 합니다.

1단계: 통합

통합의 첫 번째 단계는 앱에 헬스 커넥트를 추가하는 것입니다. 여기에는 다음과 같은 작업이 포함됩니다.

  • 시작하기 단계에 따라 헬스 커넥트와 통합합니다.
  • 앱 매니페스트에 필요한 데이터 유형과 액세스 모드를 선언합니다.
  • 사용자에게 헬스 커넥트에 액세스할 권한을 받습니다.
  • 특정 사용 사례 또는 워크플로에 따라 데이터를 읽고 씁니다.

2단계: 이전

사용자가 한 플랫폼에서 다른 플랫폼으로 이전하는 동안 Google 피트니스 Android API와 Health Connect API 통합을 모두 활성 상태로 유지하는 것이 좋습니다. Google 피트니스 Android API는 지원 중단되지만 2025년 6월 30일 이후 API를 중단할 계획입니다. 이는 사용자가 헬스 커넥트로 전환하여 서비스를 계속 이용할 수 있도록 충분한 시간을 제공하기 위한 것입니다.

3단계: 삭제

Google 피트니스 SDK를 삭제하려면 다음 단계를 따르세요.

  1. Google 피트니스 Android API와 연결된 코드를 삭제합니다.
  2. Google Play 서비스 종속 항목을 삭제합니다.

Sensor API

Sensor API를 사용하면 앱에서 실시간으로 원시 센서 데이터를 읽을 수 있습니다. Sensor API는 다음 작업을 실행합니다.

  • 기기 및 호환 기기에서 사용할 수 있는 데이터 소스를 나열합니다.
  • 원시 센서 데이터를 수신하도록 리스너를 등록합니다.
  • 더 이상 원시 센서 데이터를 수신하지 않도록 리스너 등록을 취소합니다.

센서 API에서 다음 API 또는 플랫폼으로 이전

스마트폰 Wear

SensorManager, FusedLocationProvider 사용

건강 관리 서비스 사용

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    또는 SensorManager, FusedLocationProvider 사용

Session API

세션은 사용자가 피트니스 활동을 하는 동안의 시간 인터벌을 나타냅니다.

Session API를 사용하면 앱에서 피트니스 저장소에 세션을 만들 수 있습니다.

Session API에서 다음 API 또는 플랫폼으로 이전

스마트폰 Wear

시작/중지: 관련 없음. 애플리케이션은 내부적으로 진행 중인 세션의 상태를 추적해야 합니다.

읽기/쓰기: 헬스 커넥트를 사용합니다.

시작/중지: 건강 관리 서비스(ExerciseClient) 사용

읽기/쓰기: 모바일 앱을 통해 헬스 커넥트를 사용합니다.

특정 워크플로의 경우 다음을 권장합니다.

  • 세션 삽입: 개발자는 모바일 앱을 통해 헬스 커넥트를 사용하고 이에 따라 ExerciseSession 레코드 또는 SleepSession 레코드를 삽입해야 합니다.

Recording API

Recording API를 사용하면 앱에서 구독을 만들어 배터리 효율적인 방식으로 센서 데이터를 자동으로 저장하도록 요청할 수 있습니다. 구독은 Android 앱과 연결되며 피트니스 데이터 유형 또는 특정 데이터 소스로 구성됩니다.

Recording API에서 다음 API 또는 플랫폼으로 이전

스마트폰 Wear

Recording API에서 이전하려면 다음 단계를 따르세요.

  1. 모바일에서 Recording API를 사용하여 데이터 캡처를 구현합니다.
  2. 캡처된 데이터를 헬스 커넥트 또는 앱 데이터베이스에 씁니다.

건강 관리 서비스 사용

  • PassiveMonitoringClient
  • ExerciseClient

PassiveMonitoringClient와 ExerciseClient의 차이점에 관한 자세한 내용은 건강 관리 서비스 문서를 참고하세요.

History API

History API를 사용하면 앱이 피트니스 저장소에서 이전의 건강 및 웰빙 데이터를 읽고 삽입하고 업데이트하고 삭제하는 등의 일괄 작업을 실행할 수 있습니다.

History API에서 다음 API 또는 플랫폼으로 이전

스마트폰 Wear

헬스 커넥트 사용

웨어러블 기기가 아닌 모바일 앱에서 헬스 커넥트를 사용합니다.

Goals API

목표는 사용자가 직접 설정할 수 있는 Google 피트니스 앱의 타겟입니다. 목표를 통해 사용자가 매일 활동적인 상태를 유지하도록 동기부여합니다. 사용자는 프로필 내에서 매일 달성하고자 하는 걸음 수와 심장 강화 점수를 조정할 수 있습니다. 피트니스 플랫폼은 Goals API를 사용하여 목표를 기록하고 목표와 관련된 일별 활동을 추적합니다.

스마트폰 Wear
사용할 수 있는 대체 API가 없습니다. 사용할 수 있는 대체 API가 없습니다.

BLE API

앱에서 BLE API를 사용하여 사용 가능한 저전력 블루투스(BLE) 기기를 찾아 Google 피트니스 플랫폼에 센서 데이터를 삽입할 수 있습니다.

BLE API에서 다음 API 또는 플랫폼으로 이전

스마트폰 Wear
Android Bluetooth API를 직접 사용합니다. Android Bluetooth API를 직접 사용합니다.