web网页连接MQTT，显示数据与下发控制命令
零、前言
在完成一些设备作品后，常常会因为没有一个上位机用来实时检测数据和下发命令而苦恼，在上一篇文章中提到了怎么白嫖阿里云服务器，并且在上面搭建了属于自己的web网站。那么现在就可以利用这个公网web来实现一个上位机，这样就可以在有网的地方随时对设备进行监控和下发控制指令。以下就是完成这样一个可以连接MQTT服务器的web的制作过程。
一、body部分
html网页具有很多部分，其中最重要的是body部分，这部分决定了网站显示什么东西，stye部分就是对这部分进行美化。今天只完成功能，不对样式进行美化，有需要自行学习。
1.显示部分
用于显示数据，常用的有标签、文本框、标题等。显示部分我写了一个大标题，还有几个用于显示一些数据的文本，例如温度、湿度、光照强度等，这部分代码如下：
<h1>物联网Web界面示例</h1> <h2>示例参数</h2> <p>温度：<span id="temperature">25°C</span></p> <p>湿度：<span id="humidity">50%</span></p> <p>光照强度：<span id="light">800 lux</span></p>温度、湿度、光照强度这三部分需要有自己唯一的id，以便于后续可以通过id来索引到，进而对显示内容进行修改。
2.按钮部分
除了有显示以外，还需要有控制，控制最常用的就是按钮的形式。举例了三个按钮，分别是控制灯光、打开设备、关闭设备
<h2>示例按钮</h2> <button onclick="toggleLight()">控制灯光</button> <button onclick="sendCommand('turnOn')">打开设备</button> <button onclick="sendCommand('turnOff')">关闭设备</button>其中的onclick就是点击按钮后，会触发执行的函数。
二、script部分
在这部分中主要写的是处理逻辑相关的代码，包括MQTT连接、数据监听、发送消息等等。
1.连接MQTT
要在web中使用MQTT服务，需要引入MQTT相关的库，使用如下代码即可引入：
<script src="https://cdnjs.cloudflare.com/ajax/libs/mqtt/4.2.8/mqtt.min.js"></script>随后就可以使用MQTT的服务了，首先需要设置连接参数，例如使用的MQTT的服务器地址、端口、主题等等。例如使用开源免费的emqx服务器为例，设置一下发布主题和订阅主题：
// MQTT 连接配置const mqttBroker = 'ws://broker-cn.emqx.io:8083/mqtt';const publish_Topic = 'iot/my_pub';const subscribe_Topic = 'iot/my_sub';随后调用connect函数即可连接MQTT服务器了：
// 创建 MQTT 客户端实例const mqttClient = mqtt.connect(mqttBroker);这样就可以尝试连接到开源的emqx服务器上了，那到底有没有连接上呢，还需要写点代码来验证，我们就让web连接上后打印一下连接成功。代码如下：
// 连接事件处理mqttClient.on('connect', function () { console.log('连接成功'); // 订阅主题 mqttClient.subscribe(subscribe_Topic);});这样网页成功连接上MQTT服务器后，就会在浏览器控制台打印连接成功，如图所示：
2.监听信息
在使用过程中，web界面需要一直监听订阅主题上有没有新的消息，如果有消息，就要及时根据新的消息更新web显示的内容。代码如下：
// 监听消息mqttClient.on('message', function (topic, message) { console.log("收到信息：" + message) update_Status(message.toString());});//更新消息function update_Status(msg) { try { const data = JSON.parse(msg); // 尝试解析收到的 JSON 格式消息 const temperature = data.temperature; // 假设 JSON 数据中有 temperature 字段 const humidity = data.humidity; // 假设 JSON 数据中有 humidity 字段 const light = data.light; // 假设 JSON 数据中有 light 字段 document.getElementById('temperature').textContent = temperature + '°C'; //更新temperature document.getElementById('humidity').textContent = humidity + '%'; //更新humidity document.getElementById('light').textContent = light + ' lux'; //更新light } catch (error) { console.error('解析 MQTT 消息时出错：', error); }}在监听函数中，一旦收到消息了，会将信息打印出来，然后会执行update_Status函数来更新web上的内容。这边接收到的信息的json格式的，所以要对json格式的数据进行解析。举例如下，原始界面如下：
使用MQTT.fx软件连接上broker-cn.emqx.io后，往iot/my_sub主题发布一个json格式的信息，信息如下：
{"temperature":"23","humidity":"60","light":"500"}
发送后，就可以看到web界面的数值发送了变化，变成如下：
同时在控制台也输出了对应的信息，如图所示：
3.发送信息
web除了有监听信息，接收信息的能力外，还应当具备发送消息的能力，通过按键点击后，就会执行对应的函数，在函数内向发布主题发送一些消息，代码实现如下：
// 发布 MQTT 消息function sendCommand(command) { mqttClient.publish(publish_Topic, command); console.log('已发送 MQTT 消息：', command);}实际效果可以在MQTT.fx中订阅iot/my_pub主题，来查看web发出的信息，当打开设备按键被按下后，就会向iot/my_pub主题发送turnOn的文本信息，如图所示：
同时在web的控制台也能看到对应的日志。
三、整体代码
整体代码中也是只做了简单的实现，没有对界面进行美化，仅供参考。整体的代码实现如下：
<!DOCTYPE html><html lang="en"><head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>物联网Web界面</title></head><body> <h1>物联网Web界面示例</h1> <h2>示例参数</h2> <p>温度：<span id="temperature">25°C</span></p> <p>湿度：<span id="humidity">50%</span></p> <p>光照强度：<span id="light">800 lux</span></p> <h2>示例按钮</h2> <button onclick="toggleLight()">控制灯光</button> <button onclick="sendCommand('turnOn')">打开设备</button> <button onclick="sendCommand('turnOff')">关闭设备</button> <script src="https://cdnjs.cloudflare.com/ajax/libs/mqtt/4.2.8/mqtt.min.js"></script> <script> // MQTT 连接配置 const mqttBroker = 'ws://broker-cn.emqx.io:8083/mqtt'; const publish_Topic = 'iot/my_pub'; const subscribe_Topic = 'iot/my_sub'; // 创建 MQTT 客户端实例 const mqttClient = mqtt.connect(mqttBroker); // 连接事件处理 mqttClient.on('connect', function () { console.log('连接成功'); // 订阅主题 mqttClient.subscribe(subscribe_Topic); }); // 监听消息 mqttClient.on('message', function (topic, message) { console.log("收到信息：" + message) update_Status(message.toString()); }); //更新消息 function update_Status(msg) { try { const data = JSON.parse(msg); // 尝试解析收到的 JSON 格式消息 const temperature = data.temperature; // 假设 JSON 数据中有 temperature 字段 const humidity = data.humidity; // 假设 JSON 数据中有 humidity 字段 const light = data.light; // 假设 JSON 数据中有 light 字段 document.getElementById('temperature').textContent = temperature + '°C'; //更新temperature document.getElementById('humidity').textContent = humidity + '%'; //更新humidity document.getElementById('light').textContent = light + ' lux'; //更新light } catch (error) { console.error('解析 MQTT 消息时出错：', error); } } // 发布 MQTT 消息 function sendCommand(command) { mqttClient.publish(publish_Topic, command); console.log('已发送 MQTT 消息：', command); } // 模拟函数，用于切换灯光状态 function toggleLight() { const lightElement = document.getElementById('light'); if (lightElement.textContent === '800 lux') { lightElement.textContent = '0 lux'; } else { lightElement.textContent = '800 lux'; } } </script></body></html>至此，教程结束，祝编程愉快！73