Langsung ke konten utama
@capgo/capacitor-mqtt Komunikasi Open source

MQTT plugin Capacitor

Dukungan MQTT untuk messaging real-time di iOS, Android, dan Web.

Instal

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

Panduan

Cara menggunakan MQTT di Capacitor

Tes di perangkat

Download aplikasi Capgo, lalu scan QR code.

QR preview plugin MQTT code

Menggunakan @capgo/capacitor-mqtt

Plugin Capacitor untuk konektivitas MQTT di Android dan iOS.

Instal

bun add @capgo/capacitor-mqtt
bunx cap sync

bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.

Impor

import { MqttBridge } from '@capgo/capacitor-mqtt';

Sekilas tentang API

Metode Deskripsi
connect Lihat definisi di source untuk perilaku saat ini.
disconnect Lihat definisi di source untuk perilaku saat ini.
subscribe Lihat definisi di source untuk perilaku saat ini.
publish Lihat definisi di source untuk perilaku saat ini.

Contoh

connect()

Lihat referensi API untuk kontrak saat ini.

import { MqttBridge } from '@capgo/capacitor-mqtt';

const result = await MqttBridge.connect({
  serverURI: 'https://example.com',
  port: 8080,
  clientId: 'client-id-123',
  username: 'username',
  password: 'password',
  setCleanSession: true,
  connectionTimeout: 1000,
  keepAliveInterval: 1000,
  setAutomaticReconnect: true,
});
console.log(result);

disconnect()

Lihat referensi API untuk kontrak saat ini.

import { MqttBridge } from '@capgo/capacitor-mqtt';

const result = await MqttBridge.disconnect();
console.log(result);

subscribe()

Lihat referensi API untuk kontrak saat ini.

import { MqttBridge } from '@capgo/capacitor-mqtt';

const result = await MqttBridge.subscribe({
  topic: 'topic',
  qos: 1,
});
console.log(result);

publish()

Lihat referensi API untuk kontrak saat ini.

import { MqttBridge } from '@capgo/capacitor-mqtt';

const result = await MqttBridge.publish({
  topic: 'topic',
  payload: 'payload',
  qos: 1,
  retained: true,
});
console.log(result);

Mendengarkan event

addListener mengembalikan sebuah handle. Panggil handle.remove() saat screen di-unmount.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-mqtt

Jika Anda menggunakan Menggunakan @capgo/capacitor-mqtt untuk merencanakan pekerjaan plugin native, hubungkan dengan @capgo/capacitor-mqtt untuk detail implementasi di @capgo/capacitor-mqtt, 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 MQTT

Bagaimana cara install plugin MQTT di aplikasi Capacitor?

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

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

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

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

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-mqtt gratis dan open source?

Ya. Source code bersifat publik di GitHub pada https://github.com/Cap-go/capacitor-mqtt/ dan paketnya gratis diinstal dari npm. Laporan bug dan pull request sangat diterima.

Bisakah saya memperbarui code yang menggunakan MQTT 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.

Deploy perubahan MQTT 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