QMqttServerConnectionProperties Class
La clase QMqttServerConnectionProperties representa las opciones de configuración de un servidor al que está conectado QMqttClient. Más...
| Cabecera: | #include <QMqttServerConnectionProperties> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Mqtt)target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
| qmake: | QT += mqtt |
| Hereda: | QMqttConnectionProperties |
Tipos Públicos
| enum | ServerPropertyDetail { None, SessionExpiryInterval, MaximumReceive, MaximumQoS, RetainAvailable, …, AuthenticationData } |
| flags | ServerPropertyDetails |
Funciones Públicas
| QMqttServerConnectionProperties::ServerPropertyDetails | availableProperties() const |
| bool | clientIdAssigned() const |
| bool | isValid() const |
| quint8 | maximumQoS() const |
| QString | reason() const |
| QMqtt::ReasonCode | reasonCode() const |
| QString | responseInformation() const |
| bool | retainAvailable() const |
| quint16 | serverKeepAlive() const |
| QString | serverReference() const |
| bool | sharedSubscriptionSupported() const |
| bool | subscriptionIdentifierSupported() const |
| bool | wildcardSupported() const |
Descripción detallada
Cuando se ha establecido una conexión, el servidor puede enviar detalles adicionales sobre las propiedades de la conexión. Utilice availableProperties() para identificar las propiedades establecidas por el servidor. Si una propiedad no es establecida por el servidor, se asumen valores por defecto y pueden obtenerse invocando funciones de acceso de esta instancia.
Nota: Las propiedades de conexión forman parte de la especificación MQTT 5.0 y no pueden utilizarse cuando se conecta con un nivel de protocolo inferior. Consulte QMqttClient::ProtocolVersion para obtener más información.
Documentación de tipos de miembros
enum QMqttServerConnectionProperties::ServerPropertyDetail
flags QMqttServerConnectionProperties::ServerPropertyDetails
Este tipo enum especifica las propiedades disponibles establecidas por el servidor o el cliente tras establecer una conexión.
| Constante | Valor | Descripción |
|---|---|---|
QMqttServerConnectionProperties::None | 0x00000000 | No se ha especificado ninguna propiedad. |
QMqttServerConnectionProperties::SessionExpiryInterval | 0x00000001 | El número de segundos que el servidor mantiene la sesión después de una desconexión. |
QMqttServerConnectionProperties::MaximumReceive | 0x00000002 | El número máximo de mensajes QoS 1 y 2 que el servidor es capaz de gestionar concurrentemente. |
QMqttServerConnectionProperties::MaximumQoS | 0x00000004 | El nivel máximo de QoS que el servidor puede entender. |
QMqttServerConnectionProperties::RetainAvailable | 0x00000010 | Especifica si se admiten mensajes retenidos. |
QMqttServerConnectionProperties::MaximumPacketSize | 0x00000020 | Especifica el tamaño máximo de paquete incluyendo la cabecera del mensaje y sus propiedades. |
QMqttServerConnectionProperties::AssignedClientId | 0x00000040 | Especifica si el servidor asigna un identificador de cliente. |
QMqttServerConnectionProperties::MaximumTopicAlias | 0x00000080 | Especifica la cantidad máxima de alias de tema. |
QMqttServerConnectionProperties::ReasonString | 0x00000100 | Especifica una cadena que proporciona más detalles sobre el estado de la conexión. |
QMqttServerConnectionProperties::UserProperty | 0x00000200 | Especifica propiedades de usuario adicionales. |
QMqttServerConnectionProperties::WildCardSupported | 0x00000400 | Especifica si el servidor admite suscripciones comodín. |
QMqttServerConnectionProperties::SubscriptionIdentifierSupport | 0x00000800 | Indica si el servidor admite identificadores de suscripción. |
QMqttServerConnectionProperties::SharedSubscriptionSupport | 0x00001000 | Indica si el servidor admite suscripciones compartidas. |
QMqttServerConnectionProperties::ServerKeepAlive | 0x00002000 | Especifica el número de segundos que el servidor espera un paquete keep alive del cliente. |
QMqttServerConnectionProperties::ResponseInformation | 0x00004000 | Especifica la información de respuesta. |
QMqttServerConnectionProperties::ServerReference | 0x00008000 | Especifica una dirección de servidor alternativa para que el cliente se conecte. |
QMqttServerConnectionProperties::AuthenticationMethod | 0x00010000 | Especifica el método de autenticación. |
QMqttServerConnectionProperties::AuthenticationData | 0x00020000 | Especifica los datos de autenticación. |
El tipo ServerPropertyDetails es un typedef para QFlags<ServerPropertyDetail>. Almacena una combinación OR de valores ServerPropertyDetail.
Documentación de las funciones miembro
QMqttServerConnectionProperties::ServerPropertyDetails QMqttServerConnectionProperties::availableProperties() const
Devuelve las propiedades disponibles especificadas por el servidor.
bool QMqttServerConnectionProperties::clientIdAssigned() const
Devuelve true si el servidor asignó un nuevo identificador de cliente al cliente.
Véase también QMqttClient::clientId().
bool QMqttServerConnectionProperties::isValid() const
Devuelve true si el servidor proporcionó propiedades como parte del reconocimiento de la conexión. Devuelve false si no se han proporcionado propiedades.
quint8 QMqttServerConnectionProperties::maximumQoS() const
Devuelve el nivel máximo de QoS que admite el servidor para la publicación de mensajes. Publicar mensajes con un nivel de QoS superior al nivel de QoS máximo indicado por el servidor es una violación del protocolo.
Si el cliente no necesita soportar QoS 1 o QoS 2, debería restringir el nivel máximo de QoS en cualquier suscripción que haga a un valor que pueda soportar; el servidor publicaría entonces mensajes con el máximo de niveles de QoS soportados y restringidos.
El valor por defecto es 2.
Véase también QMqttClient::publish() y QMqttClient::subscribe().
QString QMqttServerConnectionProperties::reason() const
Devuelve la cadena de razón asociada a esta respuesta.
QMqtt::ReasonCode QMqttServerConnectionProperties::reasonCode() const
Devuelve el código de motivo asociado a esta respuesta.
QString QMqttServerConnectionProperties::responseInformation() const
Devuelve la información de la respuesta.
bool QMqttServerConnectionProperties::retainAvailable() const
Devuelve true si el servidor acepta mensajes retenidos. El valor por defecto es true.
quint16 QMqttServerConnectionProperties::serverKeepAlive() const
Devuelve el número de segundos que el servidor solicitó como keep alive. Esto sobreescribe el keep alive establecido desde el lado del cliente.
Véase también QMqttClient::setKeepAlive().
QString QMqttServerConnectionProperties::serverReference() const
Devuelve una dirección de servidor que el cliente puede utilizar alternativamente para conectarse. Normalmente, se utiliza junto con el código de motivo 0x9c (Utilizar otro servidor) o 0x9c (Servidor trasladado).
bool QMqttServerConnectionProperties::sharedSubscriptionSupported() const
Devuelve true si el servidor acepta suscripciones compartidas. El valor por defecto es true.
bool QMqttServerConnectionProperties::subscriptionIdentifierSupported() const
Devuelve true si el servidor acepta identificadores de suscripción. Los identificadores de suscripción pueden pasarse al servidor cuando se crea una nueva suscripción.
El valor predeterminado es true.
Véase también QMqttSubscriptionProperties::setSubscriptionIdentifier().
bool QMqttServerConnectionProperties::wildcardSupported() const
Devuelve true si el servidor acepta suscripciones que incluyan comodines. El valor por defecto es true.
© 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.
