QMqttPublishProperties Class
QMqttPublishProperties 클래스는 메시지를 송수신하기 위한 구성 옵션을 나타냅니다. 더 보기...
| 헤더: | #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 를 참조하십시오.
멤버 유형 문서
enum QMqttPublishProperties::PublishPropertyDetail
flags QMqttPublishProperties::PublishPropertyDetails
이 열거형 유형은 메시지를 생성할 때 서버 또는 클라이언트가 설정할 수 있는 속성을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
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 | 메시지 내용에 대한 설명입니다. |
PublishPropertyDetails 유형은 QFlags<PublishPropertyDetail>에 대한 typedef입니다. 이 유형은 PublishPropertyDetail 값들의 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()도 참조하십시오 .
© 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.