capgo/capacitor-watch를 사용하는 방법
Capacitor의 Apple Watch 통신 플러그인. iPhone과 Apple Watch 간의 WatchConnectivity를 사용하여 양방향 메시지를 제공합니다.
설치
bun add @capgo/capacitor-watch
bunx cap sync
This Plugin Exposes
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
시계에서 답장 요청한 메시지에 답하세요. 메시지ReceivedWithReply 이벤트에 응답할 때 사용하세요.
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/
Using @capgo/capacitor-watch에서 계속하세요.
이러한 플러그인을 사용하고 있다면 Using @capgo/capacitor-watch native 플러그인 작업을 계획하기 위해 연결하세요. @capgo/capacitor-watch for the implementation detail in @capgo/capacitor-watch, Getting Started Getting Started 구현 세부 사항을 참조하세요. Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 제품 워크플로우를 참조하세요. Capacitor Plugins by Capgo Capacitor 플러그인들에 대한 구현 세부 사항과 Capgo 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 세부 사항을 참조하세요.