观察__CAPGO_KEEP_0__插件:安装、设置与示例
返回插件
@capgo/capacitor-watch
教程
@capgo/capacitor-watch

监视

Apple Watch与iPhone和watchOS应用之间的双向消息传递

指南

Apple Watch教程

在设备上测试

下载Capgo应用,然后扫描QRcode.

观看插件预览二维码 code

使用 @capgo/capacitor-watch

Apple Watch 的通信插件为 Capacitor。该插件提供 iPhone 和 Apple Watch 之间的双向消息传递,使用 WatchConnectivity。

安装

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

完整参考

继续使用@capgo/capacitor-watch

如果您正在使用 使用@capgo/capacitor-watch 与@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-watch @capgo/capacitor-watch 在@capgo/capacitor-watch 获取开始 在获取开始 Capgo 在Capgo Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, and 添加或更新插件 为添加或更新插件的实现细节。