시계

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

- 시계가 연결 가능할 때 시계로 인터랙티브 메시지를 전송합니다. 이 메시지를 전송하려면 시계가 연결되어 있어야 합니다. 시간에 민감한 인터랙티브 커뮤니케이션을 위해 사용하세요.

• sendMessage - 시계와 공유하는 앱 컨텍스트를 업데이트합니다. 최신 컨텍스트만 유지되며 이전 컨텍스트를 덮어씁니다. 앱 상태를 시계가 표시해야 하는 경우 앱 상태를 동기화하는 데 사용하세요.
• updateApplicationContext - 시계로 사용자 정보를 전송합니다. 전송은 큐에 저장되어 시계가 현재 연결되지 않아도 순서대로 전달됩니다. 중요한 데이터를 신뢰할 수 있는 방식으로 전달해야 하는 경우 사용하세요.
• transferUserInfo __CAPGO_KEEP_1__
• replyToMessage - 시계에서 답장 요청한 메시지에 답하기. 이 메시지를 messageReceivedWithReply 이벤트에 대한 응답으로 사용합니다.

Example Usage

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

Full Reference

• GitHub: https://github.com/Cap-go/capacitor-watch/
• Docs: /docs/plugins/watch/