基于MQTT协议设计的实时图传系统（阿里云物联网平台）

一、项目功能介绍

当前基于MQTT协议设计了一个实时图传系统，通过这个项目来演示，两个MQTT设备如何互相订阅，进行消息流转。 在阿里云服务器上创建2个设备，分为为设备A和设备B；设备A负责采集本地摄像头画面上传，设备B负责接收设备A上传的数据然后解析显示出来。在阿里云服务器上需要配置云产品流转，让设备A的数据上传后自动发送给设备B。这样就完成了视频画面数据的流转。不过因为阿里云的最大数据限制，每次最大发送10240字节的数据。

当前的项目是采用MQTT协议实现，那么先来了解一下什么是MQTT协议。

软件采用Qt设计，QT版本是5.12.6

设备A的功能：获取摄像头的数据---》缩放成240*320---》编码成JPEG格式---》转码成base64---》组合成MQTT报文---》上传到服务器。

设备B的功能：订阅设备A上传的数据，得到数据后解析出源格式数据---》将图像画面渲染显示出来。

软件运行效果：

总结软件运行的体验效果：

（1） 非常流畅。两个窗口肉眼感觉不到延迟。

（2）服务器不要钱。

这个方案验证之后，可以衍生出很多实际的例子了： 比如，单片机+摄像头+MQTT协议 也可以做为图传发送端。 联网可以使用：WIFI或者4G模块、5G模块。

1.1 MQTT协议

MQTT (Message QueuingTelemetry Transport)是一种轻量级的、基于发布/订阅的消息传输协议，它可以在客户端和服务器之间进行双向通信。MQTT被设计为适用于低带宽、不稳定网络连接的物联网设备通信。

MQTT具有以下主要特点：

（1）发布/订阅模型：客户端可以选择订阅一个或多个主题(topic)，并接收与这些主题相关的消息；同时，客户端也可以发布消息到一个或多个主题上。

（2）轻量级：MQTT的协议头非常小，最小只有2字节，这使得它非常适合于传输数据量较小的IoT设备。

（3）QoS（服务质量）支持：MQTT支持三种不同的QoS级别，分别是“至多一次”、“至少一次”和“恰好一次”，可以根据应用场景的需要进行选择。

（4）保留消息：MQTT服务器可以将最新的消息保留在主题中，并让新的订阅者能够读取先前发布的消息。

（5）遗嘱消息：当客户端与服务器连接异常断开时，服务器可以向其他订阅了该主题的客户端发送遗嘱消息，以实现更可靠的消息传输。

总之，MQTT是一种非常适合物联网设备通信的协议，它具有轻量级、灵活性高、易于实现、可靠性强等优点，已经被广泛地应用于各种物联网场景中。

1.2 MQTT协议载体

MQTT协议是基于TCP协议传输报文的。MQTT使用TCP/IP协议栈来实现通信，因此它具有TCP协议的一些特性，如可靠性、流控制和建立持久连接等特点。

在MQTT连接建立时，客户端需要通过TCP连接到MQTT服务器，并进行握手协商，包括协议版本、客户端标识符、遗嘱消息、QoS级别等信息，以确保双方能够正确地交换数据。一旦握手成功，客户端和服务器之间就建立了一个持久化的TCP连接，可以随时进行消息传输。

由于TCP协议本身已经提供了一定程度的可靠性保证，因此MQTT协议只需要在TCP的基础上实现发布/订阅机制、QoS级别控制、保留消息等特性即可，从而使得它成为一种轻量级且高效的物联网通信协议。

1.3 JSON里如何保存图片数据？

在JSON中保存图片数据通常需要将图片转换为二进制数据，并将其编码成Base64字符串，然后将该字符串作为JSON对象的属性值进行传输。

Base64编码是一种将二进制数据转换为ASCII字符的方法，它使用64个字符来表示任意序列的二进制数据。Base64编码后的数据长度会比原始二进制数据略长，但可以方便地被转换为文本格式并在网络上进行传输。

以下是一个示例JSON对象，其中包含了一个Base64编码后的图片数据：

{ "imageData": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBD...", "imageName": "my_image.png" }

在这个示例中，imageData属性表示图片数据的Base64编码字符串，imageName属性表示图片文件名。在接收到JSON对象后，可以通过解码Base64字符串并将其保存为二进制数据，再将其写入磁盘或者显示在应用程序中。

需要注意的是，由于Base64编码后的数据量相对较大，因此在实际应用中，如果需要传输大量的图片数据，建议使用其他更适合的数据传输方式，如MQTT协议、WebSocket等。

1.4 MQTT协议最大能传多少有效字节的数据？

MQTT协议本身没有限制数据包的大小，但是它需要遵循底层传输协议（TCP/IP）的限制和约束。在实际应用中，MQTT协议能够传输的有效数据量是受多种因素影响的，如网络带宽、QoS级别、MQTT消息头部信息等。

一般来说，在默认情况下，MQTT协议对于单个消息的有效载荷有一个限制，即不超过256MB。这个限制主要由MQTT协议的消息长度字段决定，该字段的最大值是4字节，因此最大能表示2^32-1个字节的消息长度，即约为4GB。然而，在实际应用中，由于网络带宽和设备性能等方面的限制，很难实现传输如此巨大的消息。

另外，需要注意的是，如果使用较高级别的QoS，如“至少一次”或“恰好一次”，则MQTT协议会对每条消息进行确认和重传，这可能会导致更多的网络流量和延迟。因此，在选择QoS级别时，需要根据应用场景和网络环境的实际情况进行优化和调整，以充分利用MQTT协议的特点和优势。

三、阿里云服务器创建

官网地址:https://iot.console.aliyun.com/lk/summary/new

3.1 创建产品

3.2 添加设备

{ "ProductKey": "a12qAqNZg3i", "DeviceName": "video_de1", "DeviceSecret": "206a4bc03642930542a9bcb8925b9a0f" }

创建完成。

3.3 创建自定义属性

在产品页面的，找到功能定义。

最大一次只能传递10KB。

3.4 MQTT服务器地址和端口

关于MQTT协议登录所需要的参数官方说明文档:https://help.aliyun.com/document_detail/140507.html?spm=a2c4g.11186623.6.571.1e417544OGPj2y

阿里云物联网服务器的域名规则如下：

物联网平台的域名格式为：productKey.iot-as-mqtt.cn-shanghai.aliyuncs.com，其中productKey是您在物联网平台上创建的产品的标识符，cn-shanghai表示物联网服务器所在的地区。 MQTT协议的域名格式为：productKey.iot-as-mqtt.cn-shanghai.aliyuncs.com，其中productKey是您在物联网平台上创建的产品的标识符，cn-shanghai表示物联网服务器所在的地区。 HTTPS协议的域名格式为：productKey.iot-as-http.cn-shanghai.aliyuncs.com，其中productKey是您在物联网平台上创建的产品的标识符，cn-shanghai表示物联网服务器所在的地区。 需要注意的是，以上的域名规则中，productKey需要替换成你在物联网平台上创建产品时生成的实际productKey。

下面是阿里云国内的服务器地域和可用区详情： 地域名称 所在城市 Region ID 可用区数量 华北 1 青岛 cn-qingdao 2 华北 2 北京 cn-beijing 10 华北 3 张家口 cn-zhangjiakou 3 华北 5 呼和浩特 cn-huhehaote 2 华北 6 乌兰察布 cn-wulanchabu 3 华东 1 杭州 cn-hangzhou 8 华东 2 上海 cn-shanghai 8 华南 1 深圳 cn-shenzhen 6 华南 2 河源 cn-heyuan 2 华南 3 广州 cn-guangzhou 2 西南 1 成都 cn-chengdu 2 端口号是：1883 我的设备参数： { "ProductKey": "a12qAqNZg3i", "DeviceName": "video_de1", "DeviceSecret": "206a4bc03642930542a9bcb8925b9a0f" } 经过上面的格式解释，我的阿里云服务器登录的域名就是(选择的是上海服务器)： a12qAqNZg3i.iot-as-mqtt.cn-shanghai.aliyuncs.com

解析域名对应的IP地址：

Microsoft Windows [版本 10.0.19044.2604] (c) Microsoft Corporation。保留所有权利。 C:Users11266>ping a12qAqNZg3i.iot-as-mqtt.cn-shanghai.aliyuncs.com 正在 Ping vpc-sh-prod.mqtt.iotgds.aliyuncs.com.gds.alibabadns.com [47.103.191.238] 具有 32 字节的数据: 来自 47.103.191.238 的回复: 字节=32 时间=40ms TTL=88 来自 47.103.191.238 的回复: 字节=32 时间=40ms TTL=88 来自 47.103.191.238 的回复: 字节=32 时间=40ms TTL=88 来自 47.103.191.238 的回复: 字节=32 时间=40ms TTL=88 47.103.191.238 的 Ping 统计信息: 数据包: 已发送 = 4，已接收 = 4，丢失 = 0 (0% 丢失)， 往返行程的估计时间(以毫秒为单位): 最短 = 40ms，最长 = 40ms，平均 = 40ms C:Users11266>

3.5 MQTT三元组格式

下载密码生成小工具：https://help.aliyun.com/document_detail/292635.htm?spm=a2c4g.11186623.0.0.5aaf635b3zgveM#section-jx3-u57-pmm

打开密码生成工具：

生成MQTT登录的密匙：填入的参数就是前面创建设备得到信息。

mqttClientId: video_de1|securemode=2,signmethod=hmacsha1,timestamp=1678078910527| username: video_de1&a12qAqNZg3i password: 02F7190BE8C33C1A8009EDBAF824BFDC6784FC67

3.6 主题发布与订阅的格式

在产品页面可以看到主题格式:https://iot.console.aliyun.com/product/productDetail/a1cMlEwEwjg/func?current=2

总结：

发布主题: /sys/a12qAqNZg3i/video_de1/thing/event/property/post 上报属性消息的格式: {"method":"thing.event.property.post","params":{"image":"1234567890"}} 订阅主题: /sys/a12qAqNZg3i/video_de1/thing/service/property/set

3.7 MQTT设备登录

利用MQTT客户端完成设备登录测试。

IP地址：47.103.191.238 端口号：1883 mqttClientId: video_de1|securemode=2,signmethod=hmacsha1,timestamp=1678078910527| username: video_de1&a12qAqNZg3i password: 02F7190BE8C33C1A8009EDBAF824BFDC6784FC67 发布主题: /sys/a12qAqNZg3i/video_de1/thing/event/property/post 上报属性消息的格式: {"method":"thing.event.property.post","params":{"image":"1234567890"}} 订阅主题: /sys/a12qAqNZg3i/video_de1/thing/service/property/set

对号入座填入参数，测试主题订阅，主题发布：

数据接收成功：

到此服务器创建成功。

3.8 继续创建设备2

监控设备有两个，1个设备为摄像头图片发送端，一个设备是图片接收显示端。

{ "ProductKey": "a12qAqNZg3i", "DeviceName": "video_dev2", "DeviceSecret": "30ebb8ffc4316fbe957fcfb13bdaec01" }

创建成功。

接下来生成设备2的MQTT三元组密匙，和前面一样的方法。

mqttClientId: video_dev2|securemode=2,signmethod=hmacsha1,timestamp=1678078910527| username: video_dev2&a12qAqNZg3i password: 15D2C020586E165E6A35BB2FA4DEB9DD59F3E73E

参数总结：

IP地址：47.103.191.238 端口号：1883 mqttClientId: video_dev2|securemode=2,signmethod=hmacsha1,timestamp=1678078910527| username: video_dev2&a12qAqNZg3i password: 15D2C020586E165E6A35BB2FA4DEB9DD59F3E73E 发布主题: /sys/a12qAqNZg3i/video_dev2/thing/event/property/post 上报属性消息的格式: {"method":"thing.event.property.post","params":{"image":"abcdefg"}} 订阅主题: /sys/a12qAqNZg3i/video_dev2/thing/service/property/set

四、云产品流转

4.1 创建解析器

创建完成。

4.2 创建规则

添加主题：

设置数据目的：

编写解析器脚本:

帮助文档地址：https://help.aliyun.com/document_detail/270937.html

下面编写代码，获取设备1上传的数据，转发给设备2。

//通过payload函数，获取设备上报的消息内容，并按照JSON格式转换。 var data = payload("json"); //直接流转物模型上报数据。 writeIotTopic(1000, "/a12qAqNZg3i/video_dev2/user/get", data)

写好解析器就发布。

在云产品流转的首页启动解析器。

4.3 测试两个设备的订阅

设备1的参数：

IP地址：47.103.191.238 端口号：1883 mqttClientId: video_de1|securemode=2,signmethod=hmacsha1,timestamp=1678078910527| username: video_de1&a12qAqNZg3i password: 02F7190BE8C33C1A8009EDBAF824BFDC6784FC67 设备1发布主题： 主题格式：/a12qAqNZg3i/video_de1/user/update 数据内容：{"method":"thing.event.property.post","params":{"image":"1234567890"}}

设备2的参数:

IP地址：47.103.191.238 端口号：1883 mqttClientId: video_dev2|securemode=2,signmethod=hmacsha1,timestamp=1678078910527| username: video_dev2&a12qAqNZg3i password: 15D2C020586E165E6A35BB2FA4DEB9DD59F3E73E 设备2订阅主题： 主题格式：/a12qAqNZg3i/video_dev2/user/get

五、项目开发

5.1 base64编码和解码实现

摄像头采集图像数据之后会编码 成base64格式的字符串，再通过MQTT协议上传到物联网服务器。 下面就是base64编码和解码的实现代码。

const char * base64char = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"; //进行base64编码 //bindata:进行编码的图片数据 //base64:转换后的base64编码 //binlength:图片大小 char * base64_encode( u8 * bindata, char * base64, u32 binlength ) { u32 i, j; u8 current; for ( i = 0, j = 0 ; i < binlength ; i += 3 ) { current = (bindata[i] >> 2) ; current &= (u8)0x3F; base64[j++] = base64char[(int)current]; current = ( (u8)(bindata[i] << 4 ) ) & ( (u8)0x30 ) ; if ( i + 1 >= binlength ) { base64[j++] = base64char[(int)current]; base64[j++] = '='; base64[j++] = '='; break; } current |= ( (u8)(bindata[i+1] >> 4) ) & ( (u8) 0x0F ); base64[j++] = base64char[(int)current]; current = ( (u8)(bindata[i+1] << 2) ) & ( (u8)0x3C ) ; if ( i + 2 >= binlength ) { base64[j++] = base64char[(int)current]; base64[j++] = '='; break; } current |= ( (u8)(bindata[i+2] >> 6) ) & ( (u8) 0x03 ); base64[j++] = base64char[(int)current]; current = ( (u8)bindata[i+2] ) & ( (u8)0x3F ) ; base64[j++] = base64char[(int)current]; } base64[j] = '�'; return base64; } //解码base64 //base64:base64编码 //bindata:图片数据 int base64_decode( const char * base64, u8 * bindata ) { u32 i, j; u8 k; u8 temp[4]; for ( i = 0, j = 0; base64[i] != '�' ; i += 4 ) {memset( temp, 0xFF, sizeof(temp) ); for ( k = 0 ; k < 64 ; k ++ ) { if ( base64char[k] == base64[i] ) temp[0]= k; } for ( k = 0 ; k < 64 ; k ++ ) { if ( base64char[k] == base64[i+1] ) temp[1]= k; } for ( k = 0 ; k < 64 ; k ++ ) { if ( base64char[k] == base64[i+2] ) temp[2]= k; } for ( k = 0 ; k < 64 ; k ++ ) { if ( base64char[k] == base64[i+3] ) temp[3]= k; } bindata[j++] = ((u8)(((u8)(temp[0] << 2))&0xFC)) | ((u8)((u8)(temp[1]>>4)&0x03)); if ( base64[i+2] == '=' ) break; bindata[j++] = ((u8)(((u8)(temp[1] << 4))&0xF0)) | ((u8)((u8)(temp[2]>>2)&0x0F)); if ( base64[i+3] == '=' ) break; bindata[j++] = ((u8)(((u8)(temp[2] << 6))&0xF0)) | ((u8)(temp[3]&0x3F)); } return j; }

5.3 软件设计

5.4 运行效果