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

Watch Capacitor 플러그인

Apple Watch와 Wear OS의 통신

설치

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

안내

How to use Watch in Capacitor

Using @capgo/capacitor-watch

Apple Watch 통신 플러그인으로 Capacitor

설치

bun add @capgo/capacitor-watch
bunx cap sync

이 플러그인은 노출합니다.

  • sendMessage - 시계에 상호 작용하는 메시지를 전송합니다. 시계가 도달할 수 있어야 합니다. 시간에 민감한 상호 작용을 위해 사용하세요.
  • updateApplicationContext - 시계와 공유한 앱 컨텍스트를 업데이트합니다. 최신 컨텍스트만 유지되며 이전 컨텍스트를 덮어씁니다. 시계가 표시해야 하는 앱 상태를 동기화하는 데 사용하세요.
  • transferUserInfo - 시계에 사용자 정보를 전송합니다. 전송은 큐에 저장되어 순서대로 전달되며 시계가 현재 도달할 수 없더라도 전달됩니다. 중요한 데이터를 신뢰할 수 있는 방식으로 전달하는 데 사용하세요.
  • replyToMessage - 시계에서 요청한 응답으로 메시지를 반환합니다. 메시지ReceivedWithReply 이벤트에 응답할 때 사용하세요.

예제 사용

sendMessage

시계에 상호 작용하는 메시지를 전송합니다. 시계가 도달할 수 있어야 합니다. 시간에 민감한 상호 작용을 위해 사용하세요.

import { CapgoWatch } from '@capgo/capacitor-watch';

await CapgoWatch.sendMessage({
  data: { action: 'refresh', timestamp: Date.now() }
});

updateApplicationContext

시계와 공유한 앱 컨텍스트를 업데이트합니다. 최신 컨텍스트만 유지되며 이전 컨텍스트를 덮어씁니다. 시계가 표시해야 하는 앱 상태를 동기화하는 데 사용하세요.

import { CapgoWatch } from '@capgo/capacitor-watch';

await CapgoWatch.updateApplicationContext({
  context: { theme: 'dark', lastSync: Date.now() }
});

transferUserInfo

시계로 사용자 정보를 전송합니다. 전송은 대기열에 넣어 순서대로 전송되며, 시계가 현재 연결되지 않아도 됩니다. 중요한 데이터를 신뢰할 수 있게 전송해야 하는 경우에 사용하세요.

import { CapgoWatch } from '@capgo/capacitor-watch';

await CapgoWatch.transferUserInfo({
  userInfo: { recordId: '123', action: 'created' }
});

replyToMessage

시계에서 답장을 요청한 메시지에 답장을 보내세요. 메시지 받기 이벤트에 대한 응답으로 사용하세요.

import { CapgoWatch } from '@capgo/capacitor-watch';

CapgoWatch.addListener('messageReceivedWithReply', async (event) => {
  const result = await processRequest(event.message);
  await CapgoWatch.replyToMessage({
    callbackId: event.callbackId,
    data: { result }
  });
});

전체 참조

Using @capgo/capacitor-watch

시계로 사용하는 경우 Using @capgo/capacitor-watch native 플러그인 작업을 계획하려면 연결하세요 @capgo/capacitor-watch의 implementation detail과 연결하세요. @capgo/capacitor-watch 시작하기 시작하기에 대한 구현 세부 정보를 위해 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에 대한 제품 워크플로우를 위해 Capacitor Capgo 플러그인 Capacitor 플러그인에 대한 구현 세부 정보를 위해 Capgo 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트에 대한 구현 세부 정보를 위해

FAQ

Watch 플러그인 FAQ

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

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

React, Vue 및 Angular과 함께 @capgo/capacitor-watch가 작동하는가요?

네. Watch는 Capacitor 패키지이므로, Ionic, React, Vue, Angular, Svelte 및 일반 JavaScript와 같은 웹 프레임워크가 Capacitor 내부에서 작동하는 경우에 작동합니다.

Capacitor 버전은 @capgo/capacitor-watch가 지원하는가요?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다. 따라서 플러그인 메이저 버전은 Capacitor 메이저 버전과 일치해야 합니다 (예: 플러그인 v8과 Capacitor 8). GitHub README의 호환성 표에 나열된 버전을 사용하세요.

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

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

code를 사용하는 Watch가 App Store 리뷰 없이 업데이트가 가능한가요?

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

앱 리뷰 기다리지 않고 Watch 변경을 배포

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

Capgo로 시작하세요.