目次

はじめに
ダウンロードとインストール
使用
開発ガイド

概要

MQTT Xは、macOS、Linux、WindowsをサポートするEMQオープンソース化されたエレガントなクロスプラットフォーム MQTT 5.0 デスクトップクライアントです。

MQTT Xの UI は、チャットソフトウェアのような形でページの操作ロジックを簡素化します。ユーザーが MQTT/MQTTS接続、 MQTTメッセージのPub/Sub機能をすばやくテストできるようにするために、接続をすばやく作成し、複数のクライアントを保存することができます。

ダウンロードとインストールする前に、公式WebサイトまたはGitHubにアクセスして、最新バージョン情報を確認して入手してください。最新バージョンはエクスペリエンスの向上に役立ちます。このプロジェクトによく知っている場合は、MQTT Xウェアハウスのソースコードを直接クローンし、パッケージ化して、自分で使用できます。使用中に質問がある場合は、GitHubの問題にアクセスして質問や意見を投稿するか、プロジェクトをフォークして、改訂されたPRを送信してください。我々は慎重に検討し、返信します。

クイックプレビュー

Windows、macOS、Linuxをサポートします
MQTT v3.1.1 と MQTT v5.0 をサポートします
CA、自己署名証明書と一方向および双方向SSL証明書をサポートします
ライト、ダーク、ナイト(パープル)3テーマモード切り替え
日本語、英語と簡略化された中国語をサポートします
MQTTサーバーへのWebSocket接続をサポートします
トピックを購読するときにカラーマークをカスタマイズできます
$SYS トピックの自動購読をサポートし、レベルごとに拡張できます
Hex、Base64、JSON、Plaintextなど複数のペイロード形式をサポートします

ダウンロードとインストール

GitHubリリースから自分に合ったバージョンをダウンロードしてインストールしてください。

GitHubからのダウンロード時にネットワーク速度の低下やストールを引き起こすネットワーク上の問題がある場合は、こちらをクリックして、自分に合ったのを選択することもできます。

注意：ダウンロードするとき最新バージョンをダウンロードしてみてください。

macOS

macOSユーザーの場合、Mac AppStoreからダウンロードすることをお勧めします。

インストール用にファイルをダウンロードする時最初にインストールパッケージファイルを dmg形式でダウンロードしてください。mac.zipの圧縮ファイルをダウンロードすることもできます。

注意：ただし、 macOSシステムのバージョンが異なると、zip圧縮パッケージを使用すると 10.15.2システムバージョンで解凍後に開くことができない場合がありますので、最初にdmgファイルを選択してください。

Windows

Windowsユーザーの方は、最新バージョンのexeファイルをダウンロードしてください。ダウンロード後、Setupプロンプトに従ってインストールしてください。

Linux

Linuxユーザーは、最新バージョンのAppImageあるいはsnapファイル使用してインストールしてください。

snap形式のファイルを使用してインストールする場合は、次のコマンドを実行してすばやくインストールするか、SnapStoreに直接アクセスすることもできます。

sudo snap install mqttx

注意： snapファイルを使用してインストールする場合、インストールする権限が不十分であるという問題が発生する可能性があります。詳細については、このissue[https://github.com/emqx/MQTTX/issues/109]を参照してください。

使用

MQTTブローカーの準備

ローカルにデプロイされたMQTTBrokerが必要ない場合は、EMQ Xのオンラインパブリックバージョンを使用して簡単にテストできます。
```
ブローカーアドレス：broker.emqx.io
ブローカーTCPポート：1883
ブローカーSSLポート：8883
```
ローカルで実行されているMQTTBrokerを展開する場合は、EMQ Xをダウンロードをインストールして使用することをお勧めします。 EMQ Xは完全にオープンソースで、可用性が高く、レイテンシが低いミリオンレベルの分散型IoT MQTT5.0メッセージングサーバーです。

Dockerを使用してEMQXをすばやくインストールします。
```
docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqx/emqx
```

すばやく接続を確立する

MQTT Brokerを準備したら、メインプログラムページに入り、左側のメニューバーの+記号をクリックします。ページにデータがない場合は、右側の[新しい接続]ボタンをクリックして、新しいクライアントを設定することもできます。

クライアント関連情報

作成ページに入った後、クライアントに接続する関連情報を設定または入力する必要があります。

ブローカー情報

Broker情報を設定する時、Client ID、 ホスト、およびポートがデフォルトで入力されました、実際の Broker情報に従って変更することもできます。 Client IDの右側にある更新ボタンをクリックして、新しい Client IDを生成できます。

ホストの前の選択ボックスは、接続のプロトコルを選択するために使用されます。mqtt://、 ws://をサポートします。SSL/TLS認証接続の場合は、mqtts://、wss://を変更してください。

注意：プロトコルを変更する場合は、接続されているポートを変更する必要があります。

ユーザー認証情報

ブローカーがユーザー認証を有効にしている場合は、設定項目にユーザー名 と パスワードの情報を入力できます。

SSL/TLS

SSL/TLS認証を有効にする必要がある場合は、設定内のSSL/TLS設定アイテムを trueに設定するだけでよく、CA signed selfとSelf signedの2つの方法を提供します。

Self signedを選択するの場合、証明書を設定することが必要です。右端のフォルダボタンをクリックして、生成した各証明書を選択できます。一方向接続の場合は、CA ファイルを選択するだけで済みます。双方向認証の場合は、クライアント証明書 と クライアント証明書キーファイルも設定する必要があります。 SSL証明書オプションをオンにすると、より完全な証明書検証接続が有効になります。通常、正式な環境をテストするときに有効にすることをお勧めします。

詳細設定

詳細設定では、接続タイムアウト、Keep Alive、セッションクリア、自動再接続、MQTTバージョンなどを設定できます。
MQTT 5.0

詳細設定では、MQTTのプロトコルバージョンを選択し、MQTTv3.1.1およびMQTTv5.0バージョンをサポートします。デフォルトはv3.1.1です。v5.0バージョンを選択した場合は、セッション有効期限、最大受信数、トピックエイリアスの最大値(オプション)も設定できます。

遺言

詳細設定の設定カードで、遺言を設定できます。遺言 Qosと遺言 Retainの値はデフォルトで 0 と False で入力されました。遺言トピックと入力すると遺言Payloadの値を追加した後、遺言メッセージの設定を完了することができます。

設定が完了したら、右上隅にある[接続]ボタンをクリックして、接続をすばやく作成し、MQTTブローカーに接続します。

メッセージPub/Sub

メインインターフェース

接続が成功したら、接続のメインインターフェイスに入り、上部の接続名の横にある折りたたみボタンをクリックすると、設定のいくつかの基本情報を展開して表示できます。これは、接続のいくつかの一般的な設定を変更するのに便利であり、変更するときは切断する必要があります。接続し、もう一度接続をクリックして有効にします。接続が成功するたびに、パネルが自動的に折りたたまれます。切断状態では、右側の設定ボタンをクリックして、接続設定をさらに変更することもできます。

サブスクリプション追加

左下隅にあるサブスクリプション追加ボタンをクリックすると、すばやくトピックを追加できます。各トピックに色を付けることができ、ランダムに生成するか、それともカラーピッカーを開いて選択できます。サブスクリプションリストの上部にある右端のボタンを使用すると、サブスクリプションリストを非表示にして、ページのサイズを増やすことができます。追加が完了したら、サブスクリプションリストでサブスクライブされたトピックアイテムをクリックして、メッセージフィルタリングを実行します。メッセージビューでは、現在のトピックにサブスクライブされたメッセージコンテンツのみが表示されます。もう一度クリックするとフィルタリングがキャンセルされます。他のサブスクライブされたトピックアイテムを直接クリックすることもできます。対応するメッセージの内容を表示します。また、トピック名をクリックして、現在のトピック情報をすばやくコピーします。トピックにメッセージを送信する必要がある場合は、メッセージバーのトピック入力ボックスに貼り付けて変更するだけで、操作をすばやく完了できます。

トピックを追加する場合、トピックごとにエイリアスを設定できます。このオプションはオプションです。サブスクリプションを設定して追加すると、サブスクリプションリストのトピックデータがエイリアスとして表示され、マウスをトピックに合わせます。アイテム、プロンプトボックスには、トピックの元の値も表示されます。これは、監視する必要のある複数のトピックが長すぎてトピックの特定の意味を区別できない場合に非常に役立ちます。

メッセージの送受信

Topicのサブスクリプションが成功したら、メッセージの送受信をテストできます。ページの右下隅にサブスクライブしたばかりのトピック情報を入力し、QoSの値を選択するか、あるいはRetainを選択して、を選択するを入力して、右端の送信ボタンをクリックし、サブスクライブしたばかりのトピックに送信します。メッセージを送信しました。正常に送信した後、送信したばかりのメッセージをすぐに受信することもできます。メッセージボックスの右側の列が送信済みメッセージであることに注意してください。左の列は受信したメッセージを示しています。 macOSユーザーは command + enterショートカットキーを使用でき、他のユーザーは control + enterショートカットキーを使用してメッセージをすばやく送信できます。

メッセージバーの payloadオプションは、メッセージを複数の形式にすばやく変換し、Base64、 Hex、JSON、および Plaintextをサポートします。

これで、 MQTTメッセージのテストは完了しました。

セットアップ

左側のメニューバーの下部にある設定ボタンをクリックするか、ショートカットキーを使用すると、macOSユーザーは command + ,ショートカットキーを使用でき、他のユーザーは control + ,ショートカットキーを使用して設定ページにジャンプできます。現在、言語の選択がサポートされています。更新を自動的にチェックしてテーマを選択するかどうか、および高度な機能のデータのバックアップと復元の機能をオンにします。

データ管理

詳細設定には、データのバックアップおよびバックアップ機能が含まれます。ユーザーは、2つのインポート方法とエクスポート方法を選択するか、接続ページの右上のメニュー、または設定ページの詳細機能バーから選択できます。

設定ページで、下部にある高度な機能のデータバックアップボタンとデータバックアップボタンをクリックすることを選択できます。データバックアップを選択すると、送受信されたすべてのメッセージを含むすべての接続データがエクスポートされます。データバックアップを選択する場合、インポートしたファイルのパスを選択した後、確認後にデータをバックアップできます。ファイルフォーマットは JSON, XML, CSV, Excel をサポートしています。

その他

接続操作

上部の操作バーのボタンをクリックすると、すばやく切断したり、現在の接続を削除したり、現在のデータをインポートおよびエクスポートしたりできます。

メッセージ処理

メッセージバーの右上隅にあるすべて、受信済み、送信済みボタンで除外できます
すべてのメッセージ、受信されたメッセージ、および公開したメッセージ。

上部のアクションバーのボタンをクリックするか、内容検索項目を選択するか、ショートカットキーを使用すると、macOSユーザーはcommand + fショートカットキーを使用でき、他のユーザーはcontrol + fショートカットキーを使用してトピックを押して検索を開くことができます。この関数は、サブジェクトのファジークエリをサポートします。

上部の操作バーボタンをクリックし、履歴データの削除項目を選択して、現在の接続で送受信されたメッセージをすばやくクリアします。

アップデートを確認する

MQTT Xのバージョン情報とEMQ Xのバージョン情報については、左下のiボタンをクリックしてAboutページに入ります。関連情報。 バージョンチェックをクリックして、更新されたバージョンがあるかどうかを確認します。

再接続の最大数

自動更新チェックでは、最大数の再接続設定があり、整数で設定できます。 Brokerが切断または接続に失敗した場合、再接続の数がこの値を超えると、接続は完全に切断されます。
マルチウィンドウ
接続リストで、右クリックして[新しいウィンドウ]を選択し、接続用の新しいウィンドウを作成します。新しいウィンドウでは、接続、トピックのサブスクライブ、メッセージの公開と受信などもできます。
作成された複数の接続間に接続がある場合、または、同時に受信したメッセージを表示する必要がある場合は、複数のビューウィンドウを作成して同時に表示することができます。