@capgo/capacitor-watch

Ikhtisar

@capgo/capacitor-watch menghubungkan aplikasi ponsel Capacitor Anda ke aplikasi watch pendamping:

• iOS: WatchConnectivity dengan target watchOS dan opsional CapgoWatchSDK.
• Android: Data Layer Wear OS (play-services-wearable) dengan modul Wear OS di proyek Android yang sama.
• Web: tidak mendukung messaging untuk watch; getInfo() dan getPluginVersion() selesai dengan default yang aman; metode messaging ditolak; listener terdaftar tapi tidak mengirim event

Dukungan platform

Kemampuan di bawah ini sesuai dengan implementasi native di CapgoWatchPlugin.swift dan CapgoWatchPlugin.java.

Kemampuan	iOS (Apple Watch)	Android (Wear OS)	Web
sendMessage	Ya. Memerlukan sesi aktif dan isReachable.	Ya. Dikirim saat /capgo/message ke node yang terhubung. Ditolak jika tidak ada node Wear OS yang terhubung.	Tidak
updateApplicationContext	Ya. Hanya nilai terbaru via WatchConnectivity.	Ya. DataItem pada /capgo/context dengan JSON di payload.	Tidak
transferUserInfo	Ya. Transfer info user dalam antrean.	Ya. DataItem pada /capgo/userinfo/{uuid} dengan JSON di payload.	Tidak
replyToMessage	Ya. Setelah messageReceivedWithReply.	Ya. Dikirim saat /capgo/reply/{callbackId} ke watch node (pending TTL 5 menit).	Tidak
getInfo	Ya. WatchConnectivity pairing dan reachability.	Ya. Node yang terhubung plus capgo_watch kemampuan deteksi instalasi watch app.	Mengembalikan isSupported: false
getPluginVersion	Ya	Ya	Mengembalikan { version: "web" }
messageReceived	Ya	Yes. Incoming /capgo/message.	Hanya registrasi; tidak ada event di web
messageReceivedWithReply	Ya	Yes. Incoming /capgo/message/withreply.	Hanya registrasi; tidak ada event di web
applicationContextReceived	Ya	Yes. Incoming /capgo/context DataItem.	Hanya registrasi; tidak ada event di web
userInfoReceived	Ya	Yes. Incoming /capgo/userinfo/* (ponsel menghapus item setelah pengiriman).	Hanya registrasi; tidak ada event di web
reachabilityChanged	Ya	Tidak dipancarkan di Android	Hanya registrasi; tidak ada event di web
activationStateChanged	Ya	Tidak dipancarkan di Android	Hanya registrasi; tidak ada event di web

Panduan setup

• Membuat aplikasi watchOS (Apple Watch + CapgoWatchSDK)
• Membuat aplikasi Wear OS (Modul Wear + path Data Layer)

Kemampuan Utama

• sendMessage - Kirim pesan interaktif ke smartwatch. Smartwatch harus dapat dijangkau agar berhasil. Gunakan ini untuk komunikasi interaktif yang sensitif terhadap waktu.
• updateApplicationContext - Perbarui konteks aplikasi yang dibagikan ke smartwatch. Hanya konteks terbaru yang disimpan - ini akan menimpa konteks sebelumnya. Gunakan ini untuk sinkronisasi state aplikasi yang perlu ditampilkan oleh smartwatch.
• transferUserInfo - Transfer info pengguna ke smartwatch. Transfer masuk antrean dan dikirim sesuai urutan, meskipun smartwatch saat ini tidak dapat dijangkau. Gunakan ini untuk data penting yang harus terkirim dengan andal.
• replyToMessage - Balas pesan dari watch yang meminta balasan. Gunakan ini untuk merespons event messageReceivedWithReply.

API Publik

Metode	Deskripsi
sendMessage	Kirim pesan interaktif ke smartwatch. Smartwatch harus dapat dijangkau agar berhasil. Gunakan ini untuk komunikasi interaktif yang sensitif terhadap waktu.
updateApplicationContext	Perbarui konteks aplikasi yang dibagikan ke smartwatch. Hanya konteks terbaru yang disimpan - ini akan menimpa konteks sebelumnya. Gunakan ini untuk sinkronisasi state aplikasi yang perlu ditampilkan oleh smartwatch.
transferUserInfo	Transfer info pengguna ke smartwatch. Transfer masuk antrean dan dikirim sesuai urutan, meskipun smartwatch saat ini tidak dapat dijangkau. Gunakan ini untuk data penting yang harus terkirim dengan andal.
replyToMessage	Balas pesan dari watch yang meminta balasan. Gunakan ini untuk merespons event messageReceivedWithReply.
getInfo	Dapatkan info status konektivitas watch.
getPluginVersion	Dapatkan versi plugin native Capacitor.
addListener	Dengarkan pesan yang diterima dari watch.
addListener	Dengarkan pesan dari watch yang butuh balasan.
addListener	Dengarkan update konteks aplikasi dari watch.
addListener	Dengarkan transfer info user dari watch.
addListener	Dengarkan perubahan reachability watch (khusus iOS).
addListener	Dengarkan perubahan status aktivasi sesi (khusus iOS).
removeAllListeners	Hapus semua listener plugin ini.

Sumber Kebenaran

Referensi ini disinkronkan dari src/definitions.ts di capacitor-watch.

Lanjutkan dari @capgo/capacitor-watch

Jika Anda menggunakan @capgo/capacitor-watch untuk merencanakan migrasi dan operasional enterprise, hubungkan dengan Menggunakan @capgo/capacitor-watch untuk fitur native di Menggunakan @capgo/capacitor-watch, Capgo Enterprise untuk workflow produk di Capgo Enterprise, Alternatif Plugin Ionic Enterprise untuk workflow produk di Alternatif Plugin Ionic Enterprise, Alternatif Capgo untuk alur kerja produk di Capgo Alternatives, dan Konsultasi Capgo untuk alur kerja produk di Capgo Consulting.