微信小程序：蓝牙BLE连接10003问题分析及解决
10003是微信蓝牙连接经常碰到的问题，微信官方给出的文档中就简单的描述为“connection fail”，备注为“连接失败”。然而，实际上出现10003的状况有很多，比如根据deviceId连接蓝牙时，蓝牙设备未开启或异常导致无法连接;蓝牙设备被占用或者上次蓝牙连接未断开导致无法连接；出现该错误后，去微信官方社区寻求帮助，在社区发现了整整4页（奖金40条）都是反馈该问题，然而都没有得到官方答复，有极个别解决了的也不适用于我的情况；于是，只有自己分析。
问题描述:
1.启动app，搜索并连接蓝牙成功后，第一次采集数据正常；
2.下次采集如果手机蓝牙是打开的，也能正常采集；
3.但如果手机蓝牙关闭，点击采集数据试图连接，提示用户打开手机蓝牙；当打开手机蓝牙后再去连接蓝牙，此时会连接不上，报错10003；
4.后续会一致连不上蓝牙，不管是重启小程序还是重新关闭打开蓝牙，都不能正常连接蓝牙设备。
问题定位
1.复现问题，根据测试提供的方法，先测试iphone正常，三星S7edge，结果是能正常连接蓝牙，后来又测试vivo x7plus和小米MI5，终于成功复现该问题；
2.针对10003错误在微信开发社区找解决方案，可是面对着几十条相似问题，几乎都没有得到解决，有几条说在连接前先调用wx.closeBLEConnection断开上次连接，尝试后，不能解决我的问题；
3.既然没有找到现成的解决方案，就只有跟踪代码了，在关键方法中加日志；发现，在顶部栏关闭手机蓝牙时，小程序中无法断开蓝牙连接，报错（10001（not available）当前蓝牙适配器不可用）；
4.后来又在偶然情况下，清除了蓝牙设备的绑定关系，重新进入蓝牙搜索页面，发现这样操作后竟然能成功连接上蓝牙。
问题修复
上述问题定位中，（3）可以发现应该是没有断开上次蓝牙连接导致的，（4）又发现，重新搜索蓝牙以后再连接可以解决该问题；
于是按照这两个方向去找解决方案：
1.既然是因为没有断开蓝牙连接导致的，那就在关闭手机蓝牙时去断开蓝牙；然而，在蓝牙状态监听中调用断开连接函数，返回错误（10001（not available）当前蓝牙适配器不可用）；
2.于是只能考虑重新搜索蓝牙后再连接的方法，在出现10003错误后，重新搜索蓝牙，并且在找到对应的设备后进行蓝牙连接；修改代码反复测试，根据日志显示，确实是出现了10003，然后进入搜索模块，搜到指定设备后进行蓝牙连接，之后连接成功，这个方案解决了该问题。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
wx.createBLEConnection({ <span class="hljs-attr">deviceId</span>: deviceId, <span class="hljs-attr">success</span>: <span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">res</span>) </span>{ <span class="hljs-comment">//连接成功</span> initnotifyCharacteristic(notifyCharacteristic);<span class="hljs-comment">// 指定特征值，并进行数据交互</span> <span class="hljs-comment">// 已连接</span> _bthConnectStaus = BTH_STATUS_CONNECTED; }, <span class="hljs-attr">fail</span>: <span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">res</span>) </span>{<span class="hljs-comment">// 连接蓝牙失败</span> _bthConnectStaus = BTH_STATUS_DISCONNECT; <span class="hljs-comment">// 回调上层蓝牙连接失败</span> callback(res.errCode, <span class="hljs-string">"connect failed"</span>) } |
然后根据fail中的res.errCode判断是否10003。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
<span class="hljs-keyword">if</span>(code == <span class="hljs-number">10003</span>) { <span class="hljs-comment">// 部分android手机特殊情况下需要重新搜索才能连接蓝牙，此时报错10003，进行蓝牙搜索（ps:原因可能是系统中将手机蓝牙关闭导致连接状态不能改为断开，导致下次无法连接同一个设备）</span> <span class="hljs-keyword">var</span> timeId = setTimeout(<span class="hljs-function"><span class="hljs-keyword">function</span> () </span>{ stopSearchBluetooth(); callback(<span class="hljs-literal">false</span>, <span class="hljs-string">"timout"</span>) }, <span class="hljs-number">5000</span>); <span class="hljs-comment">// 最多搜索5s</span> searchBluetooth(<span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">res</span>) </span>{ <span class="hljs-keyword">if</span> (res.devices === <span class="hljs-literal">undefined</span> || res.devices === <span class="hljs-literal">null</span>) { <span class="hljs-keyword">return</span>; } <span class="hljs-keyword">for</span> (<span class="hljs-keyword">var</span> i = <span class="hljs-number">0</span>; i < res.devices.length; i++) { <span class="hljs-keyword">if</span> (res.devices[i] && res.devices[i].deviceId == deviceId) { <span class="hljs-comment">// 搜索到该设备 </span> <span class="hljs-built_in">console</span>.log(<span class="hljs-string">"searchDeviceAndReConnect：find device and re connect"</span>); clearTimeout(timeId); stopSearchBluetooth() <span class="hljs-comment">// 停止搜索</span> callback(<span class="hljs-literal">true</span>, <span class="hljs-string">"find device"</span>);<span class="hljs-comment">// 找到设备，在回调函数中连接蓝牙</span> <span class="hljs-keyword">break</span>; } } }, <span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">res</span>) </span>{ clearTimeout(timeId); stopSearchBluetooth() <span class="hljs-comment">// 停止搜索</span> callback(<span class="hljs-literal">false</span>, <span class="hljs-string">"searchBluetooth fail"</span>) }); } |
上述代码提供了一个简单的流程，当连接出现10003错误时，搜索蓝牙设备，找到后，重新连接蓝牙。
考虑到只有部分手机出现10003错误，所以会先连接一次蓝牙，报错10003才进行，以免其他手机会因为搜索蓝牙导致连接蓝牙采集数据的速度减慢；
当然10003，不只是该问题才报的错，所有，在设备没有打开蓝牙时也报10003，而因为加了搜索逻辑，在设备没有打开蓝牙时的提醒就会慢一点（设备蓝牙没打开需要提醒用户打开设备蓝牙），不过好在这一点影响不大，目前没有好的思路去解决，后续再慢慢研究。
该方法仅解决了我这种情况，10003出现的情况很多，不过基本上可以从上一次蓝牙连接是否结束来定位，重新搜索蓝牙后进行连接也是基于上次蓝牙连接未断开这一情况
相关问题
1.微信小程序蓝牙连接仅支持4.0，而BLE低功耗蓝牙设备是带有定位功能的，所以，需要有定位权限，部分手机（如vivo x7plus）需要打开手机定位功能才能搜索到蓝牙设备，详细可百度 “Android6.0蓝牙BLE连接，定位动态权限相关”
2.根据services调用wx.startBluetoothDevicesDiscovery搜索蓝牙时，如果搜索不到，可以去掉services试试，我的一台测试机（印象中是华为P6)就出现带services搜索不到设备，最后只能去掉services, 然后在搜索到的结果中进行过滤
3.wx.startBluetoothDevicesDiscovery搜索蓝牙时，一般人都知道使用wx.onBluetoothDeviceFound，然后部分手机在短时间内进行第二次搜索onBluetoothDeviceFound回调中不能得到所有的设备，此时可以试试wx.getBluetoothDevices，这个方法可以获取到缓存的蓝牙设备，这一部分缓存的蓝牙设备在部分手机中不会再出现在wx.onBluetoothDeviceFound中
4.连接蓝牙后，在进行写操作时，如果写失败，请检查是否设置了characteristicId，这个特征值每次做写操作时都要带上
Android机型多，BLE低功耗蓝牙也不是很稳定，这就导致了在Android上开发蓝牙会有很多奇怪的问题，而微信小程序基于Android和IOS,相应的也会出现一些问题，IOS还好，系统软硬件都单一，但Android的问题就多了，之前开发还遇到一些需要注意的，暂时想不起来，后续再补充
