更新记录

1.0.0（2026-08-13）

• 首版：Android BLE + 经典蓝牙 SPP；iOS / 鸿蒙 / 微信小程序 BLE
• 可配置协议档：yaohua_stx（STX…CR）、ascii_ww、template（正则）
• RX 组帧：帧头/帧尾/定长/分隔符、缓冲区防爆
• 连接后连续输出命令（默认 RN1）与无数据重试
• 去皮 / 置零 / 切单位 / 原始命令发送（命令串可配）
• onWeight 节流与 onlyStable；getLastWeight；autoReconnectOnce
• BLE UUID 与 discoverDelayMs 可配；nameHints 扫描过滤
• 统一错误码 907xxxxx；App-nvue / uni-app x 声明

平台兼容性

uni-app(4.11)

uni-app x(4.11)

breao-bleweight 使用说明

蓝牙电子秤接入插件，适用于收银、计件、巡检等连续称重场景。

当前版本：1.0.0

• Android：BLE 与经典蓝牙 SPP
• iOS / 鸿蒙 / 微信小程序：BLE
• 能力：可配置协议档与组帧；连续称重回调；去皮 / 置零 / 切单位 / 原始命令
• 不做 USB/RS232 有线秤、不做通用 BLE 调试器、不做多秤并行连接池

建议调用顺序：init → startScan / connect → 接收 onWeight 或发控制命令 → disconnect / destroy。各异步方法均支持 success / fail / complete；fail 含 errCode / errMsg。插件为单例连接语义：再次 init 会销毁上一实例。

1. 环境要求

• HBuilderX 4.11 及以上
• uni-app Vue3（App-vue / App-nvue）或 uni-app x（App；微信能力与 uni-app 一致）
• 支持：App-Android、App-iOS、App-鸿蒙（仅 uni-app）、微信小程序
• 不支持：H5 及其它小程序；uni-app x 下鸿蒙不支持
• Android 最低 API：21；iOS 最低 12；鸿蒙最低 API：12；微信小程序基础库建议 2.22.0 及以上
• App 真机调试须制作自定义基座；正式发版须购买授权后走云端传统打包
• 授权绑定唯一 appid + 包名

2. 安装与引入

将插件目录放入工程的 uni_modules/breao-bleweight，或从插件市场导入后同步。

import {
  init,
  destroy,
  startScan,
  stopScan,
  connect,
  disconnect,
  getConnectionState,
  tare,
  zero,
  toggleUnit,
  sendRaw,
  getLastWeight,
} from '@/uni_modules/breao-bleweight'

3. API

3.1 init / destroy

init({
  transport: 'ble', // Android 老秤可设 'spp'，详见 §4
  protocolProfile: 'yaohua_stx',
  onWeight(res) {
    console.log(res.weight, res.unit, res.stable)
  },
  onDisconnected(res) {
    console.log('disconnected', res)
  },
  success() {},
  fail(err) {
    console.error(err.errCode, err.errMsg)
  },
})

destroy({ success() {}, fail(err) { console.error(err.errCode, err.errMsg) } })

3.2 扫描与连接

startScan({
  timeout: 10000,
  success(res) {
    // res.devices: [{ name, address, rssi?, bonded? }]
  },
  fail(err) { console.error(err.errCode, err.errMsg) },
})

connect({
  address: 'XX:XX:XX:XX:XX:XX',
  success() {},
  fail(err) { console.error(err.errCode, err.errMsg) },
})

disconnect({ success() {}, fail() {} })
stopScan({ success() {}, fail() {} })

iOS 侧请先扫描再连接；Android SPP 建议系统已配对。参数默认值见 §4。

3.3 控制命令

tare({ success() {}, fail() {} })
zero({ success() {}, fail() {} })
toggleUnit({ success() {}, fail() {} })
sendRaw({ data: 'RN1', success() {}, fail() {} })

命令内容取自 init 中的 tareCommand / zeroCommand / toggleUnitCommand；亦可用 sendRaw 发送任意 ASCII 串。

3.4 状态与最近称重

getConnectionState({
  success(res) {
    // res.state: disconnected | connecting | connected
  },
})

getLastWeight({
  success(res) {
    // res.sample 为最近一次解析结果；尚无数据时为 null
  },
})

3.5 onWeight 字段

4. 可配置项

不传参即用默认值。

4.1 协议档说明

5. 完整示例

import {
  init,
  startScan,
  connect,
  tare,
  getLastWeight,
  disconnect,
  destroy,
} from '@/uni_modules/breao-bleweight'

init({
  transport: 'ble',
  protocolProfile: 'yaohua_stx',
  continuousCommand: 'RN1',
  weightThrottleMs: 200,
  onWeight(res) {
    console.log('weight', res.weight, res.unit, 'stable=', res.stable)
  },
  onDisconnected() {
    console.log('scale disconnected')
  },
  success() {
    startScan({
      timeout: 8000,
      success(scanRes) {
        const dev = scanRes.devices && scanRes.devices[0]
        if (!dev) return
        connect({
          address: dev.address,
          success() {
            tare({
              success() {
                getLastWeight({
                  success(last) {
                    console.log('last', last.sample)
                    disconnect({ success() { destroy({}) } })
                  },
                })
              },
            })
          },
        })
      },
    })
  },
  fail(err) {
    console.error(err.errCode, err.errMsg)
  },
})

6. 权限

请在应用 manifest / 隐私弹窗中按需声明，并说明用于连接电子秤与接收称重数据。

7. 错误码（907）

8. 平台注意

• Android 默认 transport: 'ble'；老式经典蓝牙秤请设 transport: 'spp'，建议系统先配对
• Android 12+ 扫描通常需要定位权限；请在运行时申请并引导用户开启蓝牙
• iOS / 微信几乎只能 BLE；iOS 请先 startScan 再 connect，以便缓存外设
• 鸿蒙本期为 BLE GATT 通知读，不支持 spp
• 耀华类秤连上后若无数据，插件会按配置发送 continuousCommand（默认 RN1）并重试
• BLE UUID 留空时自动匹配可通知 / 可写特征；特殊机型请在 init 填写厂商 UUID
• template 档须提供能捕获重量的正则，并用 templateWeightGroup 指定组号
• 切换 transport 或彻底释放资源时，请 destroy 后再重新 init