메인 콘텐츠로 건너뛰기

안내

Watch에 대한 튜토리얼

장치에서 테스트

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

Watch plugin preview QR code

Using @capgo/capacitor-watch

Apple Watch communication plugin for Capacitor. Provides bidirectional messaging between iPhone and Apple Watch using WatchConnectivity.

설치

bun add @capgo/capacitor-watch
bunx cap sync

What This Plugin Exposes

  • 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 }
  });
});

전체 참조

시계 플러그인 사용을 계속합니다. @capgo/capacitor-watch

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-watch를 사용하는 경우 capgo/capacitor-watch를 사용하여 네이티브 플러그인 작업을 계획할 때 연결합니다. __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-watch를 사용하여 네이티브 플러그인 작업을 계획할 때 연결합니다. capgo/capacitor-watch를 사용하여 네이티브 플러그인 작업을 계획할 때 연결합니다. for the implementation detail in @capgo/capacitor-watch, 시작하기 Capacitor-watch 구현 세부 사항에 대해 Capgo Plugin Directory for the product workflow in Capgo Plugin Directory, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, and Capacitor-watch 플러그인 추가 또는 업데이트 구현 세부 사항에 대해 푸터