更新记录
1.0.0(2024-01-15)
iOS原生蓝牙插件发布
平台兼容性
Android | iOS |
---|---|
× | 适用版本区间:11 - 17 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择
目前只支持ios, 支持蓝牙读取数据、蓝牙匹配、蓝牙发送数据、蓝牙列表
使用说明
1、在manifest.json 里面找到APP原生插件配置,选择已购买或者使用的云端插件
2、添加原生蓝牙权限
3、使用方式:
<script>
export default {
const ByUniPlugin = uni.requireNativePlugin("by-BYBluetooth-BYbtModule")
//必须蓝牙先初始化
ByUniPlugin.initBt({
},
(ret) => {
const msg = JSON.stringify(result);
uni.showToast({
title:'调用初始化方法 ' + msg,
icon: "none"
})
})
//打开蓝牙
ByUniPlugin.openBt({
// 'name': 'uni-app',
// 'age': 1
},
(ret) => {
uni.showToast({
title:'调用OpenBT方法 ' + ret,
icon: "none"
})
})
//关闭蓝牙
ByUniPlugin.closeBt({
// 'name': 'uni-app',
// 'age': 1
},
(ret) => {
uni.showToast({
title:'调用closeBt方法 ' + ret,
icon: "none"
})
})
//查找蓝牙设备
ByUniPlugin.findBt({
},
(ret) => {
uni.showToast({
title:'调用findBt方法 ' + ret.btlist,//列表里面有蓝牙名称、蓝牙RSSI、蓝牙UUID、蓝牙状态、蓝牙advertisementData(外设对外广播的数据,包括外设的本地名称(有可能不存在)、外设提供的服务UUID列表等)
icon: "none"
})
})
//蓝牙配对
ByUniPlugin.retrievePeripheralWithUUID({
'uuid': '4119D777-4EF7-BF8A-6434-21063CCC11E6'//蓝牙UUID
},
(ret) => {
uni.showToast({
title:'调用pairBT方法 ' + ret.characteristicstruuid,
icon: "none"
})
})
//取消对应的蓝牙配对
ByUniPlugin.removeBt({
'uuid': '4119D777-4EF7-BF8A-6434-21063CCC11E6'//蓝牙UUID
},
(ret) => {
uni.showToast({
title:'调用removeBond方法 ' + ret,
icon: "none"
})
})
//取消所有配对
ByUniPlugin.breakBt({
},
(ret) => {
uni.showToast({
title:'调用breakBT方法 ' + ret,
icon: "none"
})
})
//获取已配对列表
ByUniPlugin.findContentedBt({
},
(ret) => {
uni.showToast({
title:'调用breakBT方法 ' + ret.btlist,
icon: "none"
})
})
//对应特征发送数据
ByUniPlugin.sendBtMsg({
'characteristicstruuid': 'Hardware Revision String',//特征id
'uuid': '4119D777-4EF7-BF8A-6434-21063CCC11E6',//蓝牙UUID
'text':'测试发生数据'
},
(ret) => {
uni.showToast({
title:'调用sendMsg方法 ' + ret,
icon: "none"
})
})
}
</script>