본문으로 건너뛰기
@capgo/capacitor-건강 기기 API 오픈 소스

건강 Capacitor 플러그인

자연스러운 건강 및 피트니스 데이터에 액세스

설치

bun add @capgo/capacitor-health bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-health
  • pnpm add @capgo/capacitor-health
  • yarn add @capgo/capacitor-health

가이드

Capacitor을 사용하는 방법

capgo/capacitor-health를 사용하는 방법

Capacitor 플러그인을 사용하여 애플 헬스 키트와 헬스 커넥트의 데이터와 상호 작용합니다.

설치

bun add @capgo/capacitor-health
bunx cap sync

bunx cap sync code의 네이티브 버전을 프로젝트에 복사합니다. 플러그인 업그레이드 후 다시 실행하세요.

임포트

import { Health } from '@capgo/capacitor-health';

API를 한눈에

방법 설명
isAvailable SDK이 현재 플랫폼에서 지원하는지 여부를 반환합니다.
requestAuthorization __CAPGO_KEEP_0__에 대한 읽기/쓰기 접근 권한을 제공된 데이터 유형에 요청합니다.
checkAuthorization __CAPGO_KEEP_0__에 대한 인증 상태를 제공된 데이터 유형에 대해 확인합니다. 사용자에게 프롬프트를 표시하지 않습니다.
readSamples __CAPGO_KEEP_0__
saveSample __CAPGO_KEEP_0__
openHealthConnectSettings 안드로이드에서만 사용할 수 있는 Health Connect 설정 화면을 열립니다. iOS에서는 아무런 동작도 하지 않습니다.
showPrivacyPolicy 안드로이드에서만 사용할 수 있는 Health Connect의 개인 정보 보호 정책을 표시합니다. iOS에서는 아무런 동작도 하지 않습니다.
queryWorkouts iOS(HealthKit)와 안드로이드(Health Connect)에서 지원하는 native health store에서 운동 세션을 조회합니다.
queryAggregated native health store에서 aggregated health 데이터를 조회합니다. 데이터를 시간 단위로 bucket으로 나누고(1시간, 1일, 1주, 1달) sum, average, min, max와 같은 연산을 수행합니다. 큰 날짜 범위에 대한 개별 샘플을 조회하는 것보다 더 효율적입니다.

예시

isAvailable()

현재 플랫폼이 네이티브 헬스 SDK를 지원하는지 여부를 반환합니다.

import { Health } from '@capgo/capacitor-health';

const result = await Health.isAvailable();
console.log(result);

requestAuthorization()

제공된 데이터 유형에 대한 읽기/쓰기 접근을 요청합니다.

import { Health } from '@capgo/capacitor-health';

const result = await Health.requestAuthorization({ read: ['steps'] });
console.log(result);

checkAuthorization()

사용자에게 동의를 요청하지 않고 제공된 데이터 유형에 대한 인증 상태를 확인합니다.

import { Health } from '@capgo/capacitor-health';

const result = await Health.checkAuthorization({ read: ['steps'] });
console.log(result);

readSamples()

__CAPGO_KEEP_0__

import { Health } from '@capgo/capacitor-health';

const result = await Health.readSamples({ dataType: 'steps' });
console.log(result);

saveSample()

__CAPGO_KEEP_0__

import { Health } from '@capgo/capacitor-health';

await Health.saveSample({
  dataType: 'steps',
  value: 1,
});

openHealthConnectSettings()

Android에서만 Health Connect 설정 화면을 열립니다. iOS에서는 이 메서드는 아무런 동작도 하지 않습니다.

import { Health } from '@capgo/capacitor-health';

await Health.openHealthConnectSettings();

위 표에 나열된 9개의 핵심 메서드는 모두 문서화되어 있습니다. 리스너 및 버전 헬퍼, 각 메서드의 전체 계약은 __CAPGO_KEEP_0__ repository에 문서화되어 있습니다. GitHub 저장소.

전체 참조

@capgo/capacitor-health

Capacitor-Health를 사용하여 native 플러그인 작업을 계획하고 있으시다면 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-health와 연결해 주세요. Capacitor-Health를 사용하여 native 플러그인 작업을 계획하고 있으시다면 @capgo/capacitor-health와 연결해 주세요. native 플러그인 작업을 계획하려면 연결하세요 Capacitor-Health를 사용하여 native 플러그인 작업을 계획하고 있으시다면 @capgo/capacitor-health와 연결해 주세요. capgo/capacitor-health에 대한 구현 세부 사항에 대해 시작하기 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-health에 대한 구현 세부 사항에 대해 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에 대한 제품 워크플로에 대해 Capacitor 플러그인들 - Capgo Capacitor 플러그인들 - Capgo에 대한 구현 세부 사항에 대해 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트에 대한 구현 세부 사항에 대해

FAQ

FAQ

Capacitor 앱에 건강 플러그인을 설치하는 방법은?

Run "bun add @capgo/capacitor-health" (or "npm install @capgo/capacitor-health"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-health" in your app code.

리액트, 뷰, 앵귤러와 함께 @capgo/capacitor-health가 작동합니까?

Yes. Health is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

어떤 Capacitor 버전이 @capgo/capacitor-health를 지원하는지?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다: Capacitor의 메이저 버전과 일치하는 플러그인 메이저 버전을 사용하십시오 (예를 들어 플러그인 v8과 Capacitor 8). GitHub README에 있는 호환성 표에서 유지 관리되는 버전을 확인하십시오.

@capgo/capacitor-health는 무료이며 오픈 소스인가?

네. code의 소스는 GitHub에 https://github.com/Cap-go/capacitor-health/ 에 공개되어 있으며 npm에서 무료로 설치할 수 있습니다. 버그 리포트와 풀 리퀘스트는 환영합니다.

code를 사용하는 Health가 App Store 리뷰 없이 업데이트할 수 있나요?

code를 설치하거나 업그레이드하면 네이티브 code이 변경되므로 새로운 스토어 빌드를 필요로 합니다. 그 후에 JavaScript, HTML 및 CSS 변경 사항이 플러그인을 호출하는 경우 Capgo 라이브 업데이트와 함께 즉시 배포할 수 있습니다.

앱 리뷰 기다리지 않고 Ship Health를 변경합니다.

플러그인이 스토어 빌드에 포함된 후, Capgo 라이브 업데이트는 사용자에게 몇 분 안에 자바스크립트, HTML 및 CSS 변경 사항을 푸시합니다.

Capgo로 시작하세요.