微信硬件蓝牙api(前端开发)

本文仅介绍微信硬件蓝牙开发前端部分基本流程和可能遇到的坑

所需材料:

  1. 基本的前端三件套(HTML,CSS,JS)
  2. js-sdk

配置:

wx.config({
    beta: true,                 //必须配置这个为true,才能调用微信的硬件API
    debug: true,                //是否开启调试模式,会自动弹一些消息框显示微信返回的数据
    appId: 公众号的唯一标识,    //后台给的
    timestamp: 时间戳,          //后台给的
    nonceStr: 随机字符串,       //后台给的
    signature: 证书,            //后台给的
    jsApiList: [                //所有需要调用的接口
        "openWXDeviceLib",      //初始化设备库(只支持蓝牙设备)
        "closeWXDeviceLib",     //关闭设备库(只支持蓝牙设备)
        "getWXDeviceInfos",     //获取当前用户已绑定的蓝牙设备列表
        "sendDataToWXDevice",   //发送数据给设备
        "startScanWXDevice",    //扫描设备(无论绑定还是未被绑定的设备都会扫描到)
        "stopScanWXDevice",     //停止扫描设备
        "connectWXDevice",      //连接设备
        "disconnectWXDevice",   //断开设备连接
        "getWXDeviceTicket",    //获取绑定或解绑硬件的操作凭证
        //如果需要其他js api可继续添加

        //监听事件:
        "onWXDeviceBindStateChange",    //监听硬件设备绑定状态
        "onWXDeviceStateChange",        //监听连接状态,可以监听连接中、已连接、连接断开
        "onReceiveDataFromWXDevice",    //监听接收来自硬件设备的数据
        "onScanWXDeviceResult",         //监听扫描到的设备
        "onWXDeviceBluetoothStateChange",  //监听手机蓝牙打开或关闭
    ]
});

最基本的调用:

wx.ready(() => {
    // config配置成功后调用,所有微信api操作都应在config配置成功后进行。
    wx.invoke('openWXDeviceLib', {  //初始化硬件设备库
        'brandUserName': 'gh_xxxxxxxxxx'    //必须加上这个公众号原始ID,否则部分机型无法初始化
    }, (res) => {
        //res结果可参考文章底部的微信硬件平台说明文档,或者自己试着输出看看
    });
});
wx.error((res) => {
    // config配置失败调用。
});

调用方法和监听的基本形式:

wx.invoke(jsApiName, params, callback); //方法,所有方法的参数params都含有默认的'connType': 'blue'字段,此字段可写可不写
wx.on(listenName, callback);   //监听

坑:即使不想写params参数,也要加个空对象{}传参

例子(更多方法和事件可查阅微信硬件平台说明文档):

wx.on('onReceiveDataFromWXDevice', (res) => {
    console.log(Base64.decode(res.base64Data));    //发送数据和接收数据都需要base64编码和解码,下载一个Base64.js即可
});
wx.invoke('sendDataToWXDevice', {
    'deviceId': deviceId, 
    'connType': 'blue', 
    'base64Data': Base64.encode(data)
}, (res) => {
    //用于发送数据(指令)给设备
});

注意事项:

  1. 流程(在回调中执行下一步):初始化 -> 扫描设备 -> 绑定设备(通过getWXDeviceTicket方法获取ticket,并发送给后台进行绑定,在监听绑定状态事件中获知是否绑定成功) -> 连接设备(在监听绑定状态事件中获知是否连接成功) -> 发送数据(数据都需要经过Base64编码和解码,在监听接收设备数据中获取设备发送的数据)
  2. 在扫描设备时,已被连接或者已被绑定的设备可能无法被扫描到。
  3. 停止扫描没有效果的解决办法:直接使用closeWXDeviceLib关闭设备,下次扫描再重新打开。
  4. 扫描一次后,刷新页面或者跳转页面再回来无法再扫描到任何设备解决办法:每次扫描前使用closeWXDeviceLib关闭设备再openWXDeviceLib重新打开,然后再进行扫描操作。
  5. 在绑定设备时,如果已被绑定过,则无法通过监听获知是否绑定成功,只能通过获取设备信息(getWXDeviceInfos),并遍历结果获知设备是否绑定,因此绑定成功回调方法应同时写在监听事件中和获取设备信息中。
  6. 一些设备在绑定成功后自动连接,同理第5点,连接成功回调方法应同时写在监听事件中和获取设备信息中。
  7. 为解决第5、6点存在的问题,建议进入页面时先获取设备信息并保存下来,在绑定和连接操作的时候即时更新设备信息,在后续方法中可减少操作。
  8. 使用微信web开发者工具移动端调试时,不会有报错信息!!!代码中断了代表你写错了,不用怀疑。(使用X5 Blink内核调试除外)
  9. 只能扫描到关注了的公众号绑定的硬件,同一硬件不可被多个公众号绑定使用。
  10. 如果发送命令后没有返回数据,可尝试多次重发。
  11. 在项目上,极有可能流程卡在一些绑定、连接、发送数据操作上,重试和无回应或错误提示是有必要的。

微信JS-SDK说明文档
微信硬件平台说明文档

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

推荐阅读更多精彩内容