金万码蓝牙电子钥匙SDK

更新记录

1.0.7（2024-01-24）

增加钥匙离线开锁功能

1.0.6（2023-12-14）

钥匙可以下载多任务

1.0.5（2023-09-17）

增加多任务版本钥匙的支持。增加指纹采集功能。

平台兼容性

Android	Android CPU类型	iOS
适用版本区间：4.4 - 12.0	armeabi-v7a：支持，arm64-v8a：支持，x86：支持	适用版本区间：9 - 16

原生插件通用使用流程：

购买插件，选择该插件绑定的项目。
在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原生插件配置”->”云端插件“列表中删除该插件重新选择

沈阳金万码蓝牙电子钥匙二次开发插件使用说明

使用方法

导出插件方法

    const blesdk = uni.requireNativePlugin('Vanma-BleKeyModule');
    const globalEvent = uni.requireNativePlugin('globalEvent');

相关函数说明

扫描蓝牙钥匙

参数说明：

timeout 扫描时间单位为毫秒 scanBleCallback 回调函数扫描结果 startScan(timeout, scanBleCallback); 例子:

......

blesdk.startScan(20000,(res)=>{
      let device = res.device;
      //device.deviceId,device.keyid,device.RSSI
      this.data.devices.push(device);
      let devices = this.data.devices;
      this.setData({devices});      
  });

停止扫描蓝牙钥匙

参数说明

无 stopScan()

连接蓝牙钥匙

参数说明

options: {mac:string,secret:string,sign:int} mac 扫描到的蓝牙设备 secret 钥匙密钥(20位，由0..9,A..F组成) sign 钥匙标志(一般默认为0)

connectToKey(options,callback)

例:

    blesdk.connectToKey({mac:this.mac,secret:"FFFFFFFFFFFFFFFFFFFF",sign:0},res=>{
        console.log(JSON.stringify(res));
    });

读取钥匙信息

readKeyInfo();

    blesdk.readKeyInfo(res=>{
        console.log(JSON.stringify(res));
    });

读取钥匙记录

参数说明

clearFlag boolean 型,true 读取成功后删除钥匙记录

readKeyRecords(clearFlag,callback);

    blesdk.readKeyRecords(false,res=>{
        console.log(JSON.stringify(res));
    });

删除钥匙中的记录

clearRecords();

    blesdk.clearRecords(res=>{
        console.log(JSON.stringify(res));
    });

设置用户钥匙(开关锁钥匙)

参数说明

options:{"userKeyInfo":UserKeyInfo,"isOnline":boolean} userKeyInfo 任务内容格式例:

{
"lockIds":["202209059905","202209060369"],
"timeBlocks":[
              {"from":"2022-10-24","to":"2025-10-24",
                "times":[
                    {"from":"00:00:00","to":"23:59:59"}
                    ]
              }
            ]
}
其中 lockIds 需要开关的锁的id,由12位数字组成
timeBlocks 为开关锁的 日期段和时间段
isOnline boolean 型，钥匙是否在线 true 为在线使用，钥匙与app断开后不能在进行开关锁。false 离线模式，钥匙与app断开后可以继续开关锁。

setUserKey(options, callback) 例

    blesdk.setUserKey({"userKeyInfo":userKeyInfo,"isOnline":true},res=>{
        console.log(JSON.stringify(res));
    });

设置采集锁号钥匙

setReadLockIdKey()

    blesdk.setReadLockIdKey(res=>{
        console.log(JSON.stringify(res));
    });

设置成功后，用钥匙接触锁，会在onReport事件中返回采集记录。

设置管理钥匙

参数说明

options: {from:"yyyy-MM-dd HH:mm:ss",to:"yyyy-MM-dd HH:mm:ss"} 钥匙的有效期(sdk中只取日期部分) 如：

{"from":"2022-10-24 00:00:00","to":"2025-10-24 23:59:59"}

setManagerKey(options,callback); 例

    blesdk.setManagerKey(res=>{
        console.log(JSON.stringify(res));
    });

管理钥匙具有最高权限，可以开同一密钥下的所有锁。

设置事件钥匙

参数说明

options: {from:"yyyy-MM-dd HH:mm:ss",to:"yyyy-MM-dd HH:mm:ss"} 钥匙的有效期(sdk中只取日期部分) 如：

{"from":"2022-10-24 00:00:00","to":"2025-10-24 23:59:59"}

setEventsKey(options,callback) 例

    blesdk.setManagerKey(res=>{
        console.log(JSON.stringify(res));
    });

设置成功后，用钥匙接触锁，会将锁中的数据读取到钥匙中。

设置黑名单钥匙

参数说明

options: {from:"yyyy-MM-dd HH:mm:ss",to:"yyyy-MM-dd HH:mm:ss",keyIds:[string]} from,to钥匙的有效期(sdk中只取日期部分) keyIds:黑名单钥匙列表

如：

{"from":"2022-10-24","to":"2025-10-24","keyIds": ["200007270001"]}

setBlockListKey(options,callback)

例

    blesdk.setBlockListKey({"from":"2022-10-24","to":"2025-10-24","keyIds": ["200007270001"]},
    res=>{
        console.log(JSON.stringify(res));
    });

先将黑名单钥匙下载到钥匙中，然后用钥匙接触锁，将黑名单钥匙列表写入到锁中。其中有效时间段，为钥匙作为黑名单钥匙的有效时间。清空锁中的黑名单，keyIds:[]

设置空白单钥匙

将钥匙里面的所有信息清空。 setBlankKey(callback) 例

    blesdk.setBlankKey(res=>{
        console.log(JSON.stringify(res));
    });

设置注册锁钥匙

参数说明

options:{from:"yyyy-MM-dd HH:mm:ss",to:"yyyy-MM-dd HH:mm:ss", "secretInfo":{"oldSecret":string,"nowSecret":string} } from,to钥匙的有效期(sdk中只取日期部分) oldSecret 锁的原密钥 newSecret 锁的新密钥其中密钥由 A..F,0..9 共20个字符组成如：

{"from":"2022-10-24","to":"2025-10-24","secretInfo":{"oldSecret":"FFFFFFFFFFFFFFFFFFFF","nowSecret":"FFFFFFFFFFFFFFFFFFFF"}}

setRegisterKey(options,callback) ;

例

    let options = {"from":"2022-10-24","to":"2025-10-24","secretInfo":{"oldSecret":"FFFFFFFFFFFFFFFFFFFF","nowSecret":"FFFFFFFFFFFFFFFFFFFF"}};
    blesdk.setBlankKey(options,res=>{
        console.log(JSON.stringify(res));
    });

将钥匙设置为注册钥匙后，钥匙的密钥也会被修改为新密钥。将钥匙设置为注册钥匙后，用钥匙接触锁，修改锁的密钥。

蓝牙钥匙在线授权

如果制作开关锁钥匙 setUserKey 的 isOnline=true,则需要将钥匙在线授权才能开关锁

setOnline(callback); 例

    blesdk.setOnline(res=>{
        console.log(JSON.stringify(res));
    });

清除钥匙的黑名单标志

清除钥匙中的黑名单标记 clearBlocklistFlag(callback) 例

    blesdk.clearBlocklistFlag(res=>{
        console.log(JSON.stringify(res));
    });

钥匙校时

参数说明

options: yyyy-MM-dd HH:mm:ss setDateTime(options,callback)

    blesdk.setDateTime("2022-12-18 19:20:33",res=>{
        console.log(JSON.stringify(res));
    });

设置钥匙密钥

参数说明

options: {"nowSecret":string,"oldSecret":string}; nowSecret 钥匙的新密钥 oldSecret 钥匙的原密钥其中密钥由 A..F,0..9 共20个字符组成

setKeySecret(options,callback)

    blesdk.setKeySecret({"nowSecret":"FFFFFFFFFFFFFFFFFFFF","oldSecret":"FFFFFFFFFFFFFFFFFFFF"},
    res=>{
        console.log(JSON.stringify(res));
    });

下载指纹到钥匙

参数说明

options:{param = {id:1,fea:string} id 型，指纹id fea 指纹特征值 setFingerprint(options,callback)

    let options = {id:1,fea:"eJybHRVS5............................"}
    blesdk.setFingerprint(options,
    res=>{
        console.log(JSON.stringify(res));
    });

指纹授权

参数说明

options:[int] int 型数组,最多20个，只有针对授权的指纹id,指纹才能识别成功

setFingers(options,callback) 如：

blesdk.setFingers([5,6,29,30],res=>{
    console.log(JSON.stringify(res));
});

删除指纹授权

参数说明

options: int 指纹id 当指纹id == 0 时，删除全部指纹，否则删除指定的指纹

deleteFingerprint(options,callback)

blesdk.deleteFingerprint(10,res=>{
    console.log(JSON.stringify(res));
});

断开app与蓝牙钥匙的连接

参数说明

disconnectFromKey(callback)

blesdk.disconnectFromKey(10,res=>{
    console.log(JSON.stringify(res));
});

事件

onReport 事件

自动上报开关锁记录事件例

  globalEvent.addEventListener('onReport', function(data) {
        console.log(JSON.stringify(data));  
  });

名词解释

空白钥匙：空白模式，钥匙不起任何作用
用户钥匙：在给定的时间范围内，开指定的的锁。
管理钥匙：具有最高权限，在指定的时间内可以开密钥一直的所有的锁。
采集锁号钥匙：采集模式，用来采集锁具的（唯一）锁号。
注册钥匙：初始化模式，用来设置锁的密钥。需要被设置的锁的原始密钥要与注册钥匙的原始密钥一致。
事件钥匙：事件模式，采集锁具的开关锁记录记录。
黑名单钥匙：黑名单模式，将黑名单（丢失）钥匙（最多100个）下载到锁具中。
注：模式只有一个起作用