Qt Quick Abonnement

Utilisez les contrôles Qt Quick pour créer une application qui peut s'abonner à des sujets MQTT.

Interface d'abonnement MQTT avec les champs Hostname, Port, Topic, les boutons Connect et Subscribe

Qt Quick Subscription montre comment enregistrer QMqttClient en tant que type QML et l'utiliser dans une application Qt Quick.

Qt MQTT MQTT ne fournit pas d'API QML dans sa version actuelle. Cependant, vous pouvez rendre les classes C++ du module disponibles pour QML.

Création d'un client

Connectez-vous à QMqttSubscription::messageReceived( ) pour recevoir tous les messages envoyés au courtier :

QmlMqttSubscription::QmlMqttSubscription(QMqttSubscription *s, QmlMqttClient *c)
    : sub(s)
    , client(c)
{
    connect(sub, &QMqttSubscription::messageReceived, this, &QmlMqttSubscription::handleMessage);
}

Créez une classe QmlMqttClient avec la classe QMqttClient comme classe de base :

QmlMqttClient::QmlMqttClient(QObject *parent)
    : QObject(parent)
{
    connect(&m_client, &QMqttClient::hostnameChanged, this, &QmlMqttClient::hostnameChanged);
    connect(&m_client, &QMqttClient::portChanged, this, &QmlMqttClient::portChanged);
    connect(&m_client, &QMqttClient::stateChanged, this, &QmlMqttClient::stateChanged);
}

Utiliser la fonction subscribe() pour créer un objet d'abonnement :

QmlMqttSubscription* QmlMqttClient::subscribe(const QString &topic)
{
    auto sub = m_client.subscribe(topic, 0);
    auto result = new QmlMqttSubscription(sub, this);
    return result;
}

Utiliser un objet QMqttMessage pour stocker la charge utile d'un message reçu :

void QmlMqttSubscription::handleMessage(const QMqttMessage &qmsg)
{
    emit messageReceived(qmsg.payload());
}

Enregistrer des classes en QML

Dans le fichier main.cpp, chargez le type QML Main à partir de l'abonnement au module :

    QGuiApplication app(argc, argv);
    QQmlApplicationEngine engine;

    QObject::connect(
            &engine, &QQmlApplicationEngine::objectCreationFailed, &app,
            []() { QCoreApplication::exit(EXIT_FAILURE); }, Qt::QueuedConnection);

    engine.loadFromModule(u"subscription"_s, u"Main"_s);

Utilisez maintenant le type MqttClient dans le fichier Main.qml pour créer un client MQTT :

    MqttClient {
        id: client
        hostname: hostnameField.text
        port: portField.text
    }

Fichiers :

© 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.