Saltar al contenido principal
@capgo/capacitor-mqtt Comunicación Código abierto

MQTT plugin Capacitor

Soporte MQTT para mensajería en tiempo real en iOS, Android y Web.

Instalar

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

Guía

Cómo usar MQTT en Capacitor

Probar en el dispositivo

Descarga la app Capgo y escanea el QR code.

Vista previa QR del plugin MQTT code

Uso de @capgo/capacitor-mqtt

Plugin Capacitor para conectividad MQTT en Android e iOS.

Instalar

bun add @capgo/capacitor-mqtt
bunx cap sync

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

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

API de un vistazo

Método Descripción
connect See the source definitions for current behavior.
disconnect See the source definitions for current behavior.
subscribe See the source definitions for current behavior.
publish See the source definitions for current behavior.

Ejemplos

connect()

Consulta la referencia de API para conocer el contrato actual.

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 referencia de API para conocer el contrato actual.

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

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

subscribe()

Consulta la referencia de API para conocer el contrato actual.

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

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

publish()

Consulta la referencia de API para conocer el contrato actual.

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

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

Escuchar eventos

addListener devuelve un handle. Llama handle.remove() cuando la pantalla se desmonta.

Referencia completa

Continúa desde Using @capgo/capacitor-mqtt

Si estás usando Uso de @capgo/capacitor-mqtt para planificar el trabajo con plugins nativos, conéctalo con @capgo/capacitor-mqtt para los detalles de implementación en @capgo/capacitor-mqtt, Primeros pasos para los detalles de implementación en Primeros pasos, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Capacitor Plugins de Capgo, y Añadir o actualizar plugins para los detalles de implementación al añadir o actualizar plugins.

FAQ

FAQ del plugin MQTT

¿Cómo instalo el plugin MQTT en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-mqtt" (o "npm install @capgo/capacitor-mqtt"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android reconozcan el code nativo. Impórtalo desde "@capgo/capacitor-mqtt" en el code de tu app.

¿Es compatible @capgo/capacitor-mqtt con React, Vue y Angular?

Sí. MQTT es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor es compatible con @capgo/capacitor-mqtt?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-mqtt gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-mqtt/ y el paquete se puede instalar gratis desde npm. Aceptamos reportes de bugs y pull requests.

¿Puedo actualizar code con MQTT sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de MQTT sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo