更新记录

1.0.0（2025-08-25）

基础MQTT功能，Android平台支持

平台兼容性

云端兼容性

uni-app(4.25)

uni-app x(4.25)

mqtt-native

UniApp UTS 跨平台 MQTT 客户端插件

使用方法

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

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

// 配置参数
mqtt.initParams({
  host: "ssl://broker.example.com:8883",
  clientId: "client_" + Date.now(),
  userName: "username", 
  password: "password",
  isSSL: true,
  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 24)
• iOS: 架构就绪，核心功能开发中
  • ✅ 连接/断开功能
  • ✅ 订阅/取消订阅功能
  • ✅ 消息发布功能
  • ✅ mqtts ssl认证，证书为不校验服务端身份
  • ❌ mqtts ssl认证，验证证书

连接状态码

技术规格

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

版本历史

• v1.0.0: 基础MQTT功能，Android平台支持

开发文档

UTS-语法 UTS-API插件 UTS-uni-app兼容模式组件 UTS-标准模式组件 Hello-UTS