Getting Started

このプラグインのセットアッププロンプトとインストール手順、そしてマークダウンガイドのコピー可能なプロンプトを取得してください。

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-watch`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/watch/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

インストール

AI-Assisted Setupを使用してプラグインをインストールできます。AIツールにCapgoスキルを追加するには、以下のコマンドを使用してください。

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

次のプロンプトを使用してください。

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-watch` plugin in my project.

手動設定を希望する場合は、以下のコマンドを実行してプラグインをインストールし、以下のプラットフォーム固有の指示に従ってください。

パッケージをインストール
ターミナル画面
```
bun add @capgo/capacitor-watch
```
ネイティブプロジェクトと同期
ターミナル画面
```
bunx cap sync
```
プラグインの設定

基本的な使用例:
```
import { CapgoWatch } from '@capgo/capacitor-watch';

// Check watch connectivity status
const info = await CapgoWatch.getInfo();
console.log('Watch paired:', info.isPaired);
console.log('Watch reachable:', info.isReachable);

// Listen for messages from watch
await CapgoWatch.addListener('messageReceived', (event) => {
  console.log('Message from watch:', event.message);
});
```
Watchにメッセージを送信:
```
// Check if watch is reachable first
const info = await CapgoWatch.getInfo();
if (info.isReachable) {
  await CapgoWatch.sendMessage({
    data: { action: 'refresh', timestamp: Date.now() }
  });
}
```
- iOS
- Android
必要なiOS設定:
1. XcodeでiOSアプリにWatchConnectivity機能を追加する
2. XcodeプロジェクトにwatchOSアプリターゲットを作成する
3. watchOSアプリでWatchConnectivityを実装する (Watch App Implementationを参照)
プラグインは、プラグインが読み込まれたときにWCSessionを自動的に有効にする。
Apple WatchはiOSのみでサポートされています。Androidでは、すべてのメソッドは「Apple WatchはiOSのみでサポートされています」というエラーで拒否されます。 getInfo() メソッドは isSupported: false.

返します

// Listen for messages that need a response
await CapgoWatch.addListener('messageReceivedWithReply', async (event) => {
  console.log('Request from watch:', event.message);

  // Process the request
  const result = await processWatchRequest(event.message);

  // Send reply back to watch
  await CapgoWatch.replyToMessage({
    callbackId: event.callbackId,
    data: { result }
  });
});

Sync application state

// Update application context (latest value only)
await CapgoWatch.updateApplicationContext({
  context: {
    theme: 'dark',
    userId: '123',
    lastSync: Date.now()
  }
});

// Listen for context updates from watch
await CapgoWatch.addListener('applicationContextReceived', (event) => {
  console.log('Context from watch:', event.context);
});

ユーザー情報を信頼性の高い方法で転送する

// Queue data for reliable delivery (even when watch is offline)
await CapgoWatch.transferUserInfo({
  userInfo: {
    recordId: '456',
    action: 'created',
    data: { name: 'Item 1' }
  }
});

// Listen for user info transfers
await CapgoWatch.addListener('userInfoReceived', (event) => {
  console.log('User info from watch:', event.userInfo);
});

接続性を監視する

// Track reachability changes
await CapgoWatch.addListener('reachabilityChanged', (event) => {
  console.log('Watch reachable:', event.isReachable);
  if (event.isReachable) {
    // Watch is now available for interactive messaging
  }
});

// Track session activation state
await CapgoWatch.addListener('activationStateChanged', (event) => {
  // 0 = notActivated, 1 = inactive, 2 = activated
  console.log('Session state:', event.state);
});

ウォッチアプリの実装

ウォッチOSアプリでは、WatchConnectivityを実装する必要があります。以下は、SwiftUIの例です。

import SwiftUI
import WatchConnectivity

@main
struct MyWatchApp: App {
    init() {
        WatchViewModel.shared.activate()
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

class WatchViewModel: NSObject, ObservableObject, WCSessionDelegate {
    static let shared = WatchViewModel()

    @Published var lastMessage: [String: Any] = [:]

    func activate() {
        guard WCSession.isSupported() else { return }
        WCSession.default.delegate = self
        WCSession.default.activate()
    }

    // Send message to iPhone
    func sendToPhone(_ data: [String: Any]) {
        guard WCSession.default.isReachable else {
            print("iPhone not reachable")
            return
        }
        WCSession.default.sendMessage(data, replyHandler: nil)
    }

    // Send message with reply
    func sendToPhoneWithReply(_ data: [String: Any], completion: @escaping ([String: Any]) -> Void) {
        guard WCSession.default.isReachable else { return }
        WCSession.default.sendMessage(data, replyHandler: completion)
    }

    // Receive message from iPhone
    func session(_ session: WCSession, didReceiveMessage message: [String: Any]) {
        DispatchQueue.main.async {
            self.lastMessage = message
        }
    }

    // Receive application context
    func session(_ session: WCSession, didReceiveApplicationContext applicationContext: [String: Any]) {
        DispatchQueue.main.async {
            self.lastMessage = applicationContext
        }
    }

    // Required delegate methods
    func session(_ session: WCSession, activationDidCompleteWith activationState: WCSessionActivationState, error: Error?) {
        print("Watch session activated: \(activationState.rawValue)")
    }
}

API リファレンス

メソッド

`sendMessage(options: SendMessageOptions)`

ウォッチにインタラクティブなメッセージを送信します。ウォッチが接続可能な場合にのみ使用できます。

パラメーター:

data: Object - 送信するウォッチに送信するデータ

`updateApplicationContext(options: UpdateContextOptions)`

アプリケーションコンテキストを更新します。最新の値のみが保持されます。

パラメーター:

context: Object - 同期するコンテキストデータ

`transferUserInfo(options: TransferUserInfoOptions)`

ユーザー情報を信頼性の高い方法でキューイングします。

パラメータ:

userInfo: Object - メッセージ送信元のユーザー情報

`replyToMessage(options: ReplyMessageOptions)`

メッセージに返信します。

パラメータ:

callbackId: string - messageReceivedWithReply イベントから取得したコールバックID
data: Object - 返信データ

`getInfo()`

ウォッチの接続状況を取得します。

戻り値: WatchInfo object with:

isSupported: boolean - WatchConnectivity が利用可能かどうか
isPaired: boolean - Pairing status
isWatchAppInstalled: boolean - Watch app installation status
isReachable: boolean - Watch connection status
activationState: number - Session state (0/1/2)

`getPluginVersion()`

ネイティブプラグインのバージョンを取得します。

イベント

説明	ウォッチから単純なメッセージ
`messageReceived`	ウォッチから返信を待つメッセージ (callbackIdを含みます)
`messageReceivedWithReply`	getPluginVersion() - プラグインのバージョンを取得します。
`applicationContextReceived`	Context update from watch
`userInfoReceived`	User info transfer from watch
`reachabilityChanged`	Watch の接続状況が変更されました
`activationStateChanged`	セッションの有効化状態が変更されました

コミュニケーションパターン

即時メッセージング (sendMessage)`sendMessage`)

リアルタイムの、時間の経過とともに変化するコミュニケーションに適しています
時計が利用可能でない場合、すぐに失敗します
アプリケーションコンテキスト (

Application Context (`updateApplicationContext`)

最新値のみ - 前の値は上書きされます
現在のアプリの状態を同期するのに最適
ウォッチが利用可能になったときに送信されます

ユーザー情報の転送 (transferUserInfo)`transferUserInfo`)

重要なデータを送信する必要がある場合に最適
ウォッチが一時的に利用できない場合でも機能します
プラットフォームに関する注意

iOS

Android

Apple WatchはiOSのみでサポートされていないためサポートされていません
すべてのメソッドは適切なエラーを返します
getInfo() returns isSupported: false

Web

サポートされていません
すべてのメソッドは利用できないエラーで拒否されます
getInfo() 返します isSupported: false

一般的な使用例

データ同期: 時計とスマートフォンのデータを同期する
リモートコントロール: 時計からスマートフォンの機能を制御する
通知: カスタム通知を時計に送信する
健康データ:
Media Control:
Smart Home:

Troubleshooting

Watch not reachable:

Ensure watch is within Bluetooth range
Check that both apps are running
Watch not reachable:

Bluetoothの範囲内に時計が存在することを確認してください。

リスナーが登録されていることを確認してください
WatchアプリがWCSessionDelegateを実装していることを確認してください
使用 transferUserInfo 確実な配信のために

セッションが有効になっていない場合

XcodeでWatchConnectivity機能が追加されていることを確認してください
WatchアプリがコンパニオンのバンドルIDを持っていることを確認してください
両方のアプリが互換性のあるOSバージョンをターゲットにしていることを確認してください

Getting Startedから続けてください

あなたが使用している Getting Started ネイティブプラグイン作業を計画するには、 Using @capgo/capacitor-watch Using @capgo/capacitor-watch Capgo プラグインディレクトリ Capgo プラグインディレクトリ Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, プラグインの追加または更新プラグインの追加または更新 Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの代替

Getting Started

インストール

ウォッチアプリの実装

API リファレンス

メソッド

sendMessage(options: SendMessageOptions)

updateApplicationContext(options: UpdateContextOptions)

transferUserInfo(options: TransferUserInfoOptions)

replyToMessage(options: ReplyMessageOptions)

getInfo()

getPluginVersion()