更新记录

1.0.0（2026-07-07） 下载此版本

1.0.0

【新增】

1. 支持 HarmonyOS NEXT BLE 蓝牙核心能力。
2. 支持蓝牙权限申请。
3. 支持 BLE 设备扫描和停止扫描。
4. 支持设备名称关键字过滤。
5. 支持 GATT 设备连接和断开连接。
6. 支持自动发现 Service 和 Characteristic。
7. 支持特征值 HEX 数据写入。
8. 支持特征值读取。
9. 支持 Notify 通知订阅。
10. 支持监听蓝牙设备返回数据。
11. 支持获取 RSSI。
12. 支持设置 MTU。
13. 支持 destroy 释放蓝牙资源。
14. 提供 Vue3 示例组件，方便快速接入。

【优化】

1. 兼容 HarmonyOS NEXT 部分版本 startBLEScan 参数校验严格的问题。
2. 兼容鸿蒙 BLE Notify 开启时参数校验严格的问题。
3. 连接后优先自动识别真实蓝牙服务和特征值，避免写死 UUID。
4. Web/H5 端提供空实现，避免多端编译报错。

【说明】 本插件适用于 uni-app Vue3 / uni-app x 的 HarmonyOS NEXT BLE 蓝牙接入场景，可用于智能硬件、IoT 外设、车载蓝牙设备、蓝牙控制类项目。

平台兼容性

uni-app(5.0)

插件介绍

Harmony NEXT BLE 蓝牙原生插件是一款面向 uni-app Vue3 / uni-app x 的鸿蒙 NEXT BLE 插件，基于 UTS 封装 HarmonyOS NEXT 原生蓝牙能力，提供低功耗蓝牙设备扫描、连接、服务发现、特征值读写、Notify 订阅、RSSI、MTU、断开连接与资源释放等核心功能。

本插件适合以下场景：

• 智能硬件设备控制
• 车载蓝牙外设
• 蓝牙踏板、灯控、传感器设备
• IoT 设备控制
• BLE 调试工具
• HarmonyOS NEXT 蓝牙适配项目

功能特性

• 支持 HarmonyOS NEXT BLE 扫描
• 支持设备名称关键字过滤
• 支持 GATT 连接
• 支持自动发现 Service / Characteristic
• 支持读取特征值
• 支持写入 HEX 数据
• 支持 Notify 通知订阅
• 支持监听特征值变化
• 支持获取 RSSI
• 支持设置 MTU
• 支持断开连接
• 支持 destroy 释放资源
• 支持 H5/Web 空实现，避免多端编译报错

平台兼容性

安装方式

将插件导入项目后，目录结构如下：

uni_modules/sl-harmony-ble