更新记录

1.1(2023-08-30)

增加IOS支持

1.0(2023-08-16)

初次发布


平台兼容性

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

原生插件通用使用流程:

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


通用callback数据

{
    "error":0, 
    "data":"" 
}
error=0 为成功
data 为相关业务数据,String/JSON

网关API

const TTGatewayService = uni.requireNativePlugin('rui-sciener-lock');

是否启用蓝牙
TTGatewayService.isBLEEnabled()
搜索网关
TTGatewayService.startScan({},(res)=>{})
停止搜索
TTGatewayService.stopScan()
连接网关
TTGatewayService.connectGateway(macAddress,(res)=>{
)
初始化网关
TTGatewayService.initGateway(
{  
    "uid":"通通锁用户ID,通过/v3/user/getUid 获取的UID",
    "password":"通通锁用户密码MD5值",
    "address":"网关MAC地址",
    "wifiSSID":"WIFI名称,非WIFI版必需为空或不传",
    "wifiPassword":"WIFI密码,非WIFI版必需为空或不传"
},
(res)=>{
)
搜索WIFI列表
TTGatewayService.scanWiFiByGateway(macAddress,(res)=>{
)

锁API

const TTLockService = uni.requireNativePlugin('rui-sciener-gateway');

搜索锁列表
TTLockService.startScan({},(res)=>{
)
停止搜索
TTLockService.stopScan()
初始化锁
TTLockService.initLock({
    "address":"锁mac地址"
},(res)=>{
)
连接锁
TTLockService.connectLock({"lockData":""},(res)=>{
});
控制锁
TTLockService.controlLock({
    "action":"3",
    "lockData:"",
    "lockMac":""
},(res)=>{
)
action:
    3=开锁
    6=关锁
重置锁
TTLockService.resetLock({"lockData":"","lockMac":""},(res)=>{
});
获取电量
TTLockService.getBatteryLevel({"lockData":"","lockMac":""},(res)=>{
});
搜索WIFI列表
TTLockService.scanWifi({"lockData":""},(res)=>{
});
获取WIFI信息
TTLockService.getWifiInfo({"lockData":""},(res)=>{
});
设置WIFI信息
TTLockService.configWifi({"lockData":"","SSID":"WIFI名称","password":"WIFI密码"},(res)=>{
});
设置WIFI远程服务器
TTLockService.configServer({"lockData":"","host":"wifilock.ttlock.com","port":4999},(res)=>{
});
获取远程开锁功能状态
TTLockService.getRemoteUnlockSwitchState({"lockData":"","lockMac":""},(res)=>{
});
设置远程开锁功能
TTLockService.setRemoteUnlockSwitchState({"enable":true/false,"lockData":"","lockMac":""},(res)=>{
});
获取IC卡列表
TTLockService.getAllValidICCards({"lockData":"","lockMac":""},(res)=>{
});
添加IC卡
startDate/endDate 为13位时间戳,都为0时永不过期 
TTLockService.addICCard({"startDate":0,"endDate":0, "lockData":"","lockMac":""},(res)=>{
});
删除IC卡
TTLockService.deleteICCard({"cardNum":"IC卡编号", "lockData":"","lockMac":""},(res)=>{
});
清空所有IC卡
TTLockService.clearAllICCard({"lockData":"","lockMac":""},(res)=>{
});
修改管理密码
TTLockService.modifyAdminPasscode({"password":"", "lockData":"","lockMac":""},(res)=>{
});
获取所有密码
TTLockService.getAllValidPasscodes({ "lockData":"","lockMac":""},(res)=>{
});
重置密码(之前生成的密码都将失效)
TTLockService.resetPasscode({ "lockData":"","lockMac":""},(res)=>{
});
删除密码
TTLockService.deletePasscode({"passcode":"", "lockData":"","lockMac":""},(res)=>{
});
修改密码
startDate/endDate 为13位时间戳,都为0时永不过期
TTLockService.modifyPasscode({"originalCode":"原密码","newCode":"新密码","startDate":0,"endDate":0, "lockData":"","lockMac":""},(res)=>{
});
创建密码
startDate/endDate 为13位时间戳,都为0时永不过期
TTLockService.createCustomPasscode({"passcode":"密码","startDate":0,"endDate":0, "lockData":"","lockMac":""},(res)=>{
});
获取日志
TTLockService.getOperationLog({"logType":"0/1","lockData":"","lockMac":""},(res)=>{
});
获取锁时间戳
TTLockService.getLockTime({"lockData":"","lockMac":""},(res)=>{
});
设置锁时间戳
TTLockService.setLockTime({"timestamp":"13位时间戳",lockData":"","lockMac":""},(res)=>{
});
设置自动关锁时间
TTLockService.setAutomaticLockingPeriod({"seconds":"秒",lockData":"","lockMac":""},(res)=>{
});

隐私、权限声明

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

蓝牙

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

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

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