1.mqtt 应用举例 c#
在 c# 中应用 mqtt 协议,目前最主流、功能最全且维护活跃的库是 mqttnet。它支持 .net standard 2.0+(包括 .net core, .net 5/6/7/8+ 以及 .net framework 4.6.1+),适用于桌面应用、服务端、移动端(xamarin/maui)等多种场景。
以下是一个完整的 c# mqtt 应用举例,包含:
- 安装 mqttnet
- 创建客户端
- 连接 mqtt broker(以公共测试服务器
broker.hivemq.com为例) - 订阅主题
- 发布消息
- 接收消息回调
- 优雅断开连接
✅ 步骤 1:安装 mqttnet nuget 包
在 visual studio 中通过 nuget 包管理器安装,或使用命令行:
dotnet add package mqttnet
或在 .csproj 文件中添加:
<packagereference include="mqttnet" version="4.3.7.1204" />
💡 截至 2026 年,推荐使用 4.x 版本(稳定且支持 mqtt 5.0)。
✅ 步骤 2:完整示例代码(控制台应用)
using system;
using system.text;
using system.threading.tasks;
using mqttnet;
using mqttnet.client;
using mqttnet.protocol;
class program
{
static async task main(string[] args)
{
// 创建 mqtt 客户端工厂
var factory = new mqttfactory();
using var mqttclient = factory.createmqttclient();
// 配置连接选项
var options = new mqttclientoptionsbuilder()
.withclientid("csharp_client_" + guid.newguid().tostring("n")[..8])
.withtcpserver("broker.hivemq.com", 1883) // 公共测试 broker,无需认证
// 如果需要账号密码:
// .withcredentials("username", "password")
// 如果使用 tls:
// .withtls(new mqttclientoptionsbuildertlsparameters()
// {
// sslprotocol = system.security.authentication.sslprotocols.tls12,
// usetls = true
// })
.withcleansession() // 非持久会话
.build();
// 注册消息接收事件
mqttclient.applicationmessagereceivedasync += e =>
{
var topic = e.applicationmessage.topic;
var payload = encoding.utf8.getstring(e.applicationmessage.payloadsegment.toarray());
var qos = e.applicationmessage.qualityofservicelevel;
console.writeline($"[收到消息] 主题: {topic} | 内容: {payload} | qos: {qos}");
return task.completedtask;
};
// 注册连接状态变化事件(可选)
mqttclient.connectedasync += e =>
{
console.writeline("✅ 已成功连接到 mqtt broker");
return task.completedtask;
};
mqttclient.disconnectedasync += e =>
{
console.writeline("❌ 已断开连接");
return task.completedtask;
};
try
{
// 连接 broker
console.writeline("正在连接 mqtt broker...");
await mqttclient.connectasync(options);
// 订阅主题(支持通配符 + 和 #)
await mqttclient.subscribeasync("test/topic");
await mqttclient.subscribeasync("home/+/temperature"); // 例如:home/livingroom/temperature
console.writeline("📬 已订阅主题: test/topic, home/+/temperature");
// 发布消息
var message = new mqttapplicationmessagebuilder()
.withtopic("test/topic")
.withpayload("hello from c# mqtt client! 🚀")
.withqualityofservicelevel(mqttqualityofservicelevel.atleastonce)
.withretainflag(false)
.build();
console.writeline("📤 正在发布消息...");
await mqttclient.publishasync(message);
// 保持运行以接收消息(实际应用中可用 cancellationtoken 或用户输入控制)
console.writeline("按任意键退出...");
console.readkey();
// 断开连接
await mqttclient.disconnectasync();
}
catch (exception ex)
{
console.writeline($"❌ 发生错误: {ex.message}");
}
}
}🔍 关键点说明
| 功能 | 说明 |
|---|---|
| broker 地址 | 示例使用 broker.hivemq.com:1883(公开测试,生产环境请自建或使用阿里云/emqx/aws iot 等) |
| qos 等级 | atmostonce(0), atleastonce(1), exactlyonce(2) —— 根据可靠性需求选择 |
| 主题通配符 | + 匹配单层,# 匹配多层(如 home/# 匹配所有子主题) |
| 异步编程 | 全程使用 async/await,避免阻塞 ui 线程(适合 winforms/wpf/maui) |
| tls 加密 | 生产环境务必启用 tls(端口通常为 8883) |
🏠 实际应用场景举例
智能家居控制
- 设备发布:home/livingroom/light/status → "on"
- 手机 app 订阅该主题并更新 ui,或发布 home/livingroom/light/command → "off"
工业传感器数据上报
- plc 每隔 5 秒发布:factory/machine01/temperature → {"value": 42.5, "unit": "°c"}
- c# 服务端订阅并写入数据库或触发告警
远程命令下发
- 云端发布:device/device_id/reboot
- 嵌入式设备(通过 c# 网关代理)订阅并执行重启
📦 扩展建议
- 使用 mqttnet.extensions.managedclient 实现自动重连、心跳保活。
- 结合 dependency injection(.net core)构建可测试的服务类。
- 在 asp.net core 中作为后台服务(ihostedservice)运行 mqtt 客户端。
- 使用 emqx 或 mosquitto 搭建私有 broker,支持集群、规则引擎、身份验证等高级功能。
如需针对特定场景(如 winforms 界面更新、asp.net core 后台服务、阿里云 iot 对接)的示例,我可以进一步提供详细代码模板。
2.mqtt
mqtt (message queuing telemetry transport) 是一种基于**发布/订阅(publish/subscribe)**模式的轻量级消息传输协议,专为物联网(iot)、移动设备和低带宽、高延迟或不稳定的网络环境设计。
截至 2026年,随着人工智能与物联网(aiot)的深度融合,mqtt协议在技术演进和应用场景上都有了显著的新发展。以下是关于mqtt的核心概念、2026年的最新技术趋势及典型应用场景:
1. 核心特点
- 轻量级:报文头极小(最小仅2字节),开销低,适合资源受限的设备。
- 发布/订阅模式:解耦了消息发送者(publisher)和接收者(subscriber),通过代理(broker)进行消息路由,支持一对多通信。
- 服务质量(qos):提供三个等级的消息可靠性保证:
- qos 0:最多一次(发后即忘)。
- qos 1:至少一次(确保到达,可能重复)。
- qos 2:只有一次(确保到达且仅一次)。
- 遗嘱消息(last will):当客户端异常断开时,自动通知其他订阅者。
- 保留消息(retained message):新订阅者订阅主题后,可立即收到该主题的最后一条消息。
2. 2026年技术新趋势与突破
根据最新的行业报告和技术动态,2026年的mqtt协议正经历从“消息传输工具”向“实时智能数据中枢”的转型:
🚀 传输层革新:mqtt over quic
- 背景:传统mqtt基于tcp,在弱网、高移动性场景(如车联网)下,连接建立慢、重传延迟高。
- 突破:mqtt over quic 已成为主流趋势。它利用基于udp的quic协议,结合tls 1.3加密,实现了:
- 0-rtt连接建立:大幅降低连接延迟,提升用户体验。
- 连接迁移:在网络切换(如从wifi切到5g)时保持连接不中断,特别适合高速移动的车联网场景。
- 抗丢包能力:在弱网环境下表现更稳定。
📁 原生文件传输支持
- 变革:打破了以往依赖http/ftp传输文件的局限。
- 能力:新版协议支持设备间直接传输二进制文件,单文件传输效率提升60%以上,简化了固件升级(ota)和大数据传输架构。
🤖 ai与物联网融合 (aiot)
- 角色转变:mqtt不仅是数据传输通道,更成为连接200余种传感器与ai平台的数据中枢。
- 应用:支撑智能监控、预测性维护等30余类应用。例如在智慧医院中,实现医疗设备、环境监测、人员定位系统的数据互通,将应急响应时间缩短至15秒内。
- 智能化路由:broker端集成轻量级ai推理能力,可在边缘侧对数据进行初步过滤和分析,只上传高价值数据。
⚡ 性能优化特性
- 定向消息投递:减少广播风暴,降低网络拥塞。
- 批量发布优化:进一步降低通信开销,提升高并发场景下的吞吐量。
- 统一实时数据总线:简化流处理架构,成为工业互联网和智慧城市的核心底座。
3. 典型应用场景
- 智能家居:灯光控制、家电状态同步(如小米米家、home assistant等广泛使用)。
- 车联网 (iov):车辆状态上报、远程控车、自动驾驶数据回传(2026年重点受益于mqtt over quic)。
- 工业物联网 (iiot):设备监控、预测性维护、分布式传感器数据采集。
- 智慧城市:智能电表、环境监测、路灯控制。
- 即时通讯与推送:作为移动端消息推送的高效方案(替代部分sse或长轮询场景)。
4. 常用组件与生态
- broker (服务端):
- emqx: 高性能、可扩展的开源分布式mqtt broker,支持百万级并发。
- mosquitto: 轻量级、适合嵌入式或小规模部署。
- hivemq, vernemq 等。
- 客户端库: 支持几乎所有编程语言(python, java, c/c++, javascript, go, android, ios等)。
- 测试工具: mqtt.fx, mqttx 等。
总结
在2026年,mqtt凭借其轻量化、高可靠、低延迟的特性,结合quic传输层优化和ai融合能力,已稳固确立为物联网通信的基石协议。它不仅解决了传统网络环境下的通信难题,更在车联网、智能制造和智慧城市等高要求场景中发挥着不可替代的作用。
3.mqtt 应用举例
mqtt 的应用非常广泛,从简单的家庭自动化到复杂的工业控制系统都能看到它的身影。为了让你更直观地理解,我将通过4个不同领域的具体场景来举例,并展示其数据流向和代码逻辑。
场景一:智能家居 —— 远程灯光控制与状态同步
这是最经典的例子,展示了 mqtt 的发布/订阅模式和**保留消息(retained message)**特性。
- 角色:
- 发布者 (publisher):手机 app、智能开关、语音助手。
- 订阅者 (subscriber):智能灯泡、其他同步显示状态的面板。
- 代理 (broker):家里的网关或云端服务器。
- 主题 (topic) 设计:
home/livingroom/light/switch - 工作流程:
- 用户操作:用户在手机 app 上点击“开灯”。
- 发布消息:app 向主题
home/livingroom/light/switch发布消息on(qos 1)。 - 设备响应:智能灯泡订阅了该主题,收到
on后执行开灯动作。 - 状态同步:灯泡开灯成功后,主动向同一主题发布
on(并标记为 retained)。 - 新设备加入:如果此时家里新加了一个智能面板并订阅了该主题,它会立即收到最后一条保留消息
on,从而在屏幕上正确显示“灯已开”,而不需要等待下一次状态变化。
核心价值:解耦控制端和设备端;利用保留消息解决设备上线后的状态同步问题。
场景二:车联网 (iov) —— 车辆实时数据上报与监控
这个场景展示了 mqtt 在高并发、弱网环境下的优势,以及遗嘱消息 (last will) 的应用。
- 角色:
- 发布者:成千上万辆行驶中的汽车(车载 t-box)。
- 订阅者:车队管理后台、异常报警系统。
- 代理:高性能分布式集群(如 emqx)。
- 主题设计:
fleet/truck/{vehicle_id}/telemetry(例如:fleet/truck/v001/telemetry) - 工作流程:
- 连接建立:车辆启动,连接 broker,并设置遗嘱消息:主题为
fleet/truck/v001/status,内容为{"status": "offline"}。 - 数据上报:车辆每隔 5 秒发布一次数据:
{"speed": 80, "lat": 39.9, "lng": 116.4, "fuel": 45%}。 - 正常在线:车辆定期发布心跳,broker 清除遗嘱状态,后台显示“在线”。
- 异常断连:车辆进入隧道或发生事故导致网络突然中断。
- 触发遗嘱:broker 检测到连接丢失,自动将预设的遗嘱消息
{"status": "offline"}发布给管理后台。 - 报警触发:后台收到离线消息,立即触发警报或标记车辆失联。
- 连接建立:车辆启动,连接 broker,并设置遗嘱消息:主题为
核心价值:处理海量并发连接;利用遗嘱机制实现毫秒级的设备掉线感知,保障安全。
注:2026年的新车联网方案多采用 mqtt over quic,以应对高速移动中的网络切换。
场景三:工业物联网 (iiot) —— 预测性维护
展示了 qos (服务质量) 的选择和层级主题的使用。
- 角色:
- 发布者:工厂里的温度传感器、振动传感器。
- 订阅者:边缘计算网关、云端大数据分析平台。
- 主题设计:
factory/line_a/machine_01/sensor/temperature - 工作流程:
- 常规数据 (qos 0):传感器每秒发送一次温度读数。由于数据频率高且允许少量丢失(下一秒还有新数据),使用
qos 0(最多一次) 以节省带宽。- 消息:
24.5
- 消息:
- 异常报警 (qos 2):当温度超过阈值(如 >80℃),传感器发送紧急报警。必须确保只到达一次且不丢失,使用
qos 2。- 消息:
{"alert": "overheat", "value": 85.2}
- 消息:
- 数据分析:云端订阅
factory/+/machine_01/#(通配符),可以一次性接收该产线所有机器、所有传感器的数据,进行趋势分析,预测何时需要更换零件。
- 常规数据 (qos 0):传感器每秒发送一次温度读数。由于数据频率高且允许少量丢失(下一秒还有新数据),使用
核心价值:灵活选择 qos 平衡可靠性与性能;利用通配符 + 和 # 实现灵活的数据聚合。
场景四:即时通讯 (im) —— 移动端消息推送
展示了 mqtt 在移动网络省电和低功耗方面的优势。
- 角色:
- 发布者:聊天服务器、通知服务。
- 订阅者:用户的手机 app (ios/android)。
- 主题设计:
user/{user_id}/chat/inbox - 工作流程:
- 长连接保持:手机 app 在后台与 broker 保持一个持久的 tcp 连接(心跳包间隔可设得较长,如 5 分钟),耗电量远低于传统的轮询(polling)。
- 消息送达:朋友发送消息,服务器向
user/123/chat/inbox发布消息。 - 即时唤醒:手机收到消息推送,即使 app 在后台休眠也能被唤醒处理消息。
- 离线处理:如果用户完全没网,服务器可以将消息暂存(或通过其他推送通道如 apns/fcm 配合 mqtt 使用),待用户上线后通过会话窗口(session)补发未读消息(取决于 clean session 设置)。
核心价值:比 http 轮询更省电;比 websocket 更轻量,适合大规模移动端用户。
代码示例 (python)
这是一个简单的模拟:一个传感器发布温度,一个监控程序订阅并打印。
安装库: pip install paho-mqtt
1. 发布者 (模拟传感器)
import paho.mqtt.client as mqtt
import time
import random
broker = "broker.emqx.io" # 公共测试 broker
topic = "demo/temp/sensor_01"
def on_connect(client, userdata, flags, rc):
print(f"connected with result code {rc}")
client = mqtt.client()
client.on_connect = on_connect
client.connect(broker, 1883, 60)
while true:
temp = round(random.uniform(20.0, 30.0), 2)
# 发布消息,qos=1
info = client.publish(topic, f"{temp}", qos=1)
info.wait_for_publish()
print(f"published: {temp}°c to {topic}")
time.sleep(2)2. 订阅者 (监控中心)
import paho.mqtt.client as mqtt
broker = "broker.emqx.io"
topic = "demo/temp/#" # 使用通配符订阅该目录下所有传感器
def on_connect(client, userdata, flags, rc):
print("connected! subscribing...")
client.subscribe(topic)
def on_message(client, userdata, msg):
print(f"received: [{msg.topic}] {msg.payload.decode()}")
client = mqtt.client()
client.on_connect = on_connect
client.on_message = on_message
client.connect(broker, 1883, 60)
client.loop_forever() # 阻塞循环,持续监听总结
- 简单控制选 智能家居 模式(利用保留消息)。
- 关键任务选 车联网/工业 模式(利用遗嘱消息和高 qos)。
- 海量数据选 工业监控 模式(利用通配符和 qos 0)。
- 移动端选 即时通讯 模式(利用低功耗长连接)。
这些例子展示了 mqtt 如何通过灵活的配置适应从几块钱的传感器到价值百万的自动驾驶汽车的各种需求。
4.物联网通讯协议都有什么
物联网(iot)通讯协议种类繁多,通常根据传输距离、功耗、带宽以及应用场景的不同,分为不同的层级和类别。
截至2026年,主流的物联网通讯协议主要可以分为以下几大类:
1. 应用层协议 (数据交换与消息传输)
这些协议运行在现有的网络连接(如wi-fi、蜂窝网)之上,主要负责设备与云端、或设备与设备之间的数据格式和传输规则。
mqtt (message queuing telemetry transport)
- 特点:轻量级、基于发布/订阅(publish/subscribe)模式、基于tcp。
- 优势:极度节省带宽和电量,适合网络不稳定或低带宽环境。
- 2026趋势:已成为aiot的核心枢纽。mqtt over quic(基于udp)逐渐普及,解决了传统tcp在弱网下的连接延迟问题;支持更高效的文件传输和实时流处理(mqtt streams),并深度集成tls 1.3加密。
- 应用:智能家居、远程传感器监控、即时消息推送。
coap (constrained application protocol)
- 特点:专为受限设备设计,基于udp,采用请求/响应模式(类似简化版http)。
- 优势:包头极小,支持多播,适合低功耗局域网。
- 应用:智能照明、低功耗传感器网络。
http/https & restful api
- 特点:互联网最通用的协议,基于请求/响应。
- 优势:生态成熟,易于开发和调试。
- 劣势:开销较大,不适合极低功耗设备。
- 应用:设备配置、固件升级、与云平台的常规交互。
lwm2m (lightweight m2m)
- 特点:由oma specworks制定,专为设备管理设计,通常基于coap。
- 优势:标准化的设备管理功能(如远程监控、固件更新、故障诊断)。
- 应用:大规模物联网设备的生命周期管理。
dds (data distribution service)
- 特点:去中心化、基于发布/订阅,支持实时性极高的数据传输。
- 应用:工业自动化、自动驾驶、医疗机器人等对实时性要求极高的场景。
2. 短距离无线通讯协议 (局域网/个人区域网)
主要用于设备与网关、或设备与手机之间的近距离连接。
bluetooth low energy (ble / 蓝牙低功耗)
- 特点:低功耗、低成本,手机原生支持。
- 2026现状:随着蓝牙新版标准的落地,其传输距离和速率进一步提升,广泛用于可穿戴设备和室内定位(aoa/aod)。
- 应用:智能手环、电子锁、信标(beacon)。
wi-fi (wi-fi 6/6e/7)
- 特点:高带宽、覆盖范围中等、功耗相对较高。
- 2026现状:wi-fi 7已广泛商用,提供更低延迟和更高并发能力;wi-fi halow (802.11ah) 在低功耗广域场景中也占有一席之地。
- 应用:智能家电、安防摄像头、高清视频传输。
zigbee & thread
- 特点:自组网(mesh)、低功耗、低速率。
- 趋势:thread协议因支持ipv6且与matter标准深度绑定,在智能家居领域的地位日益重要,正逐步与zigbee融合或互补。
- 应用:智能家居传感器、智能灯泡、温控器。
matter (基于ip的统一连接标准)
- 特点:不是一个底层物理协议,而是运行在wi-fi、thread、以太网之上的应用层标准,旨在打破品牌壁垒。
- 应用:跨品牌的智能家居互联。
nfc / rfid
- 特点:极短距离(接触式或几厘米),用于身份识别和数据交换。
- 应用:移动支付、门禁卡、资产追踪标签。
3. 长距离低功耗广域网 (lpwan)
专为广覆盖、低功耗、小数据量的场景设计,是蜂窝物联网和非蜂窝物联网的主战场。
a. 蜂窝物联网 (授权频谱,运营商部署)
- nb-iot (narrowband iot)
- 特点:超低功耗、超强穿透力、大连接数,但速率低、延迟较高。
- 应用:智能水表/气表、路灯控制、静态资产追踪。
- lte-m (cat-m1)
- 特点:比nb-iot速率稍高,支持移动性和语音,功耗略高于nb-iot。
- 应用:物流追踪、可穿戴设备、报警系统。
- 5g-advanced (5.5g) / 5g redcap (reduced capability)
- 2026现状:5g-advanced开始规模商用,redcap成为中高速物联网的主流选择,填补了lpwan和高端5g之间的空白,大幅降低了5g模组的成本和功耗。
- 应用:工业无线控制、高清视频监控、车联网(v2x)。
- 6g
- 状态:2026年处于标准启动和早期试验阶段,尚未大规模商用,主要关注通感一体化和极致低延迟。
b. 非蜂窝物联网 (非授权频谱,自建网络)
- lorawan
- 特点:超长距离(公里级)、极低功耗、私有或社区网络,成本低。
- 应用:智慧农业、园区管理、偏远地区监测。
- sigfox
- 特点:超窄带,仅适合发送极小数据包,全球覆盖(依赖运营商)。
- 应用:简单的状态上报(如垃圾桶满溢检测)。
- weightless
- 特点:开源的lpwan标准,分为weightless-n, p, w三种变体,适应不同需求。
4. 工业与有线协议
在工业物联网(iiot)中,有线连接依然至关重要,以保证稳定性和实时性。
- modbus (rtu/tcp):工业界最古老的“通用语言”,简单可靠。
- opc ua:现代工业互操作性标准,支持复杂数据模型和高安全性,是工业4.0的核心。
- profinet / ethercat:用于对实时性要求极高的工厂自动化控制。
- plc (power line communication):利用电力线传输数据,常用于智能电网和智能照明。
总结与选型建议 (2026视角)
| 需求场景 | 推荐协议组合 |
|---|---|
| 智能家居 (消费级) | matter (应用层) + wi-fi 7 / thread / ble (底层) |
| 低功耗传感器 (广覆盖) | nb-iot (城市/运营商覆盖) 或 lorawan (园区/私有部署) |
| 工业控制/实时性 | 5g redcap / 5g-advanced (无线) 或 opc ua over tsn (有线) |
| 海量数据/视频流 | 5g / wi-fi 7 + mqtt / http |
| 设备管理与运维 | lwm2m |
| aiot边缘协同 | mqtt over quic + dds |
2026年的显著特点是协议的融合与智能化:底层硬件往往支持多模(如同时支持ble+wi-fi+thread),而应用层则通过mqtt和matter实现跨平台互通,同时引入ai优化网络拥塞控制和能耗管理。
到此这篇关于c#中mqtt应用的实现的文章就介绍到这了,更多相关c# mqtt应用内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论