ガイド
Apple Watch向けチュートリアル
capgo/capacitor-watchを使用する
Apple Watch用のCapacitorプラグイン。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が現在接続可能でなくても、順番に配信されます。このメソッドは、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/
Using @capgo/capacitor-watch を使用している場合
Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-watch Using @capgo/capacitor-watch native プラグインの作業を計画するには、 @capgo/capacitor-watch native プラグインの実装詳細については @capgo/capacitor-watch を参照してください。 Getting Started Getting Started の実装詳細については、 Capgo プラグイン ディレクトリ Capgo プラグイン ディレクトリの製品ワークフローについては、 Capacitor プラグイン ( Capgo によって提供 ) Capacitor プラグイン ( Capgo によって提供 ) の実装詳細については、 プラグインの追加または更新 プラグインの追加または更新の実装詳細については、