@capgo/capacitor-health

개요

@capgo/capacitor-health 다음을 통해 사용자 건강 데이터를 읽고 씁니다: Apple HealthKit iOS의 Health Connect Android에서 사용합니다. 앱 레이어에서 두 개의 별도 네이티브 SDK 통합을 유지할 필요 없이 걸음 수, 운동, 수면 단계, 생체 신호, 영양 샘플에 활용하세요.

피트니스 대시보드, 습관 앱, 임상 인접 웰니스 제품, 기업 웰니스 프로그램은 보통 다음으로 시작합니다: requestAuthorization, 그 다음 readSamples 또는 saveSample 관심 있는 지표를 위해

플랫폼 지원

플랫폼	지원	참고 사항
iOS	지원	HealthKit 권한 및 샘플
Android	지원	Health Connect, 약 30일이 지난 데이터 읽기를 위한 선택적 기록 권한
웹	제한적	isAvailable 지원되지 않는 네이티브 SDK 보고

Android 전용 헬퍼: openHealthConnectSettings, showPrivacyPolicy.

핵심 기능

• isAvailable - 현재 플랫폼이 네이티브 헬스 SDK를 지원하는지 반환합니다.
• requestAuthorization - 제공된 데이터 유형에 대한 읽기/쓰기 접근 권한을 요청합니다.
• checkAuthorization - 사용자에게 프롬프트 없이 제공된 데이터 유형의 권한 상태를 확인합니다.
• readSamples - 지정된 시간 범위 내에서 주어진 데이터 유형의 샘플을 읽습니다.

공개 API

메서드	설명
isAvailable	현재 플랫폼에서 네이티브 health SDK를 지원하는지 여부를 반환합니다.
requestAuthorization	제공된 데이터 타입에 대한 읽기/쓰기 권한을 요청합니다.
checkAuthorization	사용자에게 프롬프트를 표시하지 않고 제공된 데이터 타입의 권한 상태를 확인합니다.
readSamples	지정된 시간 범위 내에서 해당 데이터 타입의 샘플을 읽습니다.
saveSample	네이티브 health 스토어에 단일 샘플을 기록합니다.
getPluginVersion	네이티브 Capacitor 플러그인 버전을 가져옵니다.
openHealthConnectSettings	Health Connect 설정 화면을 엽니다 (Android 전용). iOS에서 이 메서드는 아무 동작도 하지 않습니다.
showPrivacyPolicy	Health Connect(안드로이드 전용)의 앱 개인정보 처리방침을 표시합니다. iOS에서는 이 메서드가 아무 동작도 하지 않습니다.
queryWorkouts	네이티브 헬스 스토어에서 운동 세션을 조회합니다. iOS(HealthKit)와 안드로이드(Health Connect)에서 지원됩니다.
queryAggregated	네이티브 헬스 스토어에서 집계된 헬스 데이터를 조회합니다. 데이터를 시간, 일, 주, 월 단위 버킷으로 집계하며 sum, average, min, max와 같은 연산을 수행합니다. 넓은 날짜 범위의 경우 개별 샘플을 가져오는 것보다 효율적입니다.

Source of Truth

이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-health.

@capgo/capacitor-health에서 계속하기

사용 중이라면 @capgo/capacitor-health 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-health 사용하기 @capgo/capacitor-health 사용하기의 네이티브 기능을 위해, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.