Salta al contenuto principale
@capgo/capacitor-mqtt Comunicazione Open source

MQTT Plugin Capacitor

Supporto MQTT per messaggistica in tempo reale su iOS, Android e Web.

Installa

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

Guida

Come usare MQTT in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansiona il QR code.

Anteprima QR del plugin MQTT code

Utilizzo di @capgo/capacitor-mqtt

Plugin Capacitor per la connettività MQTT su Android e iOS.

Installa

bun add @capgo/capacitor-mqtt
bunx cap sync

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

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

API in breve

Metodo Descrizione
connect Consulta le definizioni sorgente per il comportamento attuale.
disconnect Consulta le definizioni sorgente per il comportamento attuale.
subscribe Consulta le definizioni sorgente per il comportamento attuale.
publish Consulta le definizioni sorgente per il comportamento attuale.

Esempi

connect()

Consulta la documentazione API per il contratto attuale.

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()

Consulta la documentazione API per il contratto attuale.

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

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

subscribe()

Consulta la documentazione API per il contratto attuale.

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

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

publish()

Consulta la documentazione API per il contratto attuale.

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

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

Ascolta gli eventi

addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata.

Riferimento completo

Continua da Usare @capgo/capacitor-mqtt

Se stai usando Usare @capgo/capacitor-mqtt per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-mqtt per i dettagli di implementazione in @capgo/capacitor-mqtt, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.

FAQ

FAQ sul plugin MQTT

Come installo il plugin MQTT in un'app Capacitor?

Esegui "bun add @capgo/capacitor-mqtt" (o "npm install @capgo/capacitor-mqtt"), poi lancia "bunx cap sync" in modo che i progetti iOS e Android carichino il code nativo. Importalo da "@capgo/capacitor-mqtt" nel tuo code.

@capgo/capacitor-mqtt funziona con React, Vue e Angular?

Sì. MQTT è un pacchetto Capacitor, quindi funziona con qualsiasi web framework in esecuzione all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-mqtt?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-mqtt è free e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-mqtt/ e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che usa MQTT senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Distribuisci aggiornamenti MQTT senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo