capgo/capacitor-watchを使用
Apple Watch用のCapacitorコミュニケーションプラグイン。 iPhoneとApple Watch間でWatchConnectivityを使用した双方向メッセージングを提供します。
インストール
bun add @capgo/capacitor-watch
bunx cap sync
This Plugin Exposes
sendMessage- Apple Watchにインタラクティブなメッセージを送信します。 Apple Watchが利用可能な場合にのみ成功します。このメッセージはタイムセンシティブなため、時間の経過とともに失効します。updateApplicationContext- Apple Watchと共有するアプリケーションコンテキストを更新します。 最新のコンテキストのみが保持され、以前のコンテキストは上書きされます。このメソッドを使用して、Apple Watchで表示する必要があるアプリケーション状態を同期します。transferUserInfo- Apple Watchにユーザー情報を転送します。 転送はキュー化され、Apple Watchが利用可能な場合にのみ送信されます。このメソッドを使用して、Apple Watchに重要なデータを信頼性の高い方法で転送します。replyToMessage- Apple Watchから返信メッセージを受信した場合に返信します。このメソッドを使用して、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/
Keep going from Using @capgo/capacitor-watch
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 for the implementation detail in Capacitor Plugins by Capgo, and Capacitor プラグインの実装詳細については、 プラグインの追加または更新