Zum Hauptinhalt springen
@capgo/capacitor-mqtt Kommunikation Open Source

MQTT Capacitor Plugin

MQTT-Support für Echtzeit-Messaging auf iOS, Android und Web.

Installieren

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

Anleitung

MQTT in Capacitor nutzen

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

MQTT-Plugin-Vorschau-QR code

Verwendung von @capgo/capacitor-mqtt

Capacitor Plugin für MQTT-Verbindungen auf Android und iOS.

Installieren

bun add @capgo/capacitor-mqtt
bunx cap sync

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

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

API auf einen Blick

Methode Beschreibung
connect Zum aktuellen Verhalten siehe die Definitionen im Quellcode.
disconnect Zum aktuellen Verhalten siehe die Definitionen im Quellcode.
subscribe Zum aktuellen Verhalten siehe die Definitionen im Quellcode.
publish Zum aktuellen Verhalten siehe die Definitionen im Quellcode.

Beispiele

connect()

Siehe die API-Referenz für den aktuellen Contract.

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

Siehe die API-Referenz für den aktuellen Contract.

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

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

subscribe()

Siehe die API-Referenz für den aktuellen Contract.

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

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

publish()

Siehe die API-Referenz für den aktuellen Contract.

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

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

Events abonnieren

addListener gibt ein Handle zurück. Rufe handle.remove() wenn der Screen unmountet wird.

Vollständige Referenz

Weiter geht's mit „@capgo/capacitor-mqtt verwenden“

Wenn du es nutzt Verwendung von @capgo/capacitor-mqtt Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-mqtt für die Implementierungsdetails in @capgo/capacitor-mqtt, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.

FAQ

MQTT Plugin FAQ

Wie installiere ich das MQTT Plugin in einer Capacitor App?

Führe "bun add @capgo/capacitor-mqtt" (oder "npm install @capgo/capacitor-mqtt") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-mqtt".

Funktioniert @capgo/capacitor-mqtt mit React, Vue und Angular?

Ja. MQTT ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor Version wird von @capgo/capacitor-mqtt unterstützt?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-mqtt kostenlos und Open Source?

Ja. Der code Source-Code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-mqtt/ einsehbar und das Paket kann kostenlos via npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit MQTT-Nutzung ohne App Store Review updaten?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

MQTT-Änderungen veröffentlichen, ohne auf den App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo