메인 콘텐츠로 건너뛰기
플러그인으로 돌아가기
@capgo/capacitor-watch
튜토리얼
@capgo/capacitor-watch

감시

Apple Watch와 iPhone, watchOS 앱 간 양방향 메시징을 위한 통신

가이드

Watch에 대한 튜토리얼

장치에서 테스트

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

애플 워치 플러그인 미리보기 QR code

@capgo/capacitor-watch를 사용합니다

Capacitor의 애플 워치 통신 플러그인. 아이폰과 애플 워치 간의 양방향 메시징을 WatchConnectivity를 사용하여 제공합니다.

설치

bun add @capgo/capacitor-watch
bunx cap sync

이 플러그인이 제공하는 것

  • sendMessage - 시계에 맞춰서 상호 작용하는 메시지를 보냅니다. 시계가 이에 성공하려면 시계가 도달해야 합니다. 이 플러그인을 사용하여 시간에 민감한 상호 작용을 위한 메시지를 보냅니다.
  • updateApplicationContext - 시계와 공유된 애플리케이션 컨텍스트를 업데이트합니다. 이 플러그인은 이전 컨텍스트를 덮어씁니다. 이 플러그인을 사용하여 앱 상태를 시계가 표시해야 하는 경우 동기화합니다.
  • transferUserInfo - 사용자 정보를 시계에 전송합니다. 전송은 큐에 저장되어 시계가 현재 접근할 수 없더라도 순서대로 전달됩니다. 중요한 데이터를 신뢰할 수 있게 전달해야 하는 경우 사용하세요.
  • 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

Keep going from Using @capgo/capacitor-watch

만약 __CAPGO_KEEP_0__을 사용하고 있다면 capgo의 @capacitor-watch를 사용하여 __CAPGO_KEEP_0__을 native plugin 작업에 사용할 때, __CAPGO_KEEP_0__을 @__CAPGO_KEEP_1__-watch와 연결하세요. @capacitor-watch의 구현 세부 정보는 @capgo/capacitor-watch에서 확인할 수 있습니다. for the implementation detail in @capgo/capacitor-watch, __CAPGO_KEEP_0__ 시작하기의 구현 세부 정보는 __CAPGO_KEEP_0__ 시작하기에서 확인할 수 있습니다. __CAPGO_KEEP_0__ 플러그인 디렉토리 Capgo 플러그인 디렉토리의 제품 워크플로우는 Capgo 플러그인 디렉토리에서 확인할 수 있습니다. Capgo __CAPGO_KEEP_1__에 의해 Capacitor Capgo의 구현 세부 정보는 Capacitor Capgo에서 확인할 수 있습니다. for the implementation detail in Capacitor Plugins by Capgo, and __CAPGO_KEEP_0__ 플러그인을 추가하거나 업데이트 할 때는 __CAPGO_KEEP_0__ 플러그인을 참조하세요. __CAPGO_KEEP_0__ 구현 세부 사항에 대한 정보입니다.