メインコンテンツにスキップ
プラグインに戻る
@capgo/capacitor-watch
チュートリアル
@capgo/capacitor-watch

ウォッチ

iPhoneとwatchOSアプリ間の bidirectional メッセージングによる Apple Watch の通信

ガイド

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

フル リファレンス

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 によって提供 ) の実装詳細については、 プラグインの追加または更新 プラグインの追加または更新の実装詳細については、