鸿蒙开发速成之：MQTT通信开发全攻略-优快云博客

MQTT通信在鸿蒙开发中的实现步骤

准备工作

确保开发环境已安装鸿蒙SDK，并在config.json中添加网络权限：

{
  "module": {
    "reqPermissions": [
      {
        "name": "ohos.permission.INTERNET"
      }
    ]
  }
}

导入MQTT库

在工程的build.gradle中添加Paho MQTT依赖：

implementation 'org.eclipse.paho:org.eclipse.paho.client.mqttv3:1.2.5'

创建MQTT管理器类

public class MqttManager {
    private static final String SERVER_URI = "tcp://mqtt.eclipse.org:1883";
    private static final String CLIENT_ID = "harmony_mqtt_client";
    private MqttClient mqttClient;
}

初始化MQTT连接

public void init() throws MqttException {
    mqttClient = new MqttClient(SERVER_URI, CLIENT_ID, new MemoryPersistence());
    MqttConnectOptions options = new MqttConnectOptions();
    options.setCleanSession(true);
    options.setConnectionTimeout(10);
    mqttClient.connect(options);
}

订阅主题

public void subscribe(String topic, int qos) throws MqttException {
    mqttClient.subscribe(topic, qos);
    mqttClient.setCallback(new MqttCallback() {
        @Override
        public void messageArrived(String topic, MqttMessage message) {
            String payload = new String(message.getPayload());
            HiLog.info(LABEL, "Received message: %{public}s", payload);
        }
    });
}

发布消息

public void publish(String topic, String message, int qos) throws MqttException {
    MqttMessage mqttMessage = new MqttMessage();
    mqttMessage.setPayload(message.getBytes());
    mqttMessage.setQos(qos);
    mqttClient.publish(topic, mqttMessage);
}

断开连接

public void disconnect() throws MqttException {
    if (mqttClient != null && mqttClient.isConnected()) {
        mqttClient.disconnect();
    }
}

使用示例

try {
    MqttManager manager = new MqttManager();
    manager.init();
    manager.subscribe("test/topic", 1);
    manager.publish("test/topic", "Hello Harmony", 1);
} catch (MqttException e) {
    HiLog.error(LABEL, "MQTT error: %{public}s", e.getMessage());
}

关键点解析

连接参数：MqttConnectOptions可设置用户名、密码、超时等参数
QoS级别：0（最多一次）、1（至少一次）、2（恰好一次）
回调处理：通过MqttCallback实现消息到达、连接丢失等事件监听
线程安全：建议在UI线程外执行MQTT操作

注意事项

实际项目中应使用SSL加密连接（ssl://协议头）
客户端ID需保证唯一性，避免服务端冲突
持久化存储可改为文件存储提高可靠性

开发鸿蒙系统服务端和手机端APP的聊天机器人需要结合鸿蒙的分布式能力、服务端逻辑和客户端交互。以下是分模块的实现步骤及代码解析：

服务端开发（基于Node.js示例）

后端框架搭建

使用Node.js的Express框架搭建RESTful API服务，处理客户端的请求并返回聊天机器人的响应：

const express = require('express');
const bodyParser = require('body-parser');
const app = express();
app.use(bodyParser.json());

// 模拟简单的对话逻辑
const handleMessage = (userInput) => {
    const responses = {
        "你好": "你好，我是鸿蒙助手！",
        "时间": `当前时间是${new Date().toLocaleTimeString()}`
    };
    return responses[userInput] || "我不太明白你的意思。";
};

// 定义API接口
app.post('/chat', (req, res) => {
    const { message } = req.body;
    const reply = handleMessage(message);
    res.json({ reply });
});

app.listen(3000, () => console.log('服务端运行在3000端口'));

解析：通过/chat接口接收客户端发送的JSON消息，调用handleMessage生成回复。
关键点：实际项目中需集成NLP服务（如华为云NLU）替代硬编码的回复逻辑。

鸿蒙手机端开发（TypeScript）

配置Ability和UI

在entry/src/main/ets目录下创建聊天界面和网络请求模块。

UI页面（Index.ets）
使用鸿蒙的Column和TextInput组件构建聊天界面：

@Entry
@Component
struct ChatPage {
  @State messages: Array<{text: string, isUser: boolean}> = []
  @State inputText: string = ''

  build() {
    Column() {
      List({ space: 10 }) {
        ForEach(this.messages, (msg) => {
          ListItem() {
            Text(msg.text)
              .fontSize(20)
              .textAlign(msg.isUser ? TextAlign.End : TextAlign.Start)
          }
        })
      }
      Row() {
        TextInput({ text: this.inputText })
          .onChange((text: string) => { this.inputText = text })
        Button('发送')
          .onClick(() => this.sendMessage())
      }
    }
  }
}

网络请求模块（http.ets）
使用鸿蒙的@ohos.net.http模块发送请求：

import http from '@ohos.net.http';

function sendChatMessage(message: string): Promise<string> {
  let httpRequest = http.createHttp();
  return new Promise((resolve, reject) => {
    httpRequest.request(
      "http://your-server-ip:3000/chat",
      {
        method: "POST",
        header: { 'Content-Type': 'application/json' },
        extraData: JSON.stringify({ message })
      },
      (err, data) => {
        if (err) reject(err);
        else resolve(JSON.parse(data.result).reply);
      }
    );
  });
}

解析：sendChatMessage将用户输入发送到服务端，异步返回机器人回复。
关键点：需在config.json中声明网络权限：

"reqPermissions": [
  { "name": "ohos.permission.INTERNET" }
]

分布式设备协同（可选）

通过鸿蒙的分布式能力实现多设备同步聊天记录：

import distributedKVStore from '@ohos.data.distributedKVStore';

// 初始化KVStore
let kvManager: distributedKVStore.KVManager;
let kvStore: distributedKVStore.SingleKVStore;

async function initKVStore() {
  const context = getContext(this) as Context;
  kvManager = distributedKVStore.createKVManager({ context });
  kvStore = await kvManager.getKVStore({ storeId: 'chat_store' });
}

// 同步消息到其他设备
function syncMessage(message: string) {
  kvStore.put('latest_message', message)
    .then(() => console.log('同步成功'))
    .catch(err => console.error('同步失败:', err));
}

解析：利用分布式数据管理实现跨设备数据同步。
关键点：需确保设备登录同一华为账号并开启多端协同。

安全与优化

HTTPS加密：服务端应使用HTTPS协议，客户端配置域名白名单。
性能优化：客户端使用List组件实现消息懒加载，避免大量DOM渲染。
错误处理：网络请求需添加超时和重试机制：

httpRequest.on('timeout', () => { /* 处理超时 */ });

以上步骤涵盖了从服务端到客户端的完整流程，实际开发中需根据需求扩展功能（如语音识别、多语言支持）。