更新记录

1.0.0（2026-03-19）

• 扫描附近 BLE 设备
• 连接设备
• 发现服务和特征
• 原始读写
• 通知订阅
• Android MTU 调整

平台兼容性

uni-app(4.75)

uni-app x(4.75)

点击“试用插件”即可直接体验 BLE 通信模板页

试用页面就是插件同级目录下的 index.vue。

页面里已经包含：

• 蓝牙状态和权限检查
• 扫描附近 BLE 设备
• 连接设备
• 服务与特征发现
• 原始读写
• 通知订阅
• Android MTU 调整

功能特性

• 支持 Android / iOS App 作为 BLE Central 扫描附近设备
• 支持连接 BLE GATT 设备并发现服务、特征
• 支持读取特征值、写入特征值、通知订阅
• 支持原始 HEX / UTF-8 文本调试
• 支持 Android 请求 MTU
• 附带完整模板页，方便没有真实协议时先验证通信链路

适用场景

• 智能灯、门锁、插座、传感器
• 体脂秤、血压计、温度计
• 医疗或工业小设备
• 任何需要 App 和 BLE 外设交换业务数据的场景

这版只做 BLE GATT 通信层，不做：

• 经典蓝牙
• 蓝牙耳机 / 键盘 / 鼠标
• 手机作为蓝牙外设
• 后台长连
• 具体设备协议

安装

将 uni_modules/austin-ble 复制到项目的 uni_modules 目录下。

权限说明

Android

• BLUETOOTH
• BLUETOOTH_ADMIN
• ACCESS_FINE_LOCATION
• BLUETOOTH_SCAN
• BLUETOOTH_CONNECT

iOS

• NSBluetoothAlwaysUsageDescription
• NSBluetoothPeripheralUsageDescription

原生权限或 manifest.json 修改后，需要重新编译并重新安装 App / 自定义基座。

API

方法

常用参数

startBleScan(options)

connectBleDevice(options)

discoverBleCharacteristics(options)

writeBleCharacteristicValue(options)

setBleCharacteristicNotify(options)

返回值字段

通用返回

getBleStatus() 返回字段

扫描结果字段

服务字段

特征字段

读写结果字段

MTU 结果字段

使用示例

<script>
import {
  requestBlePermissions,
  startBleScan,
  onBleScanResult,
  connectBleDevice,
  discoverBleServices,
  discoverBleCharacteristics,
  readBleCharacteristicValue,
} from '@/uni_modules/austin-ble'

export default {
  methods: {
    setupBle() {
      requestBlePermissions({
        success: () => {
          startBleScan()
        },
        fail: (res) => {
          uni.showToast({ title: res && res.errMsg ? res.errMsg : '蓝牙权限不可用', icon: 'none' })
        },
      })

      onBleScanResult((device) => {
        console.log('scan device', device)
      })
    },

    connectAndRead(deviceId, serviceId, characteristicId) {
      connectBleDevice({
        deviceId,
        success: () => {
          discoverBleServices({ deviceId })
          discoverBleCharacteristics({
            deviceId,
            serviceId,
            success: () => {
              readBleCharacteristicValue({
                deviceId,
                serviceId,
                characteristicId,
                success: (res) => {
                  console.log('read result', res)
                },
              })
            },
          })
        },
      })
    },
  },
}
</script>

试用方法

1. 点击“试用插件”
2. 先点“申请权限”
3. 点击“开始扫描”
4. 选中一个可连接设备并尝试连接
5. 读取服务与特征
6. 对支持 read / write / notify 的特征做原始调试

注意事项

• 附近很多普通 BLE 设备只能短连接，读完标准信息后可能会主动断开，这是正常设备行为。
• 插件解决“扫描、连接、收发数据”，具体写什么指令、是否鉴权、是否允许控制，取决于真实设备协议。
• requestBleMtu 主要用于后续长数据通信，普通读设备名、读标准信息时通常不需要。