QMqtt Namespace
Contiene identificadores diversos que se utilizan a lo largo del módulo « Qt MQTT ». Más información...
| Cabecera: | #include <qmqttglobal.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Mqtt) target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
| qmake: | QT += mqtt |
Tipos
| enum class | MessageStatus { Unknown, Published, Acknowledged, Received, Released, Completed } |
| enum class | PayloadFormatIndicator { Unspecified, UTF8Encoded } |
| enum class | ReasonCode { Success, SubscriptionQoSLevel0, SubscriptionQoSLevel1, SubscriptionQoSLevel2, NoMatchingSubscriber, …, WildCardSubscriptionsNotSupported } |
Documentación sobre tipos
enum class QMqtt::MessageStatus
Este tipo de enumeración especifica los estados disponibles de un mensaje. En función de la calidad de servicio (QoS) y de la función del cliente, se esperan diferentes estados del mensaje.
| Constante | Valor | Descripción |
|---|---|---|
QMqtt::MessageStatus::Unknown | 0 | Se desconoce el estado del mensaje. |
QMqtt::MessageStatus::Published | 1 | El cliente ha recibido un mensaje para una de sus suscripciones. Esto se aplica a los niveles de QoS 1 y 2. |
QMqtt::MessageStatus::Acknowledged | 2 | Se ha confirmado la recepción de un mensaje. Esto se aplica al nivel de QoS 1 e indica que el cliente ha finalizado el procesamiento del mensaje. |
QMqtt::MessageStatus::Received | 3 | Se ha recibido un mensaje. Esto se aplica al nivel de calidad de servicio (QoS) 2. |
QMqtt::MessageStatus::Released | 4 | Se ha liberado un mensaje. Esto se aplica al nivel de calidad de servicio (QoS) 2. Para un editor, se ha completado el procesamiento del mensaje. |
QMqtt::MessageStatus::Completed | 5 | Se ha completado un mensaje. Esto se aplica al nivel de calidad de servicio (QoS) 2 e indica que el procesamiento del mensaje ha finalizado por parte del cliente. |
enum class QMqtt::PayloadFormatIndicator
El formato de la carga útil proporciona información sobre el contenido de un mensaje. Esto puede ayudar a otros clientes a procesar el mensaje más rápidamente.
| Constante | Valor | Descripción |
|---|---|---|
QMqtt::PayloadFormatIndicator::Unspecified | 0 | El formato no está especificado. |
QMqtt::PayloadFormatIndicator::UTF8Encoded | 1 | La carga útil del mensaje tiene el formato «Datos de caracteres codificados en UTF-8». |
enum class QMqtt::ReasonCode
Este tipo de enumeración especifica los códigos de error disponibles.
| Constante | Valor | Descripción |
|---|---|---|
QMqtt::ReasonCode::Success | 0 | La acción especificada se ha realizado correctamente. |
QMqtt::ReasonCode::SubscriptionQoSLevel0 | 0 | Se ha creado una suscripción con nivel de QoS 0. |
QMqtt::ReasonCode::SubscriptionQoSLevel1 | 0x01 | Se ha creado una suscripción con nivel de QoS 1. |
QMqtt::ReasonCode::SubscriptionQoSLevel2 | 0x02 | Se ha creado una suscripción con nivel de QoS 2. |
QMqtt::ReasonCode::NoMatchingSubscriber | 0x10 | El servidor ha aceptado el mensaje, pero no hay suscriptores que lo reciban. Un bróker puede enviar este código de motivo en lugar de «Éxito». |
QMqtt::ReasonCode::NoSubscriptionExisted (since Qt 5.15) | 0x11 | El cliente no está utilizando ningún filtro de temas que coincida. |
QMqtt::ReasonCode::ContinueAuthentication (since Qt 5.15) | 0x18 | Continúa con la autenticación con otro paso. |
QMqtt::ReasonCode::ReAuthenticate (since Qt 5.15) | 0x19 | Inicia una nueva autenticación. |
QMqtt::ReasonCode::UnspecifiedError | 0x80 | Se ha producido un error no especificado. |
QMqtt::ReasonCode::MalformedPacket | 0x81 | El paquete enviado al servidor no es válido. |
QMqtt::ReasonCode::ProtocolError | 0x82 | Se ha producido un error de protocolo. En la mayoría de los casos, esto provocará que el servidor desconecte al cliente. |
QMqtt::ReasonCode::ImplementationSpecificError | 0x83 | El paquete es válido, pero el destinatario lo rechaza. |
QMqtt::ReasonCode::UnsupportedProtocolVersion | 0x84 | El servidor no admite la versión del protocolo solicitada. |
QMqtt::ReasonCode::InvalidClientId | 0x85 | El ID de cliente no es válido. |
QMqtt::ReasonCode::InvalidUserNameOrPassword | 0x86 | El nombre de usuario o la contraseña especificados no son válidos. |
QMqtt::ReasonCode::NotAuthorized | 0x87 | El cliente no está autorizado para realizar la acción especificada. |
QMqtt::ReasonCode::ServerNotAvailable | 0x88 | El servidor al que se debe conectar no está disponible. |
QMqtt::ReasonCode::ServerBusy | 0x89 | El servidor al que se debe conectar no está disponible. Se pide al cliente que lo intente más tarde. |
QMqtt::ReasonCode::ClientBanned | 0x8A | El cliente ha sido bloqueado en el servidor. |
QMqtt::ReasonCode::InvalidAuthenticationMethod | 0x8C | El método de autenticación especificado no es válido. |
QMqtt::ReasonCode::InvalidTopicFilter | 0x8F | El filtro de temas especificado no es válido. |
QMqtt::ReasonCode::InvalidTopicName | 0x90 | El nombre del tema especificado no es válido. |
QMqtt::ReasonCode::MessageIdInUse | 0x91 | El ID del mensaje utilizado en el paquete anterior ya está en uso. |
QMqtt::ReasonCode::MessageIdNotFound | 0x92 | No se ha encontrado el ID de mensaje utilizado en el paquete anterior. |
QMqtt::ReasonCode::PacketTooLarge | 0x95 | El paquete recibido es demasiado grande. Véase también QMqttServerConnectionProperties::maximumPacketSize(). |
QMqtt::ReasonCode::QuotaExceeded | 0x97 | Se ha superado un límite impuesto administrativamente. |
QMqtt::ReasonCode::InvalidPayloadFormat | 0x99 | El formato de la carga útil no es válido. Véase también QMqttPublishProperties::payloadFormatIndicator(). |
QMqtt::ReasonCode::RetainNotSupported | 0x9A | El servidor no admite mensajes retenidos. Véase también QMqttServerConnectionProperties::retainAvailable(). |
QMqtt::ReasonCode::QoSNotSupported | 0x9B | No se admite el nivel de QoS solicitado. Véase también QMqttServerConnectionProperties::maximumQoS(). |
QMqtt::ReasonCode::UseAnotherServer | 0x9C | El servidor al que el cliente intenta conectarse no está disponible. Véase también QMqttServerConnectionProperties::serverReference(). |
QMqtt::ReasonCode::ServerMoved | 0x9D | El servidor al que el cliente intenta conectarse se ha trasladado a una nueva dirección. Véase también QMqttServerConnectionProperties::serverReference(). |
QMqtt::ReasonCode::SharedSubscriptionsNotSupported | 0x9E | No se admiten suscripciones compartidas. Véase también QMqttServerConnectionProperties::sharedSubscriptionSupported(). |
QMqtt::ReasonCode::ExceededConnectionRate | 0x9F | Se ha superado el límite de velocidad de conexión. |
QMqtt::ReasonCode::SubscriptionIdsNotSupported | 0xA1 | No se admiten los ID de suscripción. Véase también QMqttServerConnectionProperties::subscriptionIdentifierSupported(). |
QMqtt::ReasonCode::WildCardSubscriptionsNotSupported | 0xA2 | El servidor no admite suscripciones que utilicen comodines. Véase también QMqttServerConnectionProperties::wildcardSupported(). |
No todos los valores están disponibles en todos los casos de uso. En particular, algunos servidores rechazarán un código de motivo que no sea adecuado para un comando específico. Consulte la tabla siguiente para conocer los códigos de motivo esperados para acciones específicas.
| Código de motivo | Propiedades de conexión | Propiedades de la suscripción | Propiedades del mensaje |
|---|---|---|---|
| Éxito | X | X | X |
| SubscriptionQoSLevel0 | X | ||
| Nivel de calidad de servicio de suscripción 1 | X | ||
| Nivel de calidad de servicio de suscripción 2 | X | ||
| No hay suscriptor coincidente | X | ||
| Error no especificado | X | X | X |
| Paquete mal formado | X | ||
| Error de protocolo | X | ||
| Error específico de la implementación | X | X | X |
| Versión de protocolo no compatible | X | ||
| Identificador de cliente no válido | X | ||
| Nombre de usuario o contraseña no válidos | X | ||
| No autorizado | X | X | X |
| Servidor no disponible | X | ||
| Servidor ocupado | X | ||
| Cliente bloqueado | X | ||
| Método de autenticación no válido | X | ||
| Filtro de tema no válido | X | ||
| Nombre de tema no válido | X | X | |
| Identificador de mensaje en uso | X | X | |
| MessageIdNotFound | X | ||
| Paquete demasiado grande | X | ||
| Se ha superado el límite | X | X | X |
| Formato de carga útil no válido | X | X | |
| No se admite la retención | X | ||
| QoS no compatible | X | ||
| UsarOtroServidor | X | ||
| ServidorTrasladado | X | ||
| No se admiten suscripciones compartidas | X | ||
| Se ha superado la tasa de conexión | X | ||
| No se admiten ID de suscripción | X | ||
| Suscripciones con comodines no admitidas | X |
© 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.