QMqtt Namespace

Qt MQTT モジュール全体で使用される雑多な識別子を含む。さらに...

ヘッダ	`#include <QMqtt>`
CMake：	`find_package(Qt6 REQUIRED COMPONENTS Mqtt)` `target_link_libraries(mytarget PRIVATE Qt6::Mqtt)`
qmake：	`QT += mqtt`

タイプ

enum class	MessageStatus { Unknown, Published, Acknowledged, Received, Released, Completed }
enum class	PayloadFormatIndicator { Unspecified, UTF8Encoded }
enum class	ReasonCode { Success, SubscriptionQoSLevel0, SubscriptionQoSLevel1, SubscriptionQoSLevel2, NoMatchingSubscriber, …, WildCardSubscriptionsNotSupported }

詳細な説明

型の説明

enum class QMqtt::MessageStatus

この列挙型は、メッセージの利用可能なステータスを指定する。クライアントの QoS と役割に応じて、異なるメッセージ・ステータスが期待されます。

定数	値	説明
`QMqtt::MessageStatus::Unknown`	`0`	メッセージ・ステータスは不明です。
`QMqtt::MessageStatus::Published`	`1`	クライアントは、そのサブスクリプションの 1 つに対するメッセージを受信しました。これは QoS レベル 1 と 2 に適用されます。
`QMqtt::MessageStatus::Acknowledged`	`2`	メッセージが確認されました。これは QoS 1 に適用され、クライアント側からのメッセージ処理が終了したことを示します。
`QMqtt::MessageStatus::Received`	`3`	メッセージが受信されました。これは QoS 2 に適用されます。
`QMqtt::MessageStatus::Released`	`4`	メッセージがリリースされました。これは QoS 2 に適用される。
`QMqtt::MessageStatus::Completed`	`5`	メッセージが完了した。これは QoS 2 に適用され、クライアント側からのメッセージ処理が終了したことを示す。

enum class QMqtt::PayloadFormatIndicator

ペイロード・フォーマットは、メッセージの内容に関する情報を提供する。これは、他のクライアントがメッセージをより速く処理するのに役立ちます。

定数	値	説明
`QMqtt::PayloadFormatIndicator::Unspecified`	`0`	フォーマットは指定されません。
`QMqtt::PayloadFormatIndicator::UTF8Encoded`	`1`	メッセージのペイロードは UTF-8 Encoded Character Data としてフォーマットされます。

enum class QMqtt::ReasonCode

この列挙型は、利用可能なエラーコードを指定する。

定数	値	説明
`QMqtt::ReasonCode::Success`	`0`	指定されたアクションは成功しました。
`QMqtt::ReasonCode::SubscriptionQoSLevel0`	`0`	QoS レベル 0 のサブスクリプションが作成されました。
`QMqtt::ReasonCode::SubscriptionQoSLevel1`	`0x01`	QoS レベル 1 のサブスクリプションが作成されました。
`QMqtt::ReasonCode::SubscriptionQoSLevel2`	`0x02`	QoS レベル 2 のサブスクリプションが作成されました。
`QMqtt::ReasonCode::NoMatchingSubscriber`	`0x10`	メッセージはサーバーによって受け入れられたが、このメッセージを受信するサブスクライバーが存在しない。ブローカは Success の代わりにこの理由コードを送るかもしれない。
`QMqtt::ReasonCode::NoSubscriptionExisted (since Qt 5.15)`	`0x11`	クライアントによって一致するトピックフィルタが使用されていません。
`QMqtt::ReasonCode::ContinueAuthentication (since Qt 5.15)`	`0x18`	別の手順で認証を続行してください。
`QMqtt::ReasonCode::ReAuthenticate (since Qt 5.15)`	`0x19`	再認証を開始します。
`QMqtt::ReasonCode::UnspecifiedError`	`0x80`	特定できないエラーが発生した。
`QMqtt::ReasonCode::MalformedPacket`	`0x81`	サーバーに送信されたパケットが無効です。
`QMqtt::ReasonCode::ProtocolError`	`0x82`	プロトコルエラーが発生しました。ほとんどの場合、これによってサーバはクライアントを切断する。
`QMqtt::ReasonCode::ImplementationSpecificError`	`0x83`	パケットは有効だが、受信者が拒否した。
`QMqtt::ReasonCode::UnsupportedProtocolVersion`	`0x84`	要求されたプロトコルのバージョンがサーバーでサポートされていない。
`QMqtt::ReasonCode::InvalidClientId`	`0x85`	クライアントIDが無効である。
`QMqtt::ReasonCode::InvalidUserNameOrPassword`	`0x86`	指定されたユーザー名またはパスワードが無効です。
`QMqtt::ReasonCode::NotAuthorized`	`0x87`	クライアントが指定されたアクションを許可されていない。
`QMqtt::ReasonCode::ServerNotAvailable`	`0x88`	接続先のサーバーが利用できません。
`QMqtt::ReasonCode::ServerBusy`	`0x89`	接続先のサーバーが利用できません。クライアントは、後日接続を試みるように要求されます。
`QMqtt::ReasonCode::ClientBanned`	`0x8A`	クライアントがサーバーから禁止されています。
`QMqtt::ReasonCode::InvalidAuthenticationMethod`	`0x8C`	指定された認証方法が無効です。
`QMqtt::ReasonCode::InvalidTopicFilter`	`0x8F`	指定されたトピックフィルタが無効です。
`QMqtt::ReasonCode::InvalidTopicName`	`0x90`	指定されたトピック名が無効です。
`QMqtt::ReasonCode::MessageIdInUse`	`0x91`	前のパケットで使用されたメッセージIDがすでに使用されている。
`QMqtt::ReasonCode::MessageIdNotFound`	`0x92`	前のパケットで使用されたメッセージIDが見つかりません。
`QMqtt::ReasonCode::PacketTooLarge`	`0x95`	受信したパケットが大きすぎる。QMqttServerConnectionProperties::maximumPacketSize()も参照のこと。
`QMqtt::ReasonCode::QuotaExceeded`	`0x97`	管理上の制限を超えました。
`QMqtt::ReasonCode::InvalidPayloadFormat`	`0x99`	ペイロードの形式が無効である。QMqttPublishProperties::payloadFormatIndicator() も参照してください。
`QMqtt::ReasonCode::RetainNotSupported`	`0x9A`	サーバーが保持メッセージに対応していません。QMqttServerConnectionProperties::retainAvailable() も参照してください。
`QMqtt::ReasonCode::QoSNotSupported`	`0x9B`	要求された QoS レベルがサポートされていません。QMqttServerConnectionProperties::maximumQoS()も参照。
`QMqtt::ReasonCode::UseAnotherServer`	`0x9C`	クライアントが接続しようとしたサーバは使用できません。QMqttServerConnectionProperties::serverReference() も参照してください。
`QMqtt::ReasonCode::ServerMoved`	`0x9D`	クライアントが接続しようとしたサーバーが新しいアドレスに移動しました。QMqttServerConnectionProperties::serverReference() も参照してください。
`QMqtt::ReasonCode::SharedSubscriptionsNotSupported`	`0x9E`	共有サブスクリプションはサポートされていません。QMqttServerConnectionProperties::sharedSubscriptionSupported() も参照してください。
`QMqtt::ReasonCode::ExceededConnectionRate`	`0x9F`	接続率の制限を超えました。
`QMqtt::ReasonCode::SubscriptionIdsNotSupported`	`0xA1`	サブスクリプション ID はサポートされていません。QMqttServerConnectionProperties::subscriptionIdentifierSupported() も参照してください。
`QMqtt::ReasonCode::WildCardSubscriptionsNotSupported`	`0xA2`	ワイルドカードを使用したサブスクリプションはサポートされていません。QMqttServerConnectionProperties::wildcardSupported() も参照してください。

すべてのユースケースですべての値が使用できるわけではありません。特に、特定のコマンドに適さない理由コードを拒否するサーバーもあります。特定のアクションで期待される理由コードは以下の表を参照。

理由コード	接続プロパティ	サブスクリプションのプロパティ	メッセージのプロパティ
成功	X	X	X
サブスクリプションQoSLevel0		X
サブスクリプションQoSLevel1		X
サブスクリプションQoSLレベル2		X
サブスクライバーの一致なし			X
特定できないエラー	X	X	X
不正パケット	X
プロトコルエラー	X
実装固有のエラー	X	X	X
サポートされていないプロトコルバージョン	X
無効なクライアントID	X
無効なユーザー名またはパスワード	X
未承認	X	X	X
サーバー使用不可	X
サーバー使用中	X
クライアント禁止	X
無効な認証方法	X
無効なトピックフィルタ		X
無効なトピック名	X		X
MessageIdInUse		X	X
MessageIdNotFound			X
パケットが大きすぎる	X
クォータ超過	X	X	X
無効なペイロードフォーマット	X		X
サポートされていない保持	X
QoSNotSupported	X
別のサーバーを使用	X
サーバー移動	X
共有サブスクリプション非サポート		X
接続レート超過	X
サポートされていないサブスクリプションID		X
サポートされていないワイルドカード・サブスクリプション		X

© 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.