更新记录

1.0.3（2021-10-22）

修复IOS打包问题

1.0.2（2021-10-12）

修复android版本蓝牙连接失败json解析异常问题；

1.0.1（2021-07-29）

更新权限说明

平台兼容性

原生插件通用使用流程：

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

使用说明

安芯智能门锁 SDK 插件

1、判断蓝牙是否打开

icinLock.isBluetoothEnable()

2、扫描设备

lock

const icinLock = uni.requireNativePlugin('ICIN-Lock');
icinLock.scanDevices(
    (lock) => {
        //扫描到一个设备回调一次
    },
    () => {
        //扫描结束
    }
);

3、蓝牙连接

icinLock.connect(
    lockId,
    (lock) => {
        //连接成功
    },
    (err) => {
        //连接失败
        console.log(err.code + ',' + err.description);
    }
);

4、断开蓝牙连接

icinLock.disconnectAll();

5、绑定门锁

请求参数

返回值 AddUserResponse

icinLock.bindLock(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        keyId: 'keyId',
        superAdminId: 'www.icintech.com',
        time: Math.round(Date.now() / 1000),
        nbIp: '192.168.1.1',
        nbPort: '9090',
    },
    (result) => {
        if (result.status == 0) {
            //绑定成功
            var authKey = result.response.authKey;
        } else {
            //绑定失败
        }
    }
);

6、添加用户

请求参数

返回值 AddUserResponse

icinLock.addUser(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        userId: 'admin',
        authKey: 'authKey',
        role: 1, //1管理员，0普通用户
    },
    (result) => {
        if (result.status == 0) {
            //添加成功
            var authcode = result.response.authCode;
        } else {
            //添加失败
        }
    }
);

7、开门

请求参数

icinLock.openDoor(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        userId: 'admin',
        openMode: 1,
        openTime: Math.round(Date.now() / 1000),
        authCode: 'authCode',
    },
    (result) => {
        if (result.status == 0) {
            //开锁成功
        } else {
            //开锁失败
        }
    }
);

8、设置网关

NB 锁有效

请求参数

icinLock.setGateway(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        userId: 'admin',
        nbIp: '192.168.1.1',
        nbPort: '9090',
        authCode: 'authCode',
    },
    (result) => {
        if (result.status == 0) {
            //设置网关成功
        } else {
            //设置网关失败
        }
    }
);

9、设置 WIFI

针对 WIFI 锁有效

请求参数

icinLock.setWifi(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        userId: 'admin',
        wifiSSID: 'wifi名称',
        wifiPWD: 'wifi密码',
        authCode: 'authCode',
    },
    (result) => {
        if (result.status == 0) {
            //设置WIFI成功
        } else {
            //设置WIFI失败
        }
    }
);

10、删除用户

请求参数

icinLock.deleteUser(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        userId: 'admin',
        authKey: 'authKey',
    },
    (result) => {
        if (result.status == 0) {
            //删除成功
        } else {
            //删除失败
        }
    }
);

11、读取锁状态

请求参数

返回值 ReadLockInfoResponse

icinLock.readLockInfo(
    {
        lockId: 'ICIN_b47f6ce31ad8',
    },
    (result) => {
        if (result.status == 0) {
            var lockInfo = result.response;
        } else {
            //读取失败
        }
    }
);

12、重置门锁

请求参数

icinLock.resetLock(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'keyId',
        authKey: 'authKey',
    },
    (result) => {
        if (result.status == 0) {
            //重置成功
        } else {
            //重置失败
        }
    }
);

13、设置音量

请求参数

icinLock.setVolume(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        userId: 'admin',
        volumeFlag: 2,
        authCode: 'authCode',
    },
    (result) => {
        if (result.status == 0) {
            //设置音量成功
        } else {
            //设置音量失败
        }
    }
);

14、同步门锁时间

请求参数

icinLock.syncLockTime(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        userId: 'admin',
        authCode: 'authCode',
        time: Math.round(Date.now() / 1000),
    },
    (result) => {
        if (result.status == 0) {
            //同步成功
        } else {
            //同步失败
        }
    }
);

15、固件升级

请求参数

icinLock.updateFirmware(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        userId: 'admin',
        fileVersion: 0x1e150419,
        file: hexStr,
        authCode: 'authCode',
    },
    (result) => {
        if (result.status === 0) {
            //会有多次回调
            if (result.response.progress >= 100) {
                //更新固件成功
            }
        } else {
            //更新固件失败
        }
    }
);

16、查询密码

请求参数

返回值 QueryPasswordResponse

icinLock.queryPassword(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        authUserId: 'admin',
        userId: 'admin',
        authCode: 'authCode',
    },
    (result) => {
        if (result.status == 0) {
            //查询成功
            var list = result.response.passwords;
        } else {
            //查询失败
        }
    }
);

17、添加密码

请求参数

icinLock.addPassword(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        authUserId: 'admin',
        userId: 'admin',
        pwdNo: 0,
        password: '123456',
        useCountLimit: 0xff,
        startTime: Math.round(startTime / 1000),
        endTime: Math.round(endTime / 1000),
        authCode: 'authCode',
    },
    (result) => {
        if (result.status == 0) {
            //添加密码成功
        } else {
            //添加密码失败
        }
    }
);

18、删除密码

请求参数

icinLock.deletePassword(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        authUserId: 'admin',
        userId: 'admin',
        pwdNo: 0,
        authCode: 'authCode',
    },
    (result) => {
        if (result.status == 0) {
            //删除成功
        } else {
            //删除失败
        }
    }
);

19、查询指纹

请求参数

返回值 QueryFingerprintResponse

icinLock.queryFingerprint(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        authUserId: 'admin',
        userId: 'admin',
        authCode: 'authCode',
    },
    (result) => {
        if (result.status == 0) {
            //查询指纹成功
            var list = result.response.fingerprints;
        } else {
            //查询指纹失败
        }
    }
);

20、添加指纹

请求参数

icinLock.addFingerprint(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        authUserId: 'admin',
        userId: 'admin',
        alarmFinger: 0,
        authCode: 'authCode',
    },
    (result) => {
        if (result.status == 0) {
            //会回调4次
            if (result.response.completeFlag == 1) {
                //录入成功
            }
        } else {
            //添加指纹失败
        }
    }
);

21、读取开门记录

每次最多读 5 条，直到锁端返回空，需要注意的是，当读取下一个 5 条时，之前的记录将清空。

请求参数

返回值 ReadLockRecordResponse

icinLock.readOpenRecord(
    {
        lockId: 'ICIN_b47f6ce31ad8',
        superAdminId: 'www.icintech.com',
        keyId: 'adminKeyId',
        userId: 'admin',
        authCode: 'authCode',
    },
    (result) => {
        if (result.status == 0) {
            var list = result.response.recordInfos;
            if (list && list.length > 0) {
                //调用readNextOpenRecord前,上传list到服务器保存，防止记录丢失
                //读取后边的开门记录
                icinLock.readNextOpenRecord();
            }
        } else {
            //读取开门记录失败
        }
    }
);

22、清除缓存密钥

删除用户时使用,清除对应用户的缓存密钥。

icinLock.clearPrivateKey(lockId, userId);

23、错误码说明