Mulai

1. Pasang paket

   bun add @capgo/capacitor-watch

2. Sinkronkan dengan proyek asli

   bunx cap sync

3. Konfigurasi plugin

   Contoh Penggunaan Dasar:

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

   Kirim Pesan ke 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

   Pengaturan iOS yang Diperlukan:

   1. Tambahkan kemampuan WatchConnectivity ke aplikasi iOS Anda di Xcode
   2. Buat target aplikasi watchOS di proyek Xcode Anda
   3. Implementasikan WatchConnectivity di aplikasi watchOS Anda (lihat Implementasi Aplikasi Watch di bawah)

   Plugin ini secara otomatis mengaktifkan WCSession ketika plugin dimuat.

   Android

   Apple Watch hanya didukung pada iOS. Pada Android, semua metode akan menolak dengan pesan kesalahan “Apple Watch hanya didukung pada iOS”. getInfo() Metode ini kembali isSupported: false.

4. Tangani pesan yang memerlukan jawaban

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

5. Sinkronkan keadaan aplikasi

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

6. Transfer informasi pengguna secara andal

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

7. Monitor koneksi

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

Implementasikan Aplikasi Jam Tangan

Aplikasi jam tangan Anda harus mengimplementasikan WatchConnectivity. Berikut adalah contoh 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 Referensi

Metode

sendMessage(options: SendMessageOptions)

Kirim pesan interaktif ke jam tangan. Memerlukan jam tangan untuk dapat dijangkau.

Parameter:

• data: Objek - Data yang dikirim ke jam tangan

updateApplicationContext(options: UpdateContextOptions)

Perbarui konteks aplikasi. Hanya nilai terbaru yang disimpan.

Parameter:

• context: Objek - Data konteks aplikasi untuk disinkronisasi

transferUserInfo(options: TransferUserInfoOptions)

Antar informasi pengguna untuk pengiriman yang dapat diandalkan.

Parameter:

• userInfo: Object - Informasi pengguna untuk diteruskan

replyToMessage(options: ReplyMessageOptions)

Balas pesan yang meminta tanggapan.

Parameter:

• callbackId: string - ID panggilan balik dari event messageReceivedWithReply
• data: Object - Data balasan

getInfo()

Dapatkan status koneksi pengawas.

Mengembalikan: WatchInfo objek dengan:

• isSupported: boolean - Apakah WatchConnectivity tersedia
• isPaired: boolean - Apakah jam tangan terpasang
• isWatchAppInstalled: boolean - Apakah aplikasi jam tangan terinstal
• isReachable: boolean - Apakah jam tangan dapat dijangkau
• activationState: angka - Status sesi (0/1/2)

getPluginVersion()

Dapatkan versi plugin native.

Event

Event	Deskripsi
messageReceived	Pesan sederhana dari jam tangan
messageReceivedWithReply	Pesan yang menunggu balasan (termasuk callbackId)
applicationContextReceived	Pembaruan konteks dari jam tangan
userInfoReceived	Pengiriman informasi pengguna dari jam tangan
reachabilityChanged	Perubahan koneksi jam tangan
activationStateChanged	Status aktivasi sesi berubah

Polanya Komunikasi

Pengiriman Pesan Langsung (sendMessage)sendMessage)

• Memerlukan jam tangan untuk dapat dijangkau
• Paling cocok untuk komunikasi interaktif dan sensitif waktu
• Fails segera jika watch tidak tersedia

Konteks Aplikasi (updateApplicationContext)

• Nilai terbaru saja - nilai sebelumnya dihapus
• Terbaik untuk sinkronisasi state aplikasi saat ini
• Diterima ketika watch tersedia

Pindah Data Pengguna (transferUserInfo)

• Ditangguhkan dan diterima dalam urutan
• Terbaik untuk data penting yang harus diterima
• Bekerja bahkan ketika watch tidak tersedia secara sementara

Catatan Platform

iOS

• Memerlukan iOS 15.0 atau lebih baru
• Menggunakan framework WatchConnectivity
• Sesi secara otomatis diaktifkan pada saat plugin dimuat
• Mendukung pengiriman latar belakang untuk konteks dan informasi pengguna

Android

• Tidak didukung (Apple Watch hanya tersedia untuk iOS)
• Semua metode menolak dengan kesalahan yang sesuai
• getInfo() returns isSupported: false

Web

• Tidak Dapat Dibuka
• Semua metode menolak dengan error tidak tersedia
• getInfo() mengembalikan isSupported: false

Penggunaan Umum

1. Sinkronisasi Data: Sinkronkan data jam tangan dan ponsel
2. Pengendalian Jarak Jauh: Kendalikan fitur ponsel dari jam tangan
3. Pemberitahuan: Kirim notifikasi kustom ke jam tangan
4. Data Kesehatan: Bagikan metrik kesehatan dan olahraga
5. Kontrol Media: Kontrol pemutaran musik dari jam tangan
6. Rumah Cerdas: Kontrol perangkat dari lengan

Pengaturan

Jam tangan tidak dapat dijangkau:

• Pastikan jam tangan berada dalam jangkauan Bluetooth
• Periksa bahwa kedua aplikasi berjalan
• Pastikan WCSession diaktifkan di kedua sisi

Pesan tidak diterima:

• Periksa bahwa pemangku jawab telah terdaftar sebelum mengirim
• Pastikan aplikasi jam tangan mengimplementasikan WCSessionDelegate
• Gunakan transferUserInfo untuk pengiriman yang dijamin

Sesi tidak mengaktifkan:

• Pastikan kemampuan WatchConnectivity telah ditambahkan di Xcode
• Periksa bahwa aplikasi jam tangan memiliki ID paket kompanen
• Pastikan kedua aplikasi targetkan versi OS yang kompatibel