首页 > 文章 > 微信小程序 > 微信硬件JS-Api开发不完全指南

微信硬件JS-Api开发不完全指南

高洛峰原创: 2017-02-09 09:28:521904浏览

1.引入JS库

 <script type=&#39;text/javascript&#39; src=&#39;//res.wx.qq.com/open/js/jweixin-1.0.0.js&#39;></script>

2.为页面注入配置信息

wx.config({
    beta: true, // 开启内测接口调用，注入wx.invoke方法,非常重要!!必须有这个
    debug: true,//开启调试接口，alert运行结果
    appId: '',//必填，公众号的唯一标识,
    timestamp: '',//必填，生成签名的时间戳
    nonceStr: '',//必填，生成签名的随机串
    signature: '',//必填，签名
    jsApiList: []//要调用的js函数，必须把函数名字写入数组
});

这里我的jsApiList为

jsApiList: [
            'openWXDeviceLib',//初始化设备库（只支持蓝牙设备）
            'closeWXDeviceLib',//关闭设备库（只支持蓝牙设备）
            'getWXDeviceInfos',//获取设备信息（获取当前用户已绑定的蓝牙设备列表）
            'sendDataToWXDevice',//发送数据给设备
            'startScanWXDevice',//扫描设备（获取周围所有的设备列表，无论绑定还是未被绑定的设备都会扫描到）
            'stopScanWXDevice',//停止扫描设备
            'connectWXDevice',//连接设备
            'disconnectWXDevice',//断开设备连接
            'getWXDeviceTicket',//获取操作凭证
            'onWXDeviceBindStateChange',//微信客户端设备绑定状态被改变时触发此事件
            'onWXDeviceStateChange',//监听连接状态，可以监听连接中、连接上、连接断开
            'onReceiveDataFromWXDevice',//接收到来自设备的数据时触发
            'onScanWXDeviceResult',//扫描到某个设备时触发
            'onWXDeviceBluetoothStateChange',//手机蓝牙打开或关闭时触发
        ]

如果想要测一下微信版本是不是支持这几个api，可以这样写：

 wx.checkJsApi({
    jsApiList: ['openWXDeviceLib', 'onScanWXDevicesResult', 'getWXDeviceInfos'], // 需要检测的JS接口列表，所有JS接口列表见附录2,
    success: function (res) {
        console.log(res);

    }
});

3.初始化设备库函数

通过ready接口处理成功验证

wx.ready(function () {          
    wx.invoke('openWXDeviceLib', {connType: 'blue'}, function (res) {
        console.debug('openWXDeviceLib重新打开设备库==>');
        console.log(res);
    });
})

坑：重新扫描设备根本什么都扫不出来，即使是刷新页面也不顶用

解决方法：每次扫描前，先调用closeWXDeviceLib关闭设备库，再调用openWXDeviceLib打开设备库。这样就相当于重新初始化了一遍设备库，你现在再重新扫描，就可以扫描到设备了。

代码：

wx.invoke("stopScanWXDevice", {}, function (res) {
    console.debug('stopScanWXDevice');
    console.log(res);
 });
wx.invoke("closeWXDeviceLib", {}, function (res) {
    console.debug('closeWXDeviceLib关闭设备库==>');
    console.log(res);
});

wx.invoke('openWXDeviceLib', {connType: 'blue'}, function (res) {
    console.debug('openWXDeviceLib重新打开设备库==>');
    console.log(res);
});

4.监听设备返回的信息

wx.on('onReceiveDataFromWXDevice', function (res) {
    console.warn('onReceiveDataFromWXDevice=>');
    console.log(JSON.stringify(res));
});

5.发送消息到设备

收发数据前需进行 base64 的编解码。
这里，我用到一个库：

    <script type=&#39;text/javascript&#39; src=&#39;base64.js&#39;></script>

出处：
http://www.php.cn/

var data={"deviceId":deviceId,"base64Data": Base64.encode('你要发送的数据')};
console.log(data);
wx.invoke('sendDataToWXDevice',data , function(res){
    //回调
    console.info('发消息到设备sendMsg');
    console.log(data);
    console.log(res);
    $('#dataFromDevice').append('发送消息的结果：'+JSON.stringify(res));
    alert('已发送 请查看控制板');
});

说明：

1.需要在微信对应设备号内才能使用对应的api。

2.必须要在设备号设置的安全域名下才能正常使用api

3.本篇内所有的console.log 等输出到控制台都是用的vconsole调试工具实现。