メインコンテンツにジャンプ
@capgo/capacitor-ウォッチ デバイスAPI オープンソース

ウォッチ Capacitor プラグイン

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

インストール

bun add @capgo/capacitor-watch bunx cap sync
npm、pnpmまたはyarn
  • npm install @capgo/capacitor-watch
  • pnpm add @capgo/capacitor-watch
  • yarn add @capgo/capacitor-watch

ガイド

CapacitorでWatchを使用する方法

デバイスでテスト

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

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

@capgo/capacitor-watchを使用

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

インストール

bun add @capgo/capacitor-watch
bunx cap sync

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

  • sendMessage - Apple Watchにインタラクティブなメッセージを送信します。Apple Watchが利用可能でなければならないため、成功するにはApple Watchが利用可能でなければなりません。この機能を使用して、タイムセンシティブなインタラクティブなコミュニケーションを実行します。
  • updateApplicationContext - Apple Watchと共有するアプリケーション コンテキストを更新します。最新のコンテキストのみが保持されるため、前のコンテキストを上書きします。この機能を使用して、アプリケーション ステートをApple Watchが表示する必要がある場合にSyncすることができます。
  • transferUserInfo - Apple Watchにユーザー情報を転送します。転送はキュー化され、Apple Watchが利用可能でなくても順序に従って配信されます。この機能を使用して、信頼性が高く重要なデータを配信することができます。
  • replyToMessage - 時計から返信するメッセージに応答します。メッセージを受信したときにメッセージを受信したイベントが発生した場合に使用します。

例の使用方法

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

- 時計から返信するメッセージに応答します。メッセージを受信したときにメッセージを受信したイベントが発生した場合に使用します。

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

時計を使用している場合 Capacitor を使用して @capgo/capacitor-watch を使用 native plugin work を計画するには、を接続する Capacitor を使用して @capgo/capacitor-watch Capacitor を使用して @capgo/capacitor-watch の実装詳細 Getting Started Getting Started の実装詳細 Capgo プラグインディレクトリ Capacitor Watch の製品ワークフロー内で Capgo プラグインディレクトリに。 Capacitor Capgo プラグイン for Capacitor の実装詳細については、Capgo によって提供されるプラグインを参照してください。 プラグインの追加または更新 プラグインの追加または更新の実装詳細

FAQ

時計プラグインFAQ

Capacitor Watch プラグインを Capacitor アプリにインストールする方法は何ですか。

Run "bun add @capgo/capacitor-watch" (or "npm install @capgo/capacitor-watch"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-watch" in your app code.

Capacitor の @capgo/capacitor-watch は、React、Vue、Angular とどのように動作しますか?

はい。Watch は Capacitor パッケージなので、Capacitor 内で実行される任意の Web フレームワークと互換性があります。 例えば、Ionic、React、Vue、Angular、Svelte、またはプレーンの JavaScript などです。

Which Capacitor version does @capgo/capacitor-watch support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

Capacitor の @capgo/capacitor-watch は無料でオープンソースですか?

はい。ソース code は GitHub で https://github.com/Cap-go/capacitor-watch/ で公開されており、npm から無料でインストールできます。 バグレポートやプルリクエストは歓迎されています。

Capacitor の @code/__CAPGO_KEEP_1__-watch を更新するには App Store のレビューが必要ですか?

プラグインをインストールまたはアップグレードすると、ネイティブ code が変更されるため、ストアのビルドが必要になります。 その後、Capgo のライブアップデートで、JavaScript、HTML、CSS の変更がプラグインを呼び出すことができます。

24.2万ダウンロード/月

プラグインがストアビルド内にあります。 Capgo ライブアップデートは、JavaScript、HTML、およびCSSの変更をユーザーに数分で反映します。

Capgo で始めましょう。