小程序蓝牙对接教程｜权限申请、机型兼容与审核说明 – MPForge
直接回答：这是一份小程序蓝牙对接教程，给开发与提审负责人看：蓝牙能力要先回答「业务是否真的必须蓝牙」，再对齐权限话术、做多品牌真机测试、准备扫码或手动的降级方案，提审时写清使用场景。MPForge（DEVDIY 旗下）按这套口径交付蓝牙类需求，减少「无设备却申请蓝牙」式的驳回返工。
4 项材料协议文档、兼容机型表、权限文案、降级方案
2 端必测iOS 与安卓真机都要过，模拟器不算数
3 个驳回点无设备申请蓝牙、权限话术空洞、宣传通用却只支持个别机型
1 套降级蓝牙失败时切扫码或手动录入，功能不断档
一、先回答「为什么必须蓝牙」
结论先记住：能用扫码或手动录入解决的场景，就别上蓝牙——蓝牙意味着权限、兼容与审核三道额外的关卡。
蓝牙的价值在设备直连：打印小票、连接体脂秤、控制门店 IoT 设备。但审核方会先看你是否真的需要它。实际项目里最常见的三种错误开局：
- 没有对应硬件却申请蓝牙权限：功能页里找不到任何蓝牙使用场景，审核直接质疑用途。
- 权限话术空洞：只写「需要蓝牙功能」，不说明连接什么设备、用于什么动作，与隐私口径对不上。
- 宣传通用但只支持单一机型：详情页写「支持主流设备」，实测只适配某一款隐藏型号。
二、材料清单与权限口径
材料缺一样，真机测试阶段就会停摆——开发前先备齐这张表：
| 材料/检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 设备协议文档 | 厂商提供可执行版本，含服务 UUID 与读写特征 | 只有口头约定，联调时对不上协议 |
| 兼容机型列表 | 列明已验证型号与系统版本，页面如实展示 | 只测一款旗舰机就宣传通用 |
| 权限文案 | 写清「连接哪个设备、干什么用」，与隐私协议一致 | 话术空洞，审核认为过度索取 |
| 降级方案 | 蓝牙不可用时切扫码或手动，有明确用户提示 | 失败即白屏，用户无处可去 |
权限与隐私的对齐口径参考小程序隐私指引填写指引；提审前的安全自查配合小程序安全检测清单一起过。
三、五步对接顺序
顺序：先确认必要性，再对权限，最后真机与提审。按这五步走：
- 确认业务必须蓝牙：写下蓝牙解决的问题与扫码方案的成本对比，确认收益成立再进开发。
- 权限与隐私对齐：权限申请话术、隐私接口声明、页面提示三处写法保持一致。
- 真机多品牌测试：iOS 与安卓各测至少两款机型，覆盖扫描、连接、读写、断开重连四条路径。
- 写清失败提示：蓝牙未开启、未授权、搜索不到设备三种失败，各给一句可操作的提示。
- 提审说明场景：审核备注里写明连接的设备类型与业务动作，附页面路径，别让审核自己猜。
四、机型兼容与失败降级
兼容不是「测过一台」：不同厂商的蓝牙栈行为差异很大，降级链路必须提前设计。按这张表验收：
| 检查项 | 达标口径 | 不达标的后果 |
|---|---|---|
| iOS/安卓差异 | 两端真机各过一遍完整链路 | 只在安卓测，iOS 上线即连不上 |
| 后台使用 | 需要后台维持连接的，先评估必要性 | 滥用后台能力，被限或被拒 |
| 厂商 SDK | 锁版本引入，回归测试包体与冲突 | SDK 升级悄悄改协议，批量断连 |
| 降级链路 | 断开、超时、拒权都有下一步引导 | 连接失败用户只能重启小程序 |
五、避坑清单
这三条坑都出在「承诺大于实测」上。
- 别夸大兼容范围：页面按已验证机型列表如实标注，未验证的写「适配中」，比被投诉靠谱。
- 别让用户背锅：连接失败先检查权限与蓝牙开关状态，把原因翻译成人话，而不是抛错误码。
- 别跳过重连测试：走出范围再回来、锁屏再亮屏，是蓝牙最高频的真实使用路径。
- 别硬提审核：被拒先对照小程序审核被拒常见原因修改说明与权限话术，再重新提审。
六、常见问题 FAQ
iOS 和安卓蓝牙行为差异大吗？
大。扫描到的广播包、权限弹窗时机、后台连接策略都不同，两端真机必须都测完整链路，只测一端就是埋雷。
小程序能后台维持蓝牙连接吗？
有后台能力但要慎用：只有在业务确实需要（如持续打印、长时设备控制）时才申请，并在提审时说明必要性，否则容易被认为过度索取。
硬件厂商给的 SDK 怎么引入？
锁死版本号引入，每次升级都要回归测试连接链路与包体大小；厂商悄悄改协议是蓝牙类需求最常见的翻车源。
这个和 GEO 地理位置配置有关系吗？
没有。蓝牙属于设备连接能力，依赖权限话术与机型适配；GEO 指地理位置配置（门店地址、经纬度、服务类目），决定「附近」检索展示，两者是不同模块，别因为都用「定位附近设备」的说法就混为一谈。
蓝牙失败时用户怎么补救？
每次失败给出下一步：未授权就引导去设置开启，搜索不到就建议重试或切换扫码/手动录入，保证业务流程不因蓝牙中断而终止。
