uniApp开发微信小程序-连接蓝牙连接打印机上岸！

历经波折三次成功上岸！

三次经历简单絮叨一下：使用uniApp+vue开发的微信小程序，使用蓝牙连接打印机，蓝牙所有的接口都是插件中封装的，用的插件市场中的这个： dothan-lpapi-ble ；所以，开发中，主要是看插件文档中使用的API。

首次上线

情况说明：首次上线微信小程序：直接初始化实例，调用的插件API，测试环境成功连接打印，就上线了。

结果：

客户手机一直搜索不到打印机，根据经验发现没执行实例的代码；
想到授权蓝牙也没自动弹框提示，小程序设置中也没有蓝牙开启设置；

问题定位：

那就问 deepseeek 开干呗！
1. 可能是用户手机 鸿蒙系统 问题：在系统设置中找到应用管理，找到微信，然后打开微信的权限管理，查看 附近设备的权限 - 开启（反复开关）。

插件市场遇到的特殊情况
2. 显示授权：必要的权限声明
3. 检查manifest.json配置
4. 微信小程序发版后台 - 设置 - 基本设置 - 服务内容声明 - 用户隐私保护指引 - 添加（蓝牙、微信信息收集）

二次上线

情况说明：二次上线微信小程序：提交审核是其他同事在做，正常提交

结果：

客户手机一直搜索不到打印机，根据经验发现没执行实例的代码；
线上环境用户还是没有触发授权蓝牙、位置信息提示；
审核没通过

问题定位：

1. 提交审核时勾选了：未采集用户隐私
2. 亲自提审、加图片、视频辅佐

三次上线

情况说明：审核通过

结果：

线上成功授权、成功搜索打印机！

成功版本代码

manifest.json配置

"mp-weixin": {"appid": "...",//  添加..."permission": {"scope.bluetooth": {"desc": "用于连接蓝牙设备"},"scope.userLocation": {"desc": "你的位置信息将用于蓝牙设备连接"}},"requiredPrivateInfos": ["getLocation"]},

授权提示 - deepseek友情提供

// 使用-获取蓝牙权限
await this.bringBluetoothRight();// 方法 methods: 
bringBluetoothRight() {let _this = this;return new Promise((resolve, reject) => {uni.getSetting({success: async (res) => {try {console.log(res, 'res')// 1. 同时检查蓝牙和位置权限const needBluetooth = !res.authSetting['scope.bluetooth'];const needLocation = !res.authSetting['scope.userLocation'];if (!needBluetooth && !needLocation) {// 已有全部权限return resolve(await _this.wechatBluetoothAuthUtils());}// 2. 显示预授权提示（合并说明）await _this.showPreAuthorizeModal('需要蓝牙和位置权限','连接打印机需要以下权限：\n\n1. 蓝牙权限 - 用于设备配对\n2. 位置权限 - 用于搜索设备');// 3. 按顺序请求权限if (needBluetooth) {await _this.requestPermission('scope.bluetooth', '蓝牙');}if (needLocation) {await _this.requestPermission('scope.userLocation', '位置');}// 4. 验证权限获取结果const currentSettings = await _this.getSettingWithRetry();console.log(currentSettings, 'currentSettings')if ((!needBluetooth || currentSettings['scope.bluetooth']) &&(!needLocation || currentSettings['scope.userLocation'])) {console.log('.......')resolve(await _this.wechatBluetoothAuthUtils());} else {console.log('1111111')// 5. 有权限未被授予，引导去设置页await _this.showGoSettingModal();const finalSettings = await _this.getSettingWithRetry();if ((!needBluetooth || finalSettings['scope.bluetooth']) &&(!needLocation || finalSettings['scope.userLocation'])) {resolve(await _this.wechatBluetoothAuthUtils());} else {reject(new Error('权限未完全授予'));}}} catch (error) {reject(error);}},fail: reject});});
},
// 新增：带重试的获取设置
getSettingWithRetry(retry = 2) {return new Promise((resolve, reject) => {const tryGet = (attempt) => {uni.getSetting({success: resolve,fail: attempt > 0 ?() => setTimeout(() => tryGet(attempt - 1), 500) : reject});};tryGet(retry);});
},// 改进：通用权限请求方法
requestPermission(scope, permissionName) {let _this = this;// 添加最大重试次数控制const MAX_RETRY = 1; // 最多重试1次（即总共2次机会）return new Promise((resolve, reject) => {const tryAuthorize = (retryCount = 0) => {uni.authorize({scope,success: resolve,fail: async () => {// 第一次拒绝时显示提示，后续直接引导去设置页if (retryCount < MAX_RETRY) {const confirmed = await _this.showPreAuthorizeModal(`${permissionName}权限被拒绝`,`需要${permissionName}权限才能连接打印机，是否重新授权？`,'重新授权','取消');if (confirmed) {tryAuthorize(retryCount + 1); // 增加重试计数return;}}// 达到最大重试或用户取消，引导去设置页const goSetting = await _this.showPreAuthorizeModal('权限不足',`需要${permissionName}权限才能使用打印机功能，是否去设置页开启？`,'去设置','暂不开启');if (goSetting) {uni.openSetting({success: (res) => {res.authSetting[scope] ? resolve() :reject(new Error(`用户未授权${permissionName}权限`));},fail: () => reject(new Error('打开设置页失败'))});} else {reject(new Error(`用户取消${permissionName}权限授权`));}}});};tryAuthorize(); // 开始首次授权尝试});
},
// 改进：预授权弹窗（返回Promise<boolean>）
showPreAuthorizeModal(title, content) {return new Promise((resolve) => {uni.showModal({title,content,confirmText: '继续',cancelText: '取消',success: (res) => {resolve(!!res.confirm);},fail: () => resolve(false)});});
},// 改进：去设置页弹窗
showGoSettingModal() {return this.showPreAuthorizeModal('需要权限','需要前往设置页手动开启权限，是否现在去设置？').then((confirm) => {if (confirm) {return new Promise((resolve) => {uni.openSetting({success: resolve,fail: resolve});});}return Promise.reject(new Error('用户取消设置'));});
},wechatBluetoothAuthUtils() {let _this = this;const {bluetoothEnabled,platform} = uni.getSystemInfoSync();console.log(bluetoothEnabled,platform)// 设备为IOS时，微信蓝牙是否开启if (platform === 'ios') {return new Promise((resolve, reject) => {// 初始化蓝牙模块(用openBluetoothAdapter 方法解决部分ios设备，授权蓝牙失败的问题)uni.openBluetoothAdapter({success: () => {// 开启蓝牙功能 =》 初始化拾果sdkresolve(true);},fail: (openBlueFail) => {if (openBlueFail.state === 3) {// 说明微信应用蓝牙未授权uni.showModal({content: '检测到您未允许微信访问手机蓝牙权限，是否打开系统设置？',showCancel: false,confirmText: '前往设置',success: () => {// 跳转微信应用权限uni.openAppAuthorizeSetting();},});} else if (openBlueFail.state === 4) {// 说明系统蓝牙未开启uni.showModal({content: '蓝牙设置 - 小程序需要通过蓝牙搜索和连接设备，请确认手机蓝牙功能是否已开启？',showCancel: false,confirmText: '我已开启',success: async () => {const {bluetoothEnabled,platform} = uni.getSystemInfoSync();if (bluetoothEnabled) {// 开启蓝牙功能resolve(true);} else {uni.showToast({icon: 'none',title: '手机蓝牙未开启'})}},});}},});});} else {return new Promise(function(resolve, reject) {// andriodif (!bluetoothEnabled) {// 说明系统蓝牙未开启uni.showModal({content: '蓝牙设置 - 小程序需要通过蓝牙搜索和连接设备，请确认手机蓝牙功能是否已开启？',showCancel: false,confirmText: '我已开启',success: async () => {const {bluetoothEnabled,platform} = uni.getSystemInfoSync();if (bluetoothEnabled) {// 开启蓝牙功能resolve(true);} else {toast({title: '手机蓝牙未开启'});}},});} else {// 开启蓝牙功能resolve(true);}});}
},

额外关闭提示：

<button class="search-btn" type="default" @click="toggleLocationTracking">{{ isTrackingLocation ? '关闭位置追踪' : '开启位置追踪' }}</button>// data
isTrackingLocation:false// methods
toggleLocationTracking() {if (this.isTrackingLocation) {this.stopLocationTracking();} else {this.startLocationTracking();}},
startLocationTracking() {uni.authorize({scope: 'scope.userLocation',success: () => {this.isTrackingLocation = true;uni.showToast({title: '已开启位置服务',icon: 'success'});},fail: () => {uni.showModal({title: '提示',content: '需要位置权限才能搜索蓝牙设备',confirmText: '去设置',success: (res) => {if (res.confirm) uni.openSetting();}});}});},
stopLocationTracking() {uni.getSetting({success: (res) => {if (res.authSetting['scope.userLocation']) {uni.showModal({title: '确认',content: '确定要关闭位置服务吗？关闭后将无法搜索新设备',success: (res) => {if (res.confirm) {// 实际微信小程序无法直接关闭权限，引导用户去设置页uni.openSetting({success: () => {this.isTrackingLocation = false;}});}}});}}});},