Passer à la navigation principale
@capgo/capacitor-mqtt Communication Source ouverte

MQTT plugin Capacitor

Support MQTT pour messagerie temps réel sur iOS, Android et Web.

Installer

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

Guide

Comment utiliser MQTT dans Capacitor

Tester sur appareil

Téléchargez l'application Capgo, puis scannez le QR code.

Liens QR de prévisualisation du plugin MQTT code

Utilisation de @capgo/capacitor-mqtt

Le plugin Capacitor pour la connectivité MQTT sur Android et iOS.

Installer

bun add @capgo/capacitor-mqtt
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.

Importer

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

Voir l’API en un coup d'œil

Méthode Description
connect Consultez les définitions sources pour connaître le comportement actuel.
disconnect Consultez les définitions sources pour connaître le comportement actuel.
subscribe Consultez les définitions sources pour connaître le comportement actuel.
publish Consultez les définitions sources pour connaître le comportement actuel.

Exemples

connect()

Consultez la référence du API pour le contrat actuel.

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

Consultez la référence du API pour le contrat actuel.

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

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

subscribe()

Consultez la référence API pour le contrat actuel.

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

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

publish()

Consultez la référence API pour le contrat actuel.

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

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

Écoutez les événements

addListener renvoie un gestionnaire. Appelez handle.remove() lorsque l'écran est démonté.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-mqtt

Si vous utilisez Utilisation de @capgo/capacitor-mqtt pour planifier le travail de plugin natif, connectez-l’à @capgo/capacitor-mqtt pour les détails d'implémentation dans @capgo/capacitor-mqtt, Prise en main pour les détails d'implémentation dans Prise en main, Répertoire des plugins Capgo pour le flux de travail du produit dans Répertoire des plugins Capgo, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Ajouter ou mettre à jour des plugins.

FAQ

FAQ du plugin MQTT

Comment installer le plugin MQTT dans une application Capacitor?

Exécutez la commande « bun add @capgo/capacitor-mqtt » (ou « npm install @capgo/capacitor-mqtt »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte les natives code. Importez-l’à partir de « @capgo/capacitor-mqtt » dans votre application code.

Fonctionne-t-il avec React, Vue et Angular @capgo/capacitor-mqtt ?

Oui. MQTT est un paquet Capacitor, il fonctionne donc avec tout framework web qui tourne à l'intérieur Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version Capacitor est prise en charge par @capgo/capacitor-mqtt ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à votre version majeure de Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Est-ce que @capgo/capacitor-mqtt est gratuit et open source ?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-mqtt/ et le paquet est gratuit pour l'installer depuis npm. Les rapports de bogues et les demandes de modification sont les bienvenus.

Puis-je mettre à jour code qui utilise MQTT sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin change les natives code, il faut donc une nouvelle build de l'application. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo.

Ship MQTT changes without waiting for app review

Une fois le plugin dans votre magasin de build, Capgo les mises à jour en temps réel poussent vos modifications JavaScript, HTML et CSS chez les utilisateurs en quelques minutes.

Démarrer avec Capgo