微信小程序蓝牙权限如何开启？

Question

在开发微信小程序时，调用蓝牙功能需先获取用户授权。常见问题：即使在app.json中配置了"scope.bluetooth"权限，真机调试时仍提示“未开启蓝牙权限”或无法扫描到设备。原因通常是未在页面初始化时主动调用wx.getSetting或wx.authorize请求蓝牙授权，且iOS系统对蓝牙权限管理更严格，用户拒绝后再次授权需引导至小程序设置页手动开启。此外，部分安卓机型需同时开启GPS定位权限才能正常使用蓝牙扫描功能，开发者易忽略此隐性要求。

Answer 1

一、蓝牙权限授权机制的基本概念

在微信小程序中，调用蓝牙功能前必须获取用户的授权。尽管在app.json中配置了"scope.bluetooth"，但这仅声明了权限需求，并不会自动触发授权请求。

微信小程序的权限体系基于运行时动态申请，开发者需通过wx.authorize或wx.getSetting主动获取用户授权。若未调用相关API，则即使配置了权限字段，系统仍会提示“未开启蓝牙权限”。

以下为常见的权限配置示例：

{
  "permissions": {
    "scope.bluetooth": {
      "desc": "用于连接周边蓝牙设备"
    }
  }
}

该配置仅是说明用途，不等同于已获得授权。

二、平台差异性分析：iOS与Android的行为对比

iOS系统对蓝牙权限管理更为严格。首次拒绝后，无法通过代码再次弹出授权窗口，必须引导用户进入小程序设置页手动开启。

而部分Android机型（如华为、小米）在扫描低功耗蓝牙设备（BLE）时，隐式依赖GPS定位权限。这是由于安卓系统将蓝牙扫描归类为“位置信息采集”行为，因此必须同时启用定位服务。

平台	蓝牙授权方式	拒绝后是否可重试	是否依赖定位权限
iOS	需wx.authorize触发	否，需跳转设置页	否
Android	需wx.authorize + 定位权限	是（部分机型）	是（多数厂商定制ROM）

三、典型问题排查流程图

当出现“无法扫描到设备”或“未开启蓝牙权限”时，可通过以下流程进行诊断：

graph TD
      A[启动小程序] --> B{是否调用wx.openBluetoothAdapter?}
      B -- 否 --> C[调用失败]
      B -- 是 --> D{是否已授权scope.bluetooth?}
      D -- 否 --> E[调用wx.getSetting检查状态]
      E --> F{用户 previously denied?}
      F -- 是 --> G[跳转设置页: wx.openSetting]
      F -- 否 --> H[调用wx.authorize请求授权]
      H --> I[初始化蓝牙适配器]
      I --> J{Android设备?}
      J -- 是 --> K[检查GPS是否开启]
      K --> L[提示用户开启定位服务]
      J -- 否 --> M[开始扫描设备]

四、核心解决方案与最佳实践

1. 在页面onLoad生命周期中优先调用wx.getSetting检查当前蓝牙授权状态。
2. 若未授权，立即调用wx.authorize({scope: 'scope.bluetooth'})发起请求。
3. 监听authSetting回调结果，若用户拒绝，提供明确指引：“请前往设置开启蓝牙权限”。
4. 对于Android设备，增加定位权限检测逻辑：wx.getSetting({success: res => res.authSetting['scope.userLocation']})。
5. 使用wx.openSetting跳转至权限设置界面，提升用户体验。
6. 在UI层面对不同平台展示差异化提示文案，避免用户困惑。
7. 建议封装统一的蓝牙初始化模块，集中处理权限、异常和平台适配。
8. 测试阶段应覆盖主流iOS版本及国产安卓品牌（OPPO、vivo、小米等）。
9. 记录日志上报权限拒绝率，辅助产品决策是否优化引导流程。
10. 考虑结合后台设备指纹识别，减少重复授权打扰。

五、代码实现示例：健壮的蓝牙初始化函数

function initBluetooth() {
  return new Promise((resolve, reject) => {
    wx.getSetting({
      success: (res) => {
        if (res.authSetting['scope.bluetooth']) {
          startAdapter();
        } else {
          wx.authorize({
            scope: 'scope.bluetooth',
            success: () => startAdapter(),
            fail: () => {
              wx.showModal({
                title: '授权提示',
                content: '需要您手动开启蓝牙权限',
                confirmText: '去设置',
                success: (modalRes) => {
                  if (modalRes.confirm) {
                    wx.openSetting();
                  }
                }
              });
            }
          });
        }
      }
    });

    function startAdapter() {
      wx.openBluetoothAdapter({
        success: resolve,
        fail: (err) => {
          // 可能需提示开启系统蓝牙
          wx.showToast({ icon:'none', title:'请开启手机蓝牙' });
          reject(err);
        }
      });
    }
  });
}

此函数兼顾权限判断、用户交互与错误恢复，适用于生产环境。