# README

by [mcxiaoke](https://github.com/mcxiaoke)

**最新版本: v1.0.6 2021.07.07**

## 文档地址

* [MQTT Monitor](https://github.com/mcxiaoke/mqtt-monitor/)
* [MQTT项目文档](https://blog.mcxiaoke.com/mqtt/)
* [GitBook阅读](https://mcxiaoke.gitbook.io/mqtt/)
* [Wiki文档地址](https://github.com/mcxiaoke/mqtt/wiki)
* [PDF和ePub下载](https://www.gitbook.com/book/mcxiaoke/mqtt-cn/details)
* [中文翻译项目](https://github.com/mcxiaoke/mqtt)

## 概述

MQTT是一个客户端服务端架构的发布/订阅模式的消息传输协议。它的设计思想是轻巧、开放、简单、规范，易于实现。这些特点使得它对很多场景来说都是很好的选择，特别是对于受限的环境如机器与机器的通信（M2M）以及物联网环境（IoT）。

## 目录

**发现任何翻译问题或格式问题欢迎提PR帮忙完善。**

* [说明](https://mcxiaoke.gitbook.io/mqtt/readme)
* [前言](https://github.com/mcxiaoke/mqtt/tree/754321825c686b939f6c4cd9aaae12c4ac66f420/mqtt/00-Preface.md)
* [目录](https://github.com/mcxiaoke/mqtt/tree/754321825c686b939f6c4cd9aaae12c4ac66f420/mqtt/00-Contents.md)
* [第一章 - MQTT介绍](https://mcxiaoke.gitbook.io/mqtt/01-introduction)
* [第二章 – MQTT控制报文格式](https://mcxiaoke.gitbook.io/mqtt/02-controlpacketformat)
* [第三章 – MQTT控制报文](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets)
  * [3.1 CONNECT – 连接服务端](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0301-connect)
  * [3.2 CONNACK – 确认连接请求](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0302-connack)
  * [3.3 PUBLISH – 发布消息](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0303-publish)
  * [3.4 PUBACK –发布确认](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0304-puback)
  * [3.5 PUBREC – 发布收到（QoS 2，第一步）](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0305-pubrec)
  * [3.6 PUBREL – 发布释放（QoS 2，第二步）](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0306-pubrel)
  * [3.7 PUBCOMP – 发布完成（QoS 2，第三步）](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0307-pubcomp)
  * [3.8 SUBSCRIBE - 订阅主题](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0308-subscribe)
  * [3.9 SUBACK – 订阅确认](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0309-suback)
  * [3.10 UNSUBSCRIBE –取消订阅](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0310-unsubscribe)
  * [3.11 UNSUBACK – 取消订阅确认](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0311-unsuback)
  * [3.12 PINGREQ – 心跳请求](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0312-pingreq)
  * [3.13 PINGRESP – 心跳响应](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0313-pingresp)
  * [3.14 DISCONNECT –断开连接](https://mcxiaoke.gitbook.io/mqtt/03-controlpackets/0314-disconnect)
* [第四章 – 操作行为](https://mcxiaoke.gitbook.io/mqtt/04-operationalbehavior)
* [第五章 – 安全](https://mcxiaoke.gitbook.io/mqtt/05-security)
* [第六章 – 使用WebSocket](https://mcxiaoke.gitbook.io/mqtt/06-websocket)
* [第七章 – 一致性目标](https://mcxiaoke.gitbook.io/mqtt/07-conformance)
* [附录B - 强制性规范声明](https://mcxiaoke.gitbook.io/mqtt/08-appendixb)

## 旧版文档

> 已过期，建议使用GitBook版本 最新版本: v1.0.1 2015.10.22

| 文档       | 连接                                                                                 |
| -------- | ---------------------------------------------------------------------------------- |
| 中文版 HTML | [MQTT 3.1.1 中文版](http://mcxiaoke.github.io/mqtt/protocol/MQTT-3.1.1-CN.html)       |
| 中文版 PDF  | [MQTT 3.1.1 中文版](http://mcxiaoke.github.io/mqtt/protocol/MQTT-3.1.1-CN.pdf)        |
| 英文版 HTML | [MQTT Version 3.1.1](http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.html) |
| 英文版 PDF  | [MQTT Version 3.1.1](http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.pdf)  |

## 许可协议

* [署名-非商业性使用-相同方式共享 4.0 国际](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode)

## 联系方式

* Blog: <http://blog.mcxiaoke.com>
* Github: <https://github.com/mcxiaoke>
* Email: [github@mcxiaoke.com](mailto:github#mcxiaoke.com)

## 开源项目

* MQTT WebClient: <https://github.com/mcxiaoke/mqtt-monitor>
* Rx文档中文翻译: <https://github.com/mcxiaoke/RxDocs>
* MQTT协议中文版: <https://github.com/mcxiaoke/mqtt>
* Awesome-Kotlin: <https://github.com/mcxiaoke/awesome-kotlin>
* Kotlin-Koi: <https://github.com/mcxiaoke/kotlin-koi>
* Next公共组件库: <https://github.com/mcxiaoke/Android-Next>
* PackerNg极速打包: <https://github.com/mcxiaoke/packer-ng-plugin>
* Gradle渠道打包: <https://github.com/mcxiaoke/gradle-packer-plugin>
* EventBus实现xBus: <https://github.com/mcxiaoke/xBus>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mcxiaoke.gitbook.io/mqtt/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.