# 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>