更新记录

1.0.1(2023-10-08) 下载此版本

优化系统

1.0.0(2023-09-20) 下载此版本

插件初始化、搜索设备、连接设备、发送数据、收到数据回调


平台兼容性

Android Android CPU类型 iOS
适用版本区间:6.0 - 12.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 ×

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


1.导入插件 2.在vue或nvue中引入 var bleModule = uni.requireNativePlugin("sbl-ble") 3.初始化插件 bleModule.init((result) => { console.log("result", result); //result=0:蓝牙未打开 //result =1:定位服务未打开 // result = 2:初始化成功 }) 4.搜索设备 bleModule.search() 搜索到新设备的监听,建议放在onload里面 var globalEvent = uni.requireNativePlugin('globalEvent'); //这是搜索设备的监听 globalEvent.addEventListener('newdevice', function(e) {

            var bean = JSON.parse(JSON.stringify(e))
            var job = bean.key;

            var devc = {
                name: job.name,//蓝牙设备的名称
                address: job.address,//蓝牙设备的mac地址 

            } 

        }); 
停止搜索设备  bleModule.stopSearch()    

5.连接设备 item.address:设备的address bleModule.connect(item.address, (e) => { //这里返回的是连接状态, var bean = JSON.parse(JSON.stringify(e)) var job = bean.state;

    if (job == 0) {
        uni.showToast({
            title: '连接成功0'
        });

    } else if (job == -1) {
        uni.showToast({
            title: '连接失败0'
        });
    } else if (job == -2) {
        uni.showToast({
            title: '连接取消'
        });
    } else if (job == -7) {
        uni.showToast({
            title: '连接超时'
        });
    }

},(list)=>{
    这里返回的是设备的service和character,一般来说用不上,设备的厂商会提供需要连接的uuid
    // that.service = JSON.stringify(list)
})

6.连接状态的监听 建议放在onload里面 globalEvent.addEventListener('devblestate', function(e) { //0成功 var bean = JSON.parse(JSON.stringify(e)) var job = bean.key; if (job.state == 16) { uni.showToast({ title: '重连成功' }); } else if (job.state == 32) { uni.showToast({ title: '连接断开' }); }

}); 咱们的框架是断开自动连接的,如果想让断开不自动连接,就调用bleModule.destory(item.address),这是断开连接

7.设置数据notify回调 this.mac:设备的mac地址:例如ff:ff:ff:ff:ff:ff this.service:设备的serviceUuid,例如 "55535343-fe7d-4ae5-8fa9-9fafd205e455", this.notifyCharacter:设备notify数据的CharacterUuid,例如 "55535343-fe7d-4ae5-8fa9-9fafd205e457", bleModule.setnotify(this.mac,this.service,this.notifyCharacter,(result)=>{ var bean = JSON.parse(JSON.stringify(result)) var job = bean.state; if (job == 0) { uni.showToast({ title: '设置回调成功' });

} else if (job == -1) {
    uni.showToast({
        title: '设置回调失败'
    });
} 

})

8.接收数据 //这是设备返回数据的监听,建议放在onload里面 globalEvent.addEventListener('notify', function(e) {

var bean = JSON.parse(JSON.stringify(e))
var job = bean.key;
job.service:设备的serviceUuid
job.character:设备notify数据的CharacterUuid
job.value:真实数据,这个是经过转换之后的十进制字符串

that.ntext =  "service:"+job.service+";character:"+job.character
+";value:"+job.value

});

9.发送数据给蓝牙设备 this.mac:设备的mac地址:例如ff:ff:ff:ff:ff:ff this.service:设备的serviceUuid,例如 "55535343-fe7d-4ae5-8fa9-9fafd205e455", this.writeCharacter:设备写数据的CharacterUuid,例如 "55535343-fe7d-4ae5-8fa9-9fafd205e456", this.date:要发送的数据,十六进制字符串,不需要写0x,例如 “A55A” bleModule.sendDate(this.mac,this.service,this.writeCharacter,this.date,(result)=>{ var bean = JSON.parse(JSON.stringify(result)) var job = bean.state; if (job == 0) { uni.showToast({ title: '数据发送成功' }); } else if (job == -1) { uni.showToast({ title: '数据发送失败' }); } })

10.断开连接 item.address:设备的mac地址 bleModule.destory(item.address),断开连接

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<uses-permission android:name="android.permission.BLUETOOTH" /> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" /> <uses-permission android:name="android.permission.BLUETOOTH_PRIVILEGED" tools:ignore="ProtectedPermissions" />

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

作者未提供license.md

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问