HTML5转APP后无法直接调用蓝牙，需依赖Capacitor/Cordova等容器封装；Capacitor需社区插件及原生权限配置，Cordova需替换WebView引擎；微信小程序等平台蓝牙受限于厂商认证与白名单；跨平台稳定使用必须由原生模块实现核心逻辑。
HTML5 转 APP 后不能直接调用蓝牙设备，除非底层容器（如 Capacitor、Cordova 或原生 WebView）提供了蓝牙 API 封装。纯 Web 环境（包括 WebView）受浏览器安全策略限制，navigator.bluetooth 仅在 Chrome for Android/iOS（需 HTTPS + 安全上下文）部分支持，且转成 APP 后多数打包方案默认禁用或未桥接该能力。
Capacitor 项目中调用蓝牙（Android/iOS）
Capacitor 本身不内置蓝牙插件，需依赖社区插件（如 @capacitor-community/bluetooth-le），它通过原生模块桥接 Web 层：
- Android 需在
android/app/src/main/AndroidManifest.xml中添加权限：<uses-permission android:name="android.permission.BLUETOOTH" />和<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />（Android 12+ 还需BLUETOOTH_CONNECT和BLUETOOTH_SCAN） - iOS 需在
ios/App/App/info.plist中添加NSBluetoothAlwaysUsageDescription描述键 - 调用前必须先执行
await BluetoothLe.initialize()，否则scan()会静默失败 -
scan()返回的是原始广告包（advertisement字段为ArrayBuffer），解析服务 UUID 需手动处理字节（如检查0x02/0x03类型字段）
Cordova 项目启用 navigator.bluetooth
Cordova 默认 WebView 不支持 navigator.bluetooth，但可通过替换 WebView 引擎实现（仅限 Android）：
- 使用
cordova-plugin-ionic-webview并升级到 Chromium 内核（v5+），再配合cordova-plugin-androidx和cordova-plugin-androidx-adapter解决兼容问题 - 必须确保页面运行在 HTTPS 或
localhost（APP 内可配file://+Content-Security-Policy白名单，但 Chrome for Android 仍可能拒绝） - 调用
navigator.bluetooth.requestDevice({ acceptAllDevices: true })前，需确认设备已开启蓝牙且处于可被发现状态；iOS 上该 API 完全不可用 - 连接成功后，
GATT操作（如getPrimaryService()）容易因设备响应延迟抛出NetworkError，建议加try/catch并重试 1–2 次
微信小程序/快应用等“类 HTML5”平台的蓝牙限制
这类平台虽用类似 HTML/CSS/JS 开发，但运行环境非标准 WebView，其蓝牙能力由平台 SDK 严格管控：
立即学习“前端免费学习笔记（深入）”；
- 微信小程序仅支持连接符合「微信硬件平台」认证的蓝牙设备，且必须走
wx.openBluetoothAdapter→wx.startBluetoothDevicesDiscovery流程，无法直连通用 BLE 设备 - 快应用（如华为、小米）要求设备在厂商蓝牙白名单内，且需在
config.json中声明"bluetooth"权限，调用system.bluetoothAPI 前必须用户手动授权 - 所有平台均禁止后台持续扫描——APP 切后台后，
scan自动停止，恢复前台时需重新初始化
真正跨平台稳定用蓝牙，绕不开原生模块封装。Web 层只适合做 UI 和协议解析，连接、扫描、重连、MTU 协商等关键逻辑必须下沉到 Java/Kotlin 或 Swift/Objective-C。很多团队踩坑在于：前端写了完整 BLE 流程，结果打包后在某台 Android 13 手机上始终 requestDevice 返回空列表——其实是系统权限弹窗被拦截，而日志里没报任何错误。
