#插件需求# uniapp x支持蓝牙功能

欢迎到专业群（ uni-app x技术交流群 ） 咨询，群中有相关专业的管理员和群友。

目前 uni-app x 官方还没有内置像 uni-app 那样完整的蓝牙 API。

不过，你可以通过以下方式来解决蓝牙功能的需求：

1. 使用 UTS 插件（推荐）

插件市场已经有多个支持 uni-app x 的蓝牙插件，并且部分插件已经覆盖了 Android、iOS 和鸿蒙平台：

• xl-uts-bluetooth 蓝牙 ble：完全兼容 UniApp 和微信小程序的标准蓝牙 API，支持 iOS、Android、鸿蒙 NEXT 三端，并且提供了 Promise 风格调用，方便代码迁移。
  https://ext.dcloud.net.cn/plugin?id=18444
• 低功耗蓝牙(跨端UTS)支持iOS Android HarmonyOS：基于 UTS 的低功耗蓝牙插件，支持扫描、连接、读写、通知等核心功能，同样覆盖了 iOS、Android 和鸿蒙平台。
  https://ext.dcloud.net.cn/plugin?id=27827
• 安卓蓝牙操作UTS原生插件：集成了常用的蓝牙开关、设备配对、搜索、连接、发送数据等功能，支持 uni-app 和 uni-app x（仅限 Android 平台）。
  https://ext.dcloud.net.cn/plugin?id=27995

2. 自行编写 UTS 插件调用原生 API

uni-app x 支持直接调用 Android、iOS 和鸿蒙的原生 API。如果你熟悉原生开发，可以自行编写 UTS 插件，在插件中调用各平台的原生蓝牙接口（如 Android 的 BluetoothAdapter、iOS 的 CoreBluetooth、鸿蒙的 @ohos.bluetooth），然后在前端调用。

3. 关于微信小程序

如果你需要编译到微信小程序，可以直接使用微信小程序的蓝牙 API（wx.xxx），无需插件。

4. 注意事项

• 权限配置：使用蓝牙功能时，务必在 manifest.json 中配置相应的权限。例如，Android 需要声明 android.permission.BLUETOOTH、android.permission.BLUETOOTH_ADMIN 等权限；iOS 需要添加 NSBluetoothAlwaysUsageDescription 等隐私描述，否则可能导致蓝牙功能异常或获取蓝牙状态不准确。
• 获取系统蓝牙状态：你可以使用 uni.getSystemSetting() 来获取系统蓝牙开关状态，但请确保已正确配置权限，否则可能返回错误信息。

建议你先去插件市场试用一下，看看哪个插件能满足你的需求。如果插件无法满足，再考虑自行开发 UTS 插件。

专业原生插件定制、UTS插件定制、前端开发等，欢迎随时打扰（q:2579546054）

• CSDN博客： 查看作者博客
• 插件市场： 查看作者主页
• DCloud社区： 查看作者主页

UniApp 原生插件集合（2026）