更新记录

1.2.0（2026-08-11）

• init.will：可选遗嘱（topic / payload / qos / retain）；不传则不设 Will
• init.mapTcpPortToWs：微信/鸿蒙是否将 1883/8883 映射为 8083/8084；默认 true；不传与历史一致
• 不传参行为与 1.1.0 一致

1.1.0（2026-08-11）

• 声明支持 uni-app x：App-Android / App-iOS / 微信小程序
• 声明支持 App-nvue（与 App-vue 同 API；UTS API，非兼容模式组件）
• uni-app x 下鸿蒙标不支持（官方 UTS 插件鸿蒙暂不可）
• 不传参行为与 1.0.1 一致（含 keepAlive 默认 60）

1.0.0（2026-08-10）

Android Paho 与 iOS CocoaMQTT 支持 TCP/SSL 连接订阅发布； 微信小程序与鸿蒙支持 MQTT over WebSocket。 含 QoS 0/1、retain、账号密码、消息与断线回调、demo 与使用说明。

平台兼容性

uni-app(4.11)

uni-app x(4.11)

breao-emqxmqtt

标准 MQTT 3.1.1 客户端，兼容 EMQX 等 Broker。当前 1.2.0。init.keepAlive 默认 60；可选 will / mapTcpPortToWs（默认 true）。支持 App-vue / App-nvue 与 uni-app x。

使用（Vue3）

<script setup>
import {
  init,
  connect,
  subscribe,
  publish,
} from '@/uni_modules/breao-emqxmqtt'

// App：TCP 1883；微信/鸿蒙：WS（可用 wsPath；1883 会映射 8083）
init({
  host: 'broker.emqx.io',
  port: 1883,
  autoReconnect: true,
  debug: true,
  onMessage(msg) {
    console.log(msg.topic, msg.payload)
  },
  success() {
    connect({
      timeout: 15000,
      success() {
        subscribe({ topic: 'test/uni', qos: 0 })
        publish({ topic: 'test/uni', payload: 'hello', qos: 0 })
      },
    })
  },
})
</script>

微信小程序请将 Broker 的 wss 域名 配入小程序后台 socket 合法域名。

API

错误码（904）

9040004 未连接 · 9040005 参数非法 · 9040006 连接失败 · 9040008 订阅失败 · 9040009 发布失败

要求

• HBuilderX 4.11+，uni-app Vue3
• 仅支持云端传统打包（不支持离线打包、安心打包）；试用不可打正式包；授权绑定唯一 appid + 包名
• 微信小程序正式环境须 wss，并在后台配置 socket 合法域名
• 鸿蒙 API 12；微信基础库 2.10.0+