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

ウォッチ

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

ガイド

ウォッチ用チュートリアル

デバイスでテスト

Download the Capgo app, then scan the QR code.

Apple Watch プラグインのプレビュー QR code

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

フルリファレンス

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