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

監視

Apple WatchとiPhone、watchOSアプリ間の双方向メッセージング

ガイド

Apple Watchのチュートリアル

デバイスでテスト

Capgoアプリをダウンロードして、QRコードをスキャンしてくださいcode.

Apple Watch プラグインのQRコードはcode

@capgo/capacitor-watchを使用

CapacitorはApple Watch用の通信プラグインです。iPhoneとApple Watch間でWatchConnectivityを使用して bidirectional メッセージを送信します。

インストール

bun add @capgo/capacitor-watch
bunx cap sync

このプラグインが公開するもの

  • sendMessage - 時間の経過とともに、Apple Watchにインタラクティブなメッセージを送信します。Apple Watchがこのメッセージを受信するには、Apple Watchが接続可能でなければなりません。
  • updateApplicationContext - Apple Watchと共有しているアプリケーションコンテキストを更新します。最新のコンテキストのみが保持され、以前のコンテキストは上書きされます。
  • transferUserInfo - 時計にユーザー情報を転送する。転送はキューに保管され、時計が現在アクセスできない場合でも順番に配信される。重要なデータを信頼性の高い方法で配信する必要がある場合に使用する。
  • replyToMessage - 時計から返信を求められたメッセージに対応する。messageReceivedWithReply イベントの応答として使用する。

Example Usage

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

Full Reference

時計を使用し続ける: @capgo/capacitor-watch

Capgoを使用している場合 Capgoの@capgo/capacitor-watch Capgoの@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-watch Capgoの@capgo/capacitor-watch for the implementation detail in @capgo/capacitor-watch, CapgoのGetting Started Capgoの__CAPGO_KEEP_0__ プラグイン ディレクトリ CapgoのCapgo プラグイン ディレクトリ CapgoのCapgo プラグイン Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, and Capgoの__CAPGO_KEEP_0__ プラグインの追加または更新 実装詳細については、プラグインの追加または更新のページを参照してください。