更新记录

1.0.0(2024-01-15)

iOS原生蓝牙插件发布


平台兼容性

Android iOS
× 适用版本区间:11 - 17

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


目前只支持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>

隐私、权限声明

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

蓝牙权限

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

插件不采集任何数据

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

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