이 페이지에서

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::None0x00000000속성이 지정되지 않았습니다.
QMqttPublishProperties::PayloadFormatIndicator0x00000001메시지 콘텐츠의 유형입니다.
QMqttPublishProperties::MessageExpiryInterval0x00000002메시지가 유효한 기간.
QMqttPublishProperties::TopicAlias0x00000004이 메시지의 토픽 별칭입니다.
QMqttPublishProperties::ResponseTopic0x00000008수신자가 응답해야 할 토픽입니다.
QMqttPublishProperties::CorrelationData0x00000010응답 메시지의 식별자입니다.
QMqttPublishProperties::UserProperty0x00000020사용자가 설정한 추가 속성.
QMqttPublishProperties::SubscriptionIdentifier0x00000040해당 게시물과 일치하는 구독의 식별자.
QMqttPublishProperties::ContentType0x00000080메시지 내용에 대한 설명입니다.

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.