更新记录

1.0.3（2025-08-01）

代码优化

1.0.2（2025-07-25）

代码优化

1.0.1（2025-07-24）

ios 功能跟进

平台兼容性

uni-app x

native-mqtt

UniApp UTS 跨平台 MQTT 客户端插件

使用方法

import { MQTT } from "@/uni_modules/native-mqtt"

// 创建实例
const mqtt = new MQTT()

// 配置参数
mqtt.initParams({
  host: "broker.example.com",
  port: 1883,
  clientId: "client_" + Date.now(),
  userName: "username", 
  password: "password",
  isAutomaticReconnect: true,
  isCleanSession: false,
  keepAliveInterval: 60,
  connectionTimeout: 30
})

// 连接服务器
mqtt.connect(
  (action, message) => {
    // 连接状态: 1=成功, 2=重连, 3=丢失, 4=失败
    console.log('状态:', action, message)
  },
  (topic, message) => {
    // 接收消息
    console.log('消息:', topic, message)
  }
)

// 订阅主题
mqtt.subscribe("test/topic", 1)  // QoS=1

// 发布消息
mqtt.publish("test/topic", "Hello MQTT!", 1)

// 取消订阅
mqtt.unsubscribe("test/topic")

// 检查连接
console.log(mqtt.isConnected())

// 断开连接
mqtt.disconnect()

主要功能

• MQTT 3.1.1 协议支持
• TCP/SSL 连接
• 自动重连机制
• QoS 0/1/2 支持
• 会话管理
• 资源自动清理

平台支持

• Android: 完整支持 (最低 SDK 21)
• iOS: 架构就绪，核心功能开发中
  • ✅ 连接/断开功能
  • ❌ 订阅/取消订阅功能（开发中）
  • ❌ 消息发布功能（开发中）

连接状态码

技术规格

• 开发框架: UTS (TypeScript for UniApp)
• 插件类型: 原生API插件
• 权限要求: 网络访问、唤醒锁定、网络状态监控

版本历史

• v1.2.0: 优化连接管理，增强错误处理，支持SSL/TLS
• v1.1.0: 重构连接逻辑，优化性能，增加超时控制
• v1.0.0: 基础MQTT功能，Android平台支持