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

ウォッチ

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

ガイド

Watch用チュートリアル

デバイスでテスト

Download the Capgo app, then scan the QR code.

時計プラグインプレビューQR code

使用@capgo/capacitor-watch

Apple Watch通信プラグインはCapacitorです。 iPhoneとApple Watch間でWatchConnectivityを使用した双方向メッセージングを提供します。

インストール

bun add @capgo/capacitor-watch
bunx cap sync

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

  • sendMessage - 時計にインタラクティブなメッセージを送信します。時計が到達可能な場合にのみ成功します。このメッセージは時限の重要な通信に使用します。
  • updateApplicationContext - 時計と共有するアプリケーションコンテキストを更新します。最新のコンテキストのみが保持され、以前のコンテキストを上書きします。この機能は、時計が表示する必要があるアプリの状態を同期するために使用します。
  • transferUserInfo - 時計にユーザー情報を転送します。転送はキュー化され、時計が現在到達可能でない場合でも、順序に従って送信されます。この機能は、信頼性が高く重要なデータを転送するために使用します。
  • replyToMessage - 時計から返信するメッセージに応答します。この機能は、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 }
  });
});

フル リファレンス

Capacitor を使用して時計プラグインを開発する場合、@capgo/capacitor-watch を使用して進めましょう。

Capacitor を使用して時計プラグインを開発する場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-watch を使用してください。 Capacitor を使用して時計プラグインを開発する場合、@capgo/capacitor-watch を使用してください。 Capacitor を使用して時計プラグインを開発する場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-watch を使用してください。 Capacitor を使用して時計プラグインを開発する場合、@capgo/capacitor-watch を使用してください。 for the implementation detail in @capgo/capacitor-watch, Getting Started Capacitor-watch用の実装詳細については Capgo Plugin Directory for the product workflow in Capgo Plugin Directory, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, and Capacitor-watch用の実装詳細についてはプラグインの追加または更新 フッター