微信小程序:蓝牙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,然后进入搜索模块,搜到指定设备后进行蓝牙连接,之后连接成功,这个方案解决了该问题。

wx.createBLEConnection({
    deviceId: deviceId,
    success: function (res) { //连接成功
      initnotifyCharacteristic(notifyCharacteristic);// 指定特征值,并进行数据交互
      // 已连接
      _bthConnectStaus = BTH_STATUS_CONNECTED;
    },
    fail: function (res) {// 连接蓝牙失败
      _bthConnectStaus = BTH_STATUS_DISCONNECT;
      // 回调上层蓝牙连接失败
      callback(res.errCode, "connect failed")
    }

然后根据fail中的res.errCode判断是否10003。

if(code == 10003) { //  部分android手机特殊情况下需要重新搜索才能连接蓝牙,此时报错10003,进行蓝牙搜索(ps:原因可能是系统中将手机蓝牙关闭导致连接状态不能改为断开,导致下次无法连接同一个设备)
    var timeId = setTimeout(function () {
      stopSearchBluetooth();
      callback(false, "timout")
    }, 5000); // 最多搜索5s
    searchBluetooth(function (res) {
      if (res.devices === undefined || res.devices === null) {
        return;
      }
      for (var i = 0; i < res.devices.length; i++) {
        if (res.devices[i] && res.devices[i].deviceId == deviceId) { // 搜索到该设备 
          console.log("searchDeviceAndReConnect:find device and re connect");
          clearTimeout(timeId);
          stopSearchBluetooth() // 停止搜索
          callback(true, "find device");// 找到设备,在回调函数中连接蓝牙
          break;
        }
      }
    }, function (res) {
      clearTimeout(timeId);
      stopSearchBluetooth() // 停止搜索
      callback(false, "searchBluetooth fail")
    });
  }

上述代码提供了一个简单的流程,当连接出现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,这个特征值每次做写操作时都要带上

个人博客: IT老五
微信公众号:【IT老五(it-lao5)】,一起源创,一起学习!


Android机型多,BLE低功耗蓝牙也不是很稳定,这就导致了在Android上开发蓝牙会有很多奇怪的问题,而微信小程序基于Android和IOS,相应的也会出现一些问题,IOS还好,系统软硬件都单一,但Android的问题就多了,之前开发还遇到一些需要注意的,暂时想不起来,后续再补充

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,968评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,601评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,220评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,416评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,425评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,144评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,432评论 3 401
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,088评论 0 261
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,586评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,028评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,137评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,783评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,343评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,333评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,559评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,595评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,901评论 2 345

推荐阅读更多精彩内容