Eclipse Paho MQTT 客户端库 M2Mqtt 教程

Eclipse Paho MQTT 客户端库 M2Mqtt 教程

paho.mqtt.m2mqtt项目地址:https://gitcode.com/gh_mirrors/pa/paho.mqtt.m2mqtt

1. 目录结构及介绍

在 https://github.com/eclipse/paho.mqtt.m2mqtt.git 仓库中，我们可以看到以下主要目录和文件：

• M2Mqtt: 包含客户端库的主要代码。
• images: 项目图标和其他图像资源。
• gitignore: 文件忽略规则。
• CODE_OF_CONDUCT.md: 项目的行为准则。
• CONTRIBUTING.md: 对贡献者的规定和指导。
• LICENSE: 开源许可证（Eclipse Public License）。
• M2Mqtt.nuspec: NuGet包定义文件，用于发布库到NuGet仓库。
• M2Mqtt.sln: Visual Studio解决方案文件，包含了项目集。
• M2MqttVS2008.sln: 针对Visual Studio 2008的解决方案文件。
• NOTICE: 许可声明。
• README.md: 项目简介和快速入门指南。
• SECURITY.md: 项目安全相关的指导。
• about.html: 关于项目的信息页面。
• build.cmd: 构建脚本。
• delme.txt: 示例文件或临时文件。
• edl-v10, epl-v10, notice.html: 版权和许可相关文件。

这个项目的目录结构主要是为了管理和构建C#的MQTT客户端库，包括源码、解决方案文件、资源以及文档等。

2. 启动文件介绍

由于这是一个库项目，没有具体的“启动文件”。不过，开发人员通常会通过导入M2Mqtt库到自己的应用程序中来使用它。例如，在Visual Studio中，可以创建一个新的C#项目，然后将M2Mqtt库添加为引用，使用类库中的M2Mqtt.UWP.Client或M2Mqtt.WinForms.Client等类来初始化和操作MQTT客户端。

这里有一个简化的例子展示如何初始化MQTT客户端：

using M2Mqtt;
...

// 初始化客户端
var mqttClient = new MqttClient("your-broker-url");
mqttClient.Connect("client-id", null, true);

// 订阅主题
mqttClient.Subscribe(new string[] { "topic-to-subscribe" }, new byte[][] { MqttMsgBase.QOS_LEVEL_AT_LEAST_ONCE });

// 处理消息回调
mqttClient.MqttMsgPublishReceived += OnMessageReceived;

// 发布消息
mqttClient.Publish("topic-to-publish", Encoding.UTF8.GetBytes("hello world"), MqttMsgBase.QOS_LEVEL_AT_MOST_ONCE, false);

请注意，这只是一个基本示例，实际使用时需要根据具体需求进行调整和错误处理。

3. 项目的配置文件介绍

M2Mqtt库本身并不直接使用配置文件。然而，当在你的应用中集成M2Mqtt时，你可以自行创建配置文件以存储MQTT连接参数，如服务器URL、客户端ID、用户名、密码等。以下是一个简单的XML配置文件示例：

<configuration>
  <appSettings>
    <add key="BrokerUrl" value="tcp://localhost:1883" />
    <add key="ClientId" value="my-client" />
    <add key="UserName" value="username" />
    <add key="Password" value="password" />
    <add key="UseSSL" value="false" />
  </appSettings>
</configuration>

然后在你的代码中读取这些配置值以设置MQTT客户端：

var brokerUrl = ConfigurationManager.AppSettings["BrokerUrl"];
var clientId = ConfigurationManager.AppSettings["ClientId"];
var userName = ConfigurationManager.AppSettings["UserName"];
var password = ConfigurationManager.AppSettings["Password"];
var useSsl = Convert.ToBoolean(ConfigurationManager.AppSettings["UseSSL"]);

var mqttClient = new MqttClient(brokerUrl, useSsl, true, new MqttDefaultCertificateFactory(), userName, password);
mqttClient.Connect(clientId);
...

这样，你的应用程序可以通过修改配置文件轻松地更改MQTT连接的设置，而无需重新编译代码。

paho.mqtt.m2mqtt项目地址:https://gitcode.com/gh_mirrors/pa/paho.mqtt.m2mqtt