Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

docs: add faq #783

Merged
merged 3 commits into from
Nov 18, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions docs/manual-cn.md
Original file line number Diff line number Diff line change
Expand Up @@ -292,6 +292,30 @@ Windows: `vue-cli-service electron:build --win`

Linux: `vue-cli-service electron:build --linux`

## FAQ

**Q: MQTT 客户端是什么?**

MQTT 客户端是任何运行 MQTT 库并通过网络连接到 MQTT Broker 的设备。发布者和订阅者指的是客户端当前是发布消息还是订阅接收消息,发布者和订阅者可以都是一个 MQTT 客户端,(发布和订阅功能也可以在同一个 MQTT 客户端中实现)。MQTT 客户端可以是一个非常小的、资源有限的设备,也可以是一台运行图形化 MQTT 客户端的典型计算机软件,基本上用于测试目的。因此可以简单理解任何通过 TCP/IP 协议连接到 MQTT 服务的设备或软件都可以被称为 MQTT 客户端。

**Q: 为什么使用 MQTT X?**

MQTT X 是一款开源的跨平台 MQTT 桌面客户端工具。可以用于正在搭建自己的 MQTT 的消息服务器的用户,或者正在开发 MQTT Broker 和研究学习 MQTT 的相关用户学习来测试连接,订阅和发布消息等。用户可以快速建立多个连接客户端,方便快速测试 MQTT/TCP、MQTT/TLS 的连接、发布/订阅功能及其他特性。在 MQTT 的研究与应用中可以通过 MQTT X 快速、深入地理解 MQTT 协议相关特性。

**Q: MQTT X 为什么采用聊天软件的设计?**

基于对 MQTT 协议中发布订阅的理解,我们使用聊天软件的交互形式来帮助用户快速理解 MQTT 协议的核心内容,比如新建一个连接,可以想象为用户 A,订阅一个 Topic,即加入一个聊天频道,再新建一个连接,即为用户 B,向用户 A 订阅过的 Topic 发布一条消息,我们可以在用户 A 的页面中接收到用户 B 发送过来的消息。而中间转发消息的服务即为 MQTT Broker。其实在 IoT 世界中也是这样的,设备之间可以利用 MQTT 这样发布订阅的特性来进行通讯。而 MQTT X 将其进行模拟并转化到用户界面中,帮助用户更快的理解和测试 MQTT 相关内容。

**Q: MQTT X 是免费的吗?**

是的。完全开源,详情见 [LICENSE](https://github.com/emqx/MQTTX/blob/master/LICENSE)。

**Q: 当您使用 MQTT X 遇到问题时,该怎么做?**

1. 您可以打开 MQTT X 的 [GitHub](https://github.com/emqx/MQTTX) 链接,进入到 [issue](https://github.com/emqx/MQTTX/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc) 区,点击提交 issue 来反馈问题。
2. 中文用户可以到我们的[EMQ 问答社区](https://askemq.com/c/tools/11)来进行问题反馈。
3. 最后可以通过以下联系方式联系我们,反馈您使用中的任何问题。

## 联系方式

| 方式 | 内容 |
Expand Down
24 changes: 24 additions & 0 deletions docs/manual-jp.md
Original file line number Diff line number Diff line change
Expand Up @@ -277,6 +277,30 @@ Windows: `vue-cli-service electron:build --win`

Linux: `vue-cli-service electron:build --linux`

## FAQ

**Q:MQTTクライアントとは何ですか?**A.

MQTTクライアントとは、MQTTライブラリを実行し、ネットワーク経由でMQTTブローカーに接続されているあらゆるデバイスのことです。 パブリッシャーとサブスクライバーは、クライアントが現在、メッセージを発行しているか、あるいはメッセージを受信するためにサブスクライブしているかを意味します。 基本的にはテスト用です。 つまり、TCP/IPプロトコルでMQTTサービスに接続するあらゆる機器やソフトウェアをMQTTクライアントと呼ぶことができる、と簡単に理解できる。

**Q: なぜMQTT Xを使うのですか?**

MQTT Xは、オープンソースでクロスプラットフォームのMQTTデスクトップクライアントツールです。 MQTT用のメッセージングサーバーを独自に構築しているユーザーや、MQTT Brokerを開発しているユーザーで、接続テストやメッセージのサブスクライブ、パブリッシュなど、MQTTの勉強をしているユーザーが利用できます。 ユーザーは複数の接続クライアントを素早く設定し、MQTT/TCP、MQTT/TLS接続、パブリッシュ/サブスクライブ機能などを素早くテストすることができます。 MQTT Xでは、MQTTの研究やアプリケーションにおいて、MQTTプロトコル関連の機能を素早くかつ深く理解することができます。

**Q:MQTT Xがチャットソフトのデザインを採用した理由を教えてください。**

MQTTプロトコルのpublish-subscribeの理解に基づき、ユーザーAを想定した新しいコネクションの作成、トピックへのサブスクライブ(チャットチャンネルへの参加)、ユーザーBを想定した新しいコネクションの作成、ユーザーAがサブスクライブしたトピックへのメッセージの投稿など、MQTTプロトコルのコアコンテンツをユーザーがすぐに理解できるように、チャットソフトウェアのインタラクティブな形態を採用しています。 ユーザーBからのメッセージを、ユーザーAのページで受け取ることができます。 実はIoTの世界でも、MQTTのパブリッシュ・サブスクライブ機能を使ってデバイス同士が通信することができます。 MQTT Xはこれをエミュレートしてユーザーインターフェースに変換し、ユーザーがMQTT関連のコンテンツをより早く理解してテストできるようにしています。

**Q:MQTT Xは無料ですか?**

はい。 完全なオープンソースです。詳細は[LICENSE](https://github.com/emqx/MQTTX/blob/master/LICENSE)をご覧ください。

**Q:MQTT Xで問題が発生した場合はどうしますか?**

1.MQTT Xの[GitHub](https://github.com/emqx/MQTTX)リンクを開き、[issue](https://github.com/emqx/MQTTX/issues?q=is%3Aissue+is%3Aopen+)にアクセスしてください。 sort%3Aupdated-desc)のエリアに移動し、問題を送信するをクリックしてフィードバックを与える。 2.
2.中国のユーザーは、私たちの[EMQ Q&Aコミュニティ](https://askemq.com/c/tools/11)でフィードバックをすることができます。 3.
最後に、お客様がお持ちの問題についてフィードバックをいただくために、下記の連絡先からご連絡いただけます。

## 連絡先

- [EMQX Slack](https://slack-invite.emqx.io/)
Expand Down
24 changes: 24 additions & 0 deletions docs/manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -292,6 +292,30 @@ Windows: `vue-cli-service electron:build --win`

Linux: `vue-cli-service electron:build --linux`

## FAQ

**Q: What is the MQTT Client?**

The MQTT client is that any device runs the MQTT library and connects to the MQTT Broker over the network. Publishers and subscribers refer to the client currently is publishing messages or subscribing to receive them. publishers and subscribers can be the same MQTT client, (publishing and subscribing functionality can also be implemented in the same MQTT client). an MQTT client can be a very small device with limited resources, or it can be a typical piece of computer software running a graphical user interface MQTT client, basically for testing purposes. So it can be simply understood that any device or software that connects to the MQTT service over the TCP/IP protocol can be called an MQTT client.

**Q: Why use MQTT X?**

MQTT X is an open source cross-platform MQTT desktop client tool. It can be used by users who are building their own messaging servers for MQTT, or by users who are developing MQTT Broker and studying and learning about MQTT to test connections, subscribe and publish messages, etc. Users can quickly set up multiple connection clients to quickly test MQTT/TCP, MQTT/TLS connections, publish/subscribe functionality and other features. MQTT X provides a quick, in-depth understanding of MQTT protocol-related features for MQTT research and applications.

**Q: Why does MQTT X use the UI design of chat software?**

Based on the understanding of the MQTT protocol of pub/sub model, MQTT X simplifies the operation logic of the page with the help of chatting software. For example, create a new connection as a User A, subscribe to a Topic, just like to join a chat channel, and then create a new connection as a User B, publish a message to the Topic that User A has subscribed to, we can receive the message from User B in User A's page. In fact, in the IoT world as well, devices can use pub/sub feature of MQTT to communicate with each other. MQTT X emulates this and translates it into the user interface to help users understand and test MQTT-related content faster.

**Q: Is MQTT X free?**

Yes. Fully open source, see the [LICENSE](https://github.com/emqx/MQTTX/blob/master/LICENSE) for details.

**Q: What do you do when you have problems with MQTT X?**

1. You can visit the [GitHub](https://github.com/emqx/MQTTX) for MQTT X, go to the [issue](https://github.com/emqx/MQTTX/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc) tab and click on submit issue to give feedback.
2. or you can go to our GitHub [Discussions](https://github.com/emqx/MQTTX/discussions) tab to give feedback.
3. Finally, you can contact us at the community information below to give us feedback on any issues you may have.

## Community, discussion, contribution, and support

You can reach the EMQ community and developers via the following channels:
Expand Down