使用 @capgo/capacitor-watch
Apple WatchCapacitor插件。该插件提供了iPhone和Apple Watch之间的双向消息传递,使用WatchConnectivity。
安装
bun add @capgo/capacitor-watch
bunx cap sync
此插件暴露的内容
sendMessage- 向Apple Watch发送一个交互式消息。Apple Watch必须可达,否则此操作将失败。适用于时间敏感的交互式通信。updateApplicationContext- 更新与Apple Watch共享的应用程序上下文。仅保留最新的上下文 - 这会覆盖任何之前的上下文。适用于同步应用程序状态以供Apple Watch显示的场景。transferUserInfo- 将用户信息传输到Apple Watch。传输会被排队并按顺序传递,即使Apple Watch当前不可达。适用于必须可靠传递的重要数据。replyToMessage- 回复来自Apple Watch的消息。该消息要求回复。适用于响应messageReceivedWithReply事件的场景。
示例使用
sendMessage
向Apple Watch发送一个交互式消息。Apple Watch必须可达,否则此操作将失败。适用于时间敏感的交互式通信。
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 的实现细节 开始使用 对于开始使用的实现细节 Capgo 插件目录 对于 Capgo 插件目录中的产品工作流程 Capacitor 由 Capgo 提供的插件 对于 Capacitor 由 Capgo 提供的插件的实现细节 添加或更新插件 对于添加或更新插件的实现细节