Langsung ke konten utama
@capgo/capacitor-watch API Perangkat Open source

Tonton plugin Capacitor

Komunikasi Apple Watch dan Wear OS dengan pesan dua arah antara aplikasi ponsel dan jam tangan

Instal

bun add @capgo/capacitor-watch bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-watch
  • pnpm add @capgo/capacitor-watch
  • yarn add @capgo/capacitor-watch

Panduan

Cara menggunakan Watch di Capacitor

Menggunakan @capgo/capacitor-watch

Plugin komunikasi Apple Watch untuk Capacitor. Menyediakan pengiriman pesan dua arah antara iPhone dan Apple Watch menggunakan WatchConnectivity.

Instal

bun add @capgo/capacitor-watch
bunx cap sync

Apa yang Diekspos Plugin Ini

  • 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.

Contoh Penggunaan

sendMessage

Kirim pesan interaktif ke smartwatch. Smartwatch harus dapat dijangkau agar berhasil. Gunakan ini untuk komunikasi interaktif yang sensitif terhadap waktu.

import { CapgoWatch } from '@capgo/capacitor-watch';

await CapgoWatch.sendMessage({
  data: { action: 'refresh', timestamp: Date.now() }
});

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.

import { CapgoWatch } from '@capgo/capacitor-watch';

await CapgoWatch.updateApplicationContext({
  context: { theme: 'dark', lastSync: Date.now() }
});

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.

import { CapgoWatch } from '@capgo/capacitor-watch';

await CapgoWatch.transferUserInfo({
  userInfo: { recordId: '123', action: 'created' }
});

replyToMessage

Balas pesan dari watch yang meminta balasan. Gunakan ini untuk merespons event 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 }
  });
});

Referensi Lengkap

Lanjut ke Menggunakan @capgo/capacitor-watch

Jika Anda menggunakan Menggunakan @capgo/capacitor-watch untuk merencanakan pekerjaan plugin native, hubungkan dengan @capgo/capacitor-watch untuk detail implementasi di @capgo/capacitor-watch, Panduan Memulai untuk detail implementasi di Getting Started, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi di Plugin Capacitor oleh Capgo, dan Menambahkan atau Memperbarui Plugin untuk detail implementasi di bagian Menambahkan atau Memperbarui Plugin.

FAQ

FAQ plugin Watch

Bagaimana cara install plugin Watch di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-watch" (atau "npm install @capgo/capacitor-watch"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mendeteksi code native. Import dari "@capgo/capacitor-watch" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-watch mendukung React, Vue, dan Angular?

Ya. Watch adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript murni.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-watch?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-watch gratis dan open source?

Ya. Source code tersedia secara publik di GitHub pada https://github.com/Cap-go/capacitor-watch/ dan package ini gratis untuk diinstall via npm. Kami menerima laporan bug dan pull request.

Bisakah saya update code yang menggunakan Watch tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan Watch tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo