QMqttPublishProperties Class
QMqttPublishProperties 클래스는 메시지를 보내거나 받기 위한 구성 옵션을 나타냅니다. 더 보기...
| Header: | #include <QMqttPublishProperties> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Mqtt)target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
| qmake: | QT += mqtt |
공용 타입
| enum | PublishPropertyDetail { None, PayloadFormatIndicator, MessageExpiryInterval, TopicAlias, ResponseTopic, …, ContentType } |
| flags | PublishPropertyDetails |
공용 함수
| QMqttPublishProperties::PublishPropertyDetails | availableProperties() const |
| QString | contentType() const |
| QByteArray | correlationData() const |
| quint32 | messageExpiryInterval() const |
| QMqtt::PayloadFormatIndicator | payloadFormatIndicator() const |
| QString | responseTopic() const |
| void | setContentType(const QString &type) |
| void | setCorrelationData(const QByteArray &correlation) |
| void | setMessageExpiryInterval(quint32 interval) |
| void | setPayloadFormatIndicator(QMqtt::PayloadFormatIndicator indicator) |
| void | setResponseTopic(const QString &topic) |
| void | setSubscriptionIdentifiers(const QList<quint32> &ids) |
| void | setTopicAlias(quint16 alias) |
| void | setUserProperties(const QMqttUserProperties &properties) |
| QList<quint32> | subscriptionIdentifiers() const |
| quint16 | topicAlias() const |
| QMqttUserProperties | userProperties() const |
상세 설명
QMqttClient::publish()를 호출하여 브로커에 메시지를 보내려면 브로커에서 메시지가 어떻게 처리되어야 하는지에 대한 추가 인수를 제공하는 QMqttPublishProperties를 포함할 수 있습니다.
또한 인스턴스화된 구독으로 메시지를 수신하는 경우 서버에서 전달하거나 조정한 게시 속성이 포함될 수 있습니다.
참고: 게시 속성은 MQTT 5.0 사양의 일부이며 더 낮은 프로토콜 레벨로 연결할 때는 사용할 수 없습니다. 자세한 내용은 QMqttClient::ProtocolVersion 을 참조하세요.
멤버 유형 문서
열거형 QMqttPublishProperties::게시프로퍼티디테일
플래그 QMqttPublishProperties::게시프로퍼티디테일
이 열거형 타입은 메시지를 생성할 때 서버 또는 클라이언트가 설정할 수 있는 프로퍼티를 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
QMqttPublishProperties::None | 0x00000000 | 속성이 지정되지 않았습니다. |
QMqttPublishProperties::PayloadFormatIndicator | 0x00000001 | 메시지의 콘텐츠 유형입니다. |
QMqttPublishProperties::MessageExpiryInterval | 0x00000002 | 메시지가 유효한 기간입니다. |
QMqttPublishProperties::TopicAlias | 0x00000004 | 이 메시지의 주제 별칭입니다. |
QMqttPublishProperties::ResponseTopic | 0x00000008 | 수신자가 응답해야 하는 주제입니다. |
QMqttPublishProperties::CorrelationData | 0x00000010 | 응답 메시지의 식별자입니다. |
QMqttPublishProperties::UserProperty | 0x00000020 | 사용자가 설정한 추가 속성입니다. |
QMqttPublishProperties::SubscriptionIdentifier | 0x00000040 | 발행물과 일치하는 구독의 식별자입니다. |
QMqttPublishProperties::ContentType | 0x00000080 | 메시지 콘텐츠에 대한 설명입니다. |
게시 프로퍼티 세부 정보 유형은 QFlags<PublishPropertyDetail>에 대한 typedef입니다. 게시프로퍼티디테일 값의 OR 조합을 저장합니다.
멤버 함수 문서
QMqttPublishProperties::PublishPropertyDetails QMqttPublishProperties::availableProperties() const
이 인스턴스에 지정된 사용 가능한 속성을 반환합니다. 메시지가 생성될 때 모든 속성을 포함할 필요는 없습니다. 이 함수는 명시적으로 설정된 프로퍼티를 표시하는 역할을 합니다.
QString QMqttPublishProperties::contentType() const
메시지의 콘텐츠 유형을 반환합니다.
setContentType()도 참조하세요 .
QByteArray QMqttPublishProperties::correlationData() const
상관관계 데이터를 반환합니다.
setCorrelationData()도 참조하세요 .
quint32 QMqttPublishProperties::messageExpiryInterval() const
메시지 만료 간격을 반환합니다. 이 값은 서버가 메시지를 전달할 수 있는 시간(초)을 지정합니다. 이 간격이 만료되면 서버는 메시지를 삭제하고 게시를 중단해야 합니다.
setMessageExpiryInterval()도 참조하세요 .
QMqtt::PayloadFormatIndicator QMqttPublishProperties::payloadFormatIndicator() const
페이로드 형식 표시기를 반환합니다.
setPayloadFormatIndicator()도 참조하세요 .
QString QMqttPublishProperties::responseTopic() const
사용자가 요청에 대한 후속 조치로 사용해야 하는 응답 주제를 반환합니다.
setResponseTopic()도 참조하세요 .
void QMqttPublishProperties::setContentType(const QString &type)
메시지의 콘텐츠 유형을 type 로 설정합니다.
contentType()도 참조하세요 .
void QMqttPublishProperties::setCorrelationData(const QByteArray &correlation)
상관관계 데이터를 correlation 로 설정합니다.
correlationData()도 참조하세요 .
void QMqttPublishProperties::setMessageExpiryInterval(quint32 interval)
메시지 만료 간격을 interval 로 설정합니다.
messageExpiryInterval()도 참조하세요 .
void QMqttPublishProperties::setPayloadFormatIndicator(QMqtt::PayloadFormatIndicator indicator)
페이로드 형식 표시기를 indicator 로 설정합니다.
payloadFormatIndicator()도 참조하세요 .
void QMqttPublishProperties::setResponseTopic(const QString &topic)
응답 주제를 topic 로 설정합니다.
responseTopic()도 참조하세요 .
void QMqttPublishProperties::setSubscriptionIdentifiers(const QList<quint32> &ids)
구독 식별자를 ids 로 설정합니다.
subscriptionIdentifiers()도 참조하세요 .
void QMqttPublishProperties::setTopicAlias(quint16 alias)
메시지를 게시하기 위한 토픽 별칭을 alias 으로 설정합니다. 토픽 별칭 값은 0보다 크고 서버에서 지정한 최대 토픽 별칭보다 작아야 합니다.
topicAlias() 및 QMqttServerConnectionProperties::maximumTopicAlias()도 참조하세요 .
void QMqttPublishProperties::setUserProperties(const QMqttUserProperties &properties)
메시지의 사용자 속성을 properties 로 설정합니다.
userProperties()도 참조하세요 .
QList<quint32> QMqttPublishProperties::subscriptionIdentifiers() const
메시지의 주제 필터와 일치하는 구독의 구독 식별자를 반환합니다.
setSubscriptionIdentifiers()도 참조하세요 .
quint16 QMqttPublishProperties::topicAlias() const
메시지를 게시하는 데 사용된 주제 별칭을 반환합니다.
setTopicAlias()도 참조하세요 .
QMqttUserProperties QMqttPublishProperties::userProperties() const
메시지의 사용자 속성을 반환합니다.
setUserProperties()도 참조하세요 .
© 2025 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.
