En esta página

Cliente MQTT sencillo

Creación de una aplicación de telemetría minimalista.

Cliente MQTT con campos de «Host», «Puerto» y «Protocolo», opciones de WebSockets y «Seguro», campos de entrada para «Tema» y «Mensaje», y un registro que muestra los cambios de estado

El cliente MQTT sencillo muestra cómo crear una aplicación cliente minimalista.

Para utilizar la aplicación, primero debes especificar un host, un puerto, si deseas activar o desactivar la seguridad, si deseas activar o desactivar WebSockets y el protocolo. A continuación, haz clic en «Conectar». Después, podrás suscribirte a un tema y enviar un mensaje, que también recibirás. También puedes ejecutar la aplicación dos veces. Publica en una y suscríbete en la otra, y los mensajes se transmitirán.

Opciones de simpleclient

  • Host: puedes utilizar test.mosquitto.org o broker.hivemq.com
  • Puerto: el puerto al que conectarse dependerá de la selección de WebSockets y de la opción de seguridad
  • WebSockets: puede especificar: seleccionado (activado) o no seleccionado (desactivado)
  • «Secure»: puede especificar: «selected» (activado) o «not selected» (desactivado)
  • Protocolo: puede especificar
    • mqtt 3.1
    • mqtt 3.1.1
    • mqtt 5.0
  • Tema: un tema al que publicar o suscribirse
  • Mensaje: un mensaje que se enviará en el tema si se está publicando

Configuración de conexión

Estas son las combinaciones habituales y funcionarán con test.mosquitto.org. Para broker.hivemq.com, consulta la información de los enlaces. Ten en cuenta que, si la opción «Secure» está activada, podría ser necesario instalar certificados en el ordenador. También podría ser necesario añadir el certificado al cliente MQTT en el código.

  • Puerto 1883, «Secure» = desactivado, «WebSockets» = desactivado: MQTT sobre TCP
  • Puerto 8883, «Secure» = activado, «WebSockets» = desactivado: MQTT sobre SSL
  • Puerto 8080, «Secure» = desactivado, «WebSockets» = activado: MQTT sobre WebSockets
  • Puerto 8081, Seguridad=activada, WebSockets=activados - MQTT sobre WebSockets seguros

Para obtener más información sobre los brokers, consulta:

Nota: Los puertos 1883 y 8080 no están cifrados, por lo que solo son adecuados para fines de desarrollo y pruebas. En producción, utiliza siempre conexiones cifradas.

Nota: WebAssembly solo es compatible con WebSockets habilitados.

Creación de un cliente

En primer lugar, utilizamos la clase QMqttClient para crear un cliente MQTT. La clase proporciona propiedades para establecer un ID de cliente único, así como el nombre de host y el puerto del bróker al que conectarse:

    m_client = new QMqttClient(this);
    m_client->setHostname(ui->lineEditHost->text());
    m_client->setPort(static_cast<quint16>(ui->spinBoxPort->value()));

No configuramos el ID del cliente, por lo que se generará automáticamente.

A continuación, nos conectamos a ` QMqttClient::messageReceived()` para recibir todos los mensajes enviados al bróker:

    connect(m_client, &QMqttClient::messageReceived, this, [this](const QByteArray &message, const QMqttTopicName &topic) {
        const QString content = QDateTime::currentDateTime().toString()
                    + " Received Topic: "_L1
                    + topic.name()
                    + " Message: "_L1
                    + message
                    + u'\n';
        ui->editLog->insertPlainText(content);
    });

Cuando los usuarios se suscriben a temas en el cliente, llamamos a ` QMqttClient::subscribe()` en el tema especificado:

void MainWindow::on_buttonSubscribe_clicked()
{
    auto subscription = m_client->subscribe(ui->lineEditTopic->text());
    if (!subscription) {
        QMessageBox::critical(this, u"Error"_s,
                              u"Could not subscribe. Is there a valid connection?"_s);
        return;
    }

En este ejemplo, nos suscribimos a todos los temas. Para obtener más información sobre cómo recibir mensajes en temas concretos, consulta el ejemplo «Suscripciones MQTT ».

Para ver un ejemplo de cómo utilizar la clase ` QMqttClient ` en una aplicación de ` Qt Quick `, consulta «Suscripción aQt Quick ».

Archivos:

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.