메인 콘텐츠로 건너뛰기

안내

Watch 튜토리얼

장치 테스트

Capgo 앱을 다운로드하고 QR 코드 code를 스캔하세요.

Watch plugin preview QR code

Using @capgo/capacitor-watch

Apple Watch 통신 플러그인으로 Capacitor. iPhone과 Apple Watch 간에 WatchConnectivity를 사용하여 양방향 메시지를 제공합니다.

설치

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

시계에서 요청한 응답을 보내세요. messageReceivedWithReply 이벤트에 응답할 때 사용하세요.

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

시계 플러그인 개발을 계획하고 있다면 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-watch와 연결하세요. Using @capgo/capacitor-watch 시계 플러그인 개발을 계획하고 있다면 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-watch와 연결하세요. 시계 플러그인 개발을 계획하고 있다면 @capgo/capacitor-watch와 연결하세요. capgo/capacitor 시리즈에서 구현 세부 정보를 위해 @capgo에 대해 참조하십시오. 시작하기 __CAPGO_KEEP_0__ 시리즈에서 구현 세부 정보를 위해 Getting Started에 대해 참조하십시오. Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 제품 워크플로에 대해 참조하십시오. Capacitor 플러그인 - Capgo Capacitor 플러그인 - Capgo에서 구현 세부 정보를 위해 참조하십시오, 그리고 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트에서 구현 세부 정보를 위해 참조하십시오.