当前位置：首页 > news >正文

web网页连接MQTT，显示数据与下发控制命令

news 2025/12/12 6:17:04

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'; //更新temperaturedocument.getElementById('humidity').textContent = humidity + '%';        //更新humiditydocument.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'; //更新temperaturedocument.getElementById('humidity').textContent = humidity + '%';        //更新humiditydocument.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