更新记录

1.2.7(2023-04-21)

修复可能出现扫描不到设备的问题

1.2.6(2023-03-30)

修复ios可能出现权限错误的问题,修复安卓下可能出现偶发性的扫不到设备的问题

1.2.5(2023-03-29)

修复安卓下重名ble无法连接的bug

查看更多

平台兼容性

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

原生插件通用使用流程:

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


智密 - BLE通讯插件 - 蓝牙扫描/链接/发送/智能硬件

介绍

智密 - BLE通讯插件提供蓝牙扫描,链接,发送,通讯协议方案,提供hex/text收发方式,协助开发者更好实现智能硬件通讯需求。

应用演示视频

https://www.yuque.com/zhimikeji/kcriuz/ndx1uqi5pzvuxigg

应用场景

智密 - BLE通讯插件支持多种应用场景,包括但不限于以下场景

  • 智能家具控制
  • 蓝牙设备通讯
  • 智能硬件 ...

插件说明文档

开放基本对象如下:

var BLE = uni.requireNativePlugin('Zhimi-BLE')

开放基本接口如下:

// 设置监听事件
BLE.setBLECallback(function(){});
console.log(devicesPaths);

// 初始化蓝牙对象
BLE.openBluetoothAdapter();

// 开始扫描蓝牙设备
BLE.startBluetoothDevicesDiscovery()

// 停止扫描蓝牙设备
BLE.stopBluetoothDevicesDiscovery()

// 链接蓝牙设备 - 此处传入扫描回来的蓝牙address,ios的话传入uuid
BLE.connect("5C:B6:CC:86:55:AD")

// 断开蓝牙设备
BLE.disconnect()

// 扫描服务 - setBLECallback事件会返回获取特征所需要的信息
BLE.discoverServices()

// 通过服务获取特征 - setBLECallback事件会返回收和发所需要的特征码
BLE.discoverCharacteristics("0000fff0-0000-1000-8000-00805f9b34fb") // 传入的数据从discoverServices来的

// 读取数据
BLE.readValueForCharacteristic("00002a26-0000-1000-8000-00805f9b34fb")

// 订阅实时消息 - 订阅传入的特征从discoverCharacteristics来
BLE.setNotifyValueforCharacteristic("0000fff1-0000-1000-8000-00805f9b34fb")

// 发送数据 - 发送传入的特征从discoverCharacteristics来
BLE.writeValue("0000fff2-0000-1000-8000-00805f9b34fb", true, "", 0)
// true = 发送Hex数据, false = 发送text数据
// 0 = 普通发送 1 = 高速发送

其他具体请参考demo

JSSDK

为了更加方便开发者开发,我们提供了二次封装的jssdk版本,在demo中的/pages/sdk.vue文件中有对应的调用Demo,我们推荐开发者使用二次封装的sdk,可以更加简化工作量,提高开发效率。

在线文档

为了方便开发者查阅,我们将提供在线文档,包括常见问题,开发者对接或遇到问题请先查阅该文档https://www.yuque.com/zhimikeji/rplllz

其他

杭州智密科技有限公司专业定制各类Uni-app插件,承接基于Uni-app的APP项目外包; 公司有专职硬件工程师,对IC/ID读卡器、摄像头、身份证读卡器、RFID、打印机、指纹识别、门锁等各类硬件SDK集成经验丰富(也可提供一体机定制服务,承接软硬件一体的交钥匙项目)。 插件有任何问题请高抬贵手不要随意打低分,请联系提交bug,我们会尽快修复。

隐私、权限声明

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

安卓:蓝牙 (安卓11以上需要有定位权限) IOS:蓝牙,定位权限

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

插件不采集任何数据

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

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