가이드
Capacitor에서 Watch 사용 방법
@capgo/capacitor-watch 사용하기
Capacitor를 위한 Apple Watch 통신 플러그인입니다. WatchConnectivity를 사용하여 iPhone과 Apple Watch 간의 양방향 메시징을 제공합니다.
설치
bun add @capgo/capacitor-watch
bunx cap sync
플러그인이 제공하는 기능
sendMessage- 워치로 인터랙티브 메시지를 보냅니다. 성공하려면 워치와 연결되어 있어야 합니다. 실시간 상호작용이 필요한 통신에 사용하세요.updateApplicationContext- 워치와 공유할 앱 컨텍스트를 업데이트합니다. 최신 컨텍스트만 유지되며 이전 데이터는 덮어씌워집니다. 워치에 표시할 앱 상태를 동기화할 때 사용하세요.transferUserInfo- 사용자 정보를 워치로 전송합니다. 워치와 연결되어 있지 않더라도 전송 데이터는 큐에 쌓여 순서대로 전달됩니다. 반드시 전달되어야 하는 중요한 데이터에 사용하세요.replyToMessage- 답장을 요청하는 워치의 메시지에 응답합니다. messageReceivedWithReply 이벤트에 대한 응답으로 사용하세요.
사용 예시
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 }
});
});
전체 레퍼런스
- GitHub: https://github.com/Cap-go/capacitor-watch/
- 문서: /docs/plugins/watch/
@capgo/capacitor-watch 사용하기 단계에서 계속하기
사용 중이라면 @capgo/capacitor-watch 사용하기 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-watch @capgo/capacitor-watch의 구현 세부 사항은 시작하기 Getting Started의 구현 상세 내용은 Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor Plugins 구현 세부 사항 및 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항은.