863 lines
31 KiB
Markdown
863 lines
31 KiB
Markdown
# 说明
|
||
|
||
星云SDK是一款专为微信小程序开发者打造的智能锁插件，旨在简化与智能锁与星云平台的交互。通过封装底层操作，使接入者无需关注锁的操作逻辑，能够将更多精力集中在业务开发中。
|
||
|
||
# 版本
|
||
|
||
当前最新版本 1.1.0
|
||
|
||
# 引用
|
||
|
||
APPID: **wxf2c491f734bbf82f**
|
||
|
||
1. 登录小程序后台-选择设置->第三方设置->插件管理->点击“添加插件”->搜索对应APPID->添加插件->等待审核通过
|
||
2. 项目中引用需在app.json文件中添加
|
||
|
||
```json
|
||
{
|
||
"plugins": {
|
||
"starCloud": {
|
||
"version": "1.1.0",
|
||
"provider": "wxf2c491f734bbf82f"
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
3. 页面中引用
|
||
|
||
```javascript
|
||
// 引用插件
|
||
const plugin = requirePlugin('starCloud')
|
||
```
|
||
|
||
# 公共参数
|
||
|
||
## Result 方法的统一返回结构
|
||
|
||
```javascript
|
||
// Result 类是所有有返回结果的方法，统一的返回结构
|
||
const {Result} = requirePlugin('starCloud')
|
||
// code对应报错码有三部分组合构成，锁端报错码+星云服务端报错码+自定义报错码
|
||
const {code, data, message} = Result.Success
|
||
// 常用判断方式
|
||
if (code === Result.Success.code) {
|
||
// 逻辑代码
|
||
} else {
|
||
// 错误处理
|
||
}
|
||
```
|
||
|
||
| code | 变量名 | 描述 |
|
||
|------|-------------------------------------------|----------------------------------|
|
||
| 0 | Success | 成功 |
|
||
| -1 | Fail | 失败 |
|
||
| -10 | NotMoreData | 没有更多数据 |
|
||
| -20 | NotAvailableBluetooth | 蓝牙尚未打开，请先打开蓝牙 |
|
||
| -21 | NotAvailableBluetoothPermission | 小程序蓝牙功能被禁用，请打开小程序蓝牙权限 |
|
||
| -22 | NotAvailableWeChatNearbyDevicesPermission | 蓝牙功能需要附近设备权限，请前往设置开启微信的附近设备权限后再试 |
|
||
| -23 | NotAvailableWeChatLocationPermission | 蓝牙功能需要定位权限，请前往设置开启微信的定位权限后再试 |
|
||
| -24 | NotAvailableWeChatNearbyDevicesEmpty | 蓝牙功能需要定位服务，请前往设置开启定位服务后再试 |
|
||
| -25 | NotAvailableWeChatBluetoothPermission | 微信的蓝牙权限被禁用，请前往设置开启微信的蓝牙权限后再试 |
|
||
| -30 | DeviceHasBeenReset | 设备已被重置 |
|
||
| 251 | ReadyHasPassword | 该密码已存在 |
|
||
|
||
## AccountInfo 账号信息
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|----------|--------|-------|
|
||
| uid | Number | 用户uid |
|
||
| username | String | 用户名 |
|
||
| password | String | 密码 |
|
||
|
||
## LockInfo 锁信息
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|------------------------|-----------------|-----------|
|
||
| deviceId | String | 设备 ID |
|
||
| serviceId | String | 服务 ID |
|
||
| notifyCharacteristicId | String | 通知特征值 ID |
|
||
| writeCharacteristicId | String | 写入特征值 ID |
|
||
| pwdTimestamp | Number | 密码时间戳（毫秒） |
|
||
| featureValue | String | 功能值 |
|
||
| featureSettingValue | String | 功能设置值 |
|
||
| featureSettingParams | Array.\<Number> | 功能设置参数 |
|
||
| lockUserNo | Number | 锁用户编号 |
|
||
| lockId | Number | 锁 ID |
|
||
| keyId | Number | 钥匙 ID |
|
||
| adminPwd | String | 管理密码 |
|
||
| bluetooth | Bluetooth | 蓝牙信息 |
|
||
| lockConfig | LockConfig | 锁配置信息 |
|
||
|
||
## Bluetooth 蓝牙信息
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|---------------------|-----------------|---------|
|
||
| bluetoothDeviceId | String | 蓝牙设备 ID |
|
||
| bluetoothDeviceName | String | 蓝牙设备名称 |
|
||
| publicKey | Array.\<Number> | 公钥 |
|
||
| privateKey | Array.\<Number> | 私钥 |
|
||
| signKey | Array.\<Number> | 签名密钥 |
|
||
|
||
## LockConfig 锁配置信息
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|-------------------------|--------|------------|
|
||
| vendor | String | 厂商 |
|
||
| product | Number | 产品号 |
|
||
| model | String | 型号 |
|
||
| fwVersion | String | 固件版本 |
|
||
| hwVersion | String | 硬件版本 |
|
||
| serialNum0 | String | 序列号 0 |
|
||
| serialNum1 | String | 序列号 1 |
|
||
| btDeviceName | String | 蓝牙设备名称 |
|
||
| electricQuantity | Number | 电量 |
|
||
| electricQuantityStandby | Number | 备用电量 |
|
||
| restoreCount | Number | 重置次数 |
|
||
| restoreDate | Number | 重置日期（时间戳秒） |
|
||
| icPartNo | String | 芯片型号 |
|
||
| indate | Number | 入网日期（时间戳秒） |
|
||
| mac | String | MAC 地址 |
|
||
| timezoneOffset | Number | 时区偏移（秒） |
|
||
|
||
# 初始化
|
||
|
||
## 初始化星云
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 初始化星云
|
||
*/
|
||
plugin.init(params)
|
||
```
|
||
|
||
2. 入参
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|--------------|---------|-------------|
|
||
| clientId | String | 客户端Id |
|
||
| clientSecret | String | 客户端密码 |
|
||
| env | String | 环境(SKY,XHJ) |
|
||
| isReportLog | Boolean | 是否上报日志 |
|
||
|
||
3. 返回
|
||
无
|
||
|
||
# 用户
|
||
|
||
## 注册
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 注册
|
||
* @returns Result
|
||
*/
|
||
const result = await plugin.register()
|
||
```
|
||
|
||
2. 入参
|
||
无
|
||
|
||
3. 返回
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|----------|--------|-------|
|
||
| username | String | 用户名 |
|
||
| password | String | 密码 |
|
||
| uid | Number | 用户uid |
|
||
|
||
## 退出登录
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 退出登录
|
||
* @param params
|
||
* @param {int} params.uid 用户uid
|
||
* @returns Result
|
||
*/
|
||
const result = await plugin.logout(params)
|
||
```
|
||
|
||
2. 入参
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|-----|--------|-------|
|
||
| uid | Number | 用户uid |
|
||
|
||
3. 返回
|
||
无
|
||
|
||
# 设备
|
||
|
||
## 搜索设备
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 搜索蓝牙设备
|
||
* @returns Result
|
||
*/
|
||
plugin.searchDevice(callback)
|
||
const callback = async result => {
|
||
if (result.code === Result.Success.code) {
|
||
this.setData({
|
||
list: result.data.list
|
||
})
|
||
}
|
||
}
|
||
```
|
||
|
||
2. 入参
|
||
callback 回调方法
|
||
|
||
3. 返回
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|----------------------|------------------|--------------------------------------|
|
||
| deviceId | String | 蓝牙设备 id |
|
||
| RSSI | Number | 当前蓝牙设备的信号强度，单位 dBm |
|
||
| connectable | Boolean | 当前蓝牙设备是否可连接（ Android 8.0 以下不支持返回该值 ） |
|
||
| advertisData | ArrayBuffer | 当前蓝牙设备的广播数据段中的 ManufacturerData 数据段 |
|
||
| advertisServiceUUIDs | Array.\<string\> | 当前蓝牙设备的广播数据段中的 ServiceUUIDs 数据段 |
|
||
| localName | String | 当前蓝牙设备的广播数据段中的 LocalName 数据段 |
|
||
| name | String | 蓝牙设备名称，某些设备可能没有 |
|
||
|
||
## 停止搜索设备
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 停止搜索
|
||
* @returns Result
|
||
*/
|
||
const result = await stopSearchDevice()
|
||
```
|
||
|
||
2. 入参
|
||
无
|
||
|
||
3. 返回
|
||
无
|
||
|
||
## 绑定设备
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 绑定设备
|
||
* @param params
|
||
* @param {AccountInfo} params.accountInfo 账号信息
|
||
* @param {String} params.name 设备名称
|
||
* @returns Result
|
||
*/
|
||
const result = await plugin.bindDevice(params)
|
||
if (result.code === Result.Success.code) {
|
||
this.setData({
|
||
lock: result.data.lock
|
||
})
|
||
}
|
||
```
|
||
|
||
2. 入参
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|-------------|-------------|------|
|
||
| accountInfo | AccountInfo | 账号信息 |
|
||
| name | String | 设备名称 |
|
||
|
||
3. 返回
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|------|----------|-----|
|
||
| lock | LockInfo | 锁信息 |
|
||
|
||
# 锁基本功能
|
||
|
||
## 选择锁(对锁进行操作前调用)
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 选择锁
|
||
* @param params
|
||
* @param {AccountInfo} params.accountInfo 账号信息
|
||
* @param {Number} params.lockId 锁ID
|
||
* @returns Result
|
||
*/
|
||
const result = await plugin.selectLock(params)
|
||
```
|
||
|
||
2. 入参
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|-------------|-------------|------|
|
||
| accountInfo | AccountInfo | 账号信息 |
|
||
| lockId | Number | 锁ID |
|
||
|
||
3. 返回
|
||
无
|
||
|
||
## 开关门
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 开门
|
||
* @param params
|
||
* @param {AccountInfo} params.accountInfo 账号信息
|
||
* @param {String} params.type 开门方式 close: 关门 open: 开门
|
||
* @param {Boolean} params.disconnect 操作后是否断开连接
|
||
* @returns Result
|
||
*/
|
||
const result = await plugin.openDoor(params)
|
||
```
|
||
|
||
2. 入参
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|-------------|-------------|-----------|
|
||
| accountInfo | AccountInfo | 账号信息 |
|
||
| type | String | 开门方式 |
|
||
| disconnect | Boolean | 操作后是否断开连接 |
|
||
|
||
3. 返回
|
||
无
|
||
|
||
## 删除锁
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 删除锁
|
||
* @param params
|
||
* @param {AccountInfo} params.accountInfo 账号信息
|
||
* @returns Result
|
||
*/
|
||
const result = await plugin.deleteLock(params)
|
||
```
|
||
|
||
2. 入参
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|-------------|-------------|------|
|
||
| accountInfo | AccountInfo | 账号信息 |
|
||
|
||
3. 返回
|
||
无
|
||
|
||
## 获取锁支持功能
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 获取锁支持项
|
||
* @param params
|
||
* @param {AccountInfo} params.accountInfo 账号信息
|
||
* @param {Number} params.lockId 锁 Id
|
||
* @returns Result
|
||
*/
|
||
const result = await plugin.getLockSupportFeatures(params)
|
||
```
|
||
|
||
2. 入参
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|-------------|-------------|------|
|
||
| accountInfo | AccountInfo | 账号信息 |
|
||
| lockId | Number | 锁 Id |
|
||
|
||
3. 返回
|
||
|
||
以下所有功能字段0代表不支持，1代表支持
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|----------------------------|--------|----------------|
|
||
| password | Number | 是否支持密码 |
|
||
| icCard | Number | 是否支持 IC 卡 |
|
||
| fingerprint | Number | 是否支持指纹 |
|
||
| fingerVein | Number | 是否支持指静脉 |
|
||
| palmVein | Number | 是否支持掌静脉 |
|
||
| d3Face | Number | 是否支持 3D 人脸 |
|
||
| qrCode | Number | 是否支持二维码 |
|
||
| bluetoothRemoteControl | Number | 是否支持蓝牙遥控器 |
|
||
| wirelessKey | Number | 是否支持无线钥匙 |
|
||
| gatewayUnlock | Number | 是否支持网关开锁 |
|
||
| lockCommand | Number | 是否支持闭锁指令 |
|
||
| firmwareUpgrade | Number | 是否支持固件升级设置指令 |
|
||
| passwordIssue | Number | 是否支持密码下发 |
|
||
| cardIssue | Number | 是否支持卡片下发 |
|
||
| fingerprintIssue | Number | 是否支持指纹下发 |
|
||
| fingerVeinIssue | Number | 是否支持指静脉下发 |
|
||
| palmVeinIssue | Number | 是否支持掌静脉下发 |
|
||
| d3FaceIssue | Number | 是否支持 3D 人脸下发 |
|
||
| lockFreeze | Number | 是否支持冻结/解冻锁 |
|
||
| readAdminPassword | Number | 是否支持读取管理员密码 |
|
||
| passwordManagement | Number | 是否支持密码管理功能 |
|
||
| passwordWithDelete | Number | 是否支持密码带删除功能 |
|
||
| remoteUnlock | Number | 是否支持配置远程开锁 |
|
||
| autoLock | Number | 是否支持自动闭锁设置 |
|
||
| antiPrySwitch | Number | 是否支持防撬开关配置 |
|
||
| resetSwitch | Number | 是否支持重置键配置 |
|
||
| lockSwitch | Number | 是否支持反锁功能配置 |
|
||
| lockSound | Number | 是否支持语音提示管理 |
|
||
| languageSetting | Number | 是否支持语言设置 |
|
||
| realTimeClock | Number | 是否支持实时时钟 |
|
||
| wifi | Number | 是否支持 WIFI |
|
||
| videoIntercom | Number | 是否支持可视对讲 |
|
||
| cyclePassword | Number | 是否支持循环密码 |
|
||
| cycleFingerprintCard | Number | 是否支持循环指纹/卡 |
|
||
| doubleAuthentication | Number | 是否支持双重认证 |
|
||
| openDirection | Number | 是否支持开门方向设置 |
|
||
| proximitySensing | Number | 是否支持接近感应 |
|
||
| doorStatus | Number | 是否支持门磁状态 |
|
||
| wiredDoorMagnet | Number | 是否支持有线门磁 |
|
||
| wirelessDoorMagnet | Number | 是否支持无线门磁 |
|
||
| doorNotClosedAlarm | Number | 是否支持门未关报警 |
|
||
| unlockReminder | Number | 是否支持开锁提醒 |
|
||
| wirelessKeyboard | Number | 是否支持无线键盘 |
|
||
| lightingTime | Number | 是否支持照明灯时间配置 |
|
||
| passageMode | Number | 是否支持常开模式 |
|
||
| hotelLockCardSystem | Number | 是否支持酒店锁卡系统 |
|
||
| appUnlockOnline | Number | 是否支持 APP 开锁需联网 |
|
||
| bluetoothBroadcast | Number | 是否支持蓝牙广播 |
|
||
| attendance | Number | 是否支持考勤 |
|
||
| motorTorsion | Number | 是否支持电机扭力 |
|
||
| stayWarn | Number | 是否支持逗留警告 |
|
||
| abnormalWarn | Number | 是否支持异常警告 |
|
||
| isSupportIris | Number | 是否支持虹膜识别 |
|
||
| isSupportCatEye | Number | 是否支持猫眼 |
|
||
| deviceEnMultiLanguage | Number | 是否支持设备支持的多国语言 |
|
||
| isNoSupportedBlueBroadcast | Number | 是否不支持蓝牙广播 |
|
||
| isSupportAutoLight | Number | 是否支持自动亮屏 |
|
||
| isSupportBackupBattery | Number | 是否支持备用电池 |
|
||
| isSupportForcedOpen | Number | 是否支持胁迫开门 |
|
||
| isSupportOpen | Number | 是否支持开门器开锁 |
|
||
| isSupportPush | Number | 是否支持推送 |
|
||
| offlinePasswordEncryption | Number | 是否支持密码算法 |
|
||
| offlinePasswordNumMax | Number | 是否支持离线密码最大个数 |
|
||
|
||
# 密码
|
||
|
||
## 获取离线密码
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 获取离线密码
|
||
* @param {AccountInfo} params.accountInfo 账号信息
|
||
* @param {OfflinePassword} params.password 密码信息
|
||
* @returns Result
|
||
*/
|
||
const result = await plugin.getOfflinePassword(params)
|
||
```
|
||
|
||
2. 入参
|
||
|
||
OfflinePassword 密码信息
|
||
|
||
| 属性 | 类型 | 描述 |
|
||
|-----------------|--------|--------------------|
|
||
| lockId | Number | 锁 Id |
|
||
| keyboardPwdName | String | 密码名称 |
|
||
| keyboardPwdType | Number | 密码类型 |
|
||
| isCoerced | Number | 是否胁迫模式 1:胁迫 2:非胁迫 |
|
||
| startDate | Number | 开始日期时间戳(毫秒，永久默认为0) |
|
||
| endDate | Number | 结束日期时间戳(毫秒，永久默认为0) |
|
||
| hoursStart | Number | 开始时间（小时, 不需要时传0） |
|
||
| hoursEnd | Number | 结束时间（小时, 不需要时传0） |
|
||
|
||
keyboardPwdType 密码类型
|
||
| 状态 | 状态说明 |
|
||
|------|---------------|
|
||
| 1 | 单次 |
|
||
| 2 | 永久 |
|
||
| 3 | 限时 |
|
||
| 4 | 删除 |
|
||
| 5 | 周末循环 |
|
||
| 6 | 每日循环 |
|
||
| 7 | 工作日循环 |
|
||
| 8 | 周一循环 |
|
||
| 9 | 周二循环 |
|
||
| 10 | 周三循环 |
|
||
| 11 | 周四循环 |
|
||
| 12 | 周五循环 |
|
||
| 13 | 周六循环 |
|
||
| 14 | 周天循环 |
|
||
|
||
3. 返回
|
||
|
||
| 属性 | 类型 | 描述 |
|
||
|---------------|--------|----|
|
||
| keyboardPwd | Number | 密码 |
|
||
| keyboardPwdId | Number | 密码 |
|
||
|
||
## 修改超级管理员密码
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 修改管理员密码
|
||
* @param params
|
||
* @param {AccountInfo} params.accountInfo 账号信息
|
||
* @param {String} params.adminPwd 管理员密码
|
||
* @param {Boolean} params.disconnect 操作后是否断开连接
|
||
* @returns {Promise<Result>}
|
||
*/
|
||
const result = await plugin.updateAdminPassword(params)
|
||
```
|
||
|
||
2. 入参
|
||
|
||
| 属性 | 类型 | 描述 |
|
||
|-------------|-------------|-----------|
|
||
| accountInfo | AccountInfo | 账号信息 |
|
||
| adminPwd | String | 管理员密码 |
|
||
| disconnect | Boolean | 操作后是否断开连接 |
|
||
|
||
3. 返回
|
||
无
|
||
|
||
# 记录
|
||
|
||
## 同步开门记录
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 同步全部开门记录
|
||
* @param params
|
||
* @param {AccountInfo} params.accountInfo 账号信息
|
||
* @param {Boolean} params.disconnect 操作后是否断开连接
|
||
* @returns Result
|
||
*/
|
||
const result = await plugin.syncOpenDoorRecord()
|
||
```
|
||
|
||
2. 入参
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|-------------|-------------|-----------|
|
||
| accountInfo | AccountInfo | 账号信息 |
|
||
| disconnect | Boolean | 操作后是否断开连接 |
|
||
|
||
3. 返回
|
||
无
|
||
|
||
# 扩展功能操作（ic卡、指纹、人脸、遥控、掌静脉）
|
||
|
||
## 注册、修改、删除、 删除全部
|
||
|
||
**调用方法**
|
||
|
||
```javascript
|
||
const result = await plugin.registerExtendedProducts(params)
|
||
```
|
||
|
||
**入参**
|
||
|
||
| 参数名称 | 数据类型 | 必须 | 描述 | 说明 |
|
||
|-------------------|---------------|----|-----------|-----------------------------------------------------------------------------------------------------------------|
|
||
| type | String | Y | 功能类型 | ['card','fingerprint','face','remote','palmVein'] 其中一个 |
|
||
| keyId | String | Y | 钥匙 ID |
|
||
| uid | String | Y | 用户uid |
|
||
| userCountLimit | Number | Y | 使用次数限制 | 0xFFFF 表示不限次数 |
|
||
| operate | Number | Y | 操作类型 | 0: 注册, 1: 修改, 2: 删除, 3: 删除全部 |
|
||
| isAdmin | Number | Y | 是否管理员 | 1 表示是，0 表示否 |
|
||
| isForce | Number | Y | 是否胁迫 | 1 表示是，0 表示否 |
|
||
| isRound | Number | Y | 是否循环 | 1 表示是，0 表示否 |
|
||
| weekDays | Array<Number> | N | 循环周期 | 0 -- 6 置位分别代表周日 -- 周六；例如：循环星期一、星期二、星期四,对应为：[1，2，4] |
|
||
| startDate | Number | Y | 生效日期 | 时间戳，永久则填0 |
|
||
| endDate | Number | Y | 失效日期 | 时间戳，永久则填0 |
|
||
| startTime | String | N | 生效时间 | 例如：'00:00' |
|
||
| endTime | String | N | 失效时间 | 例如：'00:00' |
|
||
| cardId | Number | N | 卡片Id | 添加后由监听事件返回，仅当 type 为 'card' 且operate!=1 时需要 |
|
||
| cardNumber | Number | N | 卡片序号 | 仅当 type 为 'card' 时需要 |
|
||
| cardName | String | N | 卡片名称 | 仅当 type 为 'card' 时需要 |
|
||
| cardType | Number | N | 卡片类型 | 仅当 type 为 'card' 时需要，1:永久，2：期限，4:循环， |
|
||
| cardUserNo | Number | N | 卡UserNo | 仅当 type 为 'card' 时需要 （选填） |
|
||
| fingerprintId | Number | N | 指纹Id | 添加后由监听事件返回，仅当 type 为 'fingerprint' 且operate!=1 时需要 |
|
||
| fingerprintName | String | N | 指纹序号 | 仅当 type 为 'fingerprint' 时需要 |
|
||
| fingerprintNumber | Number | N | 指纹名称 | 仅当 type 为 'fingerprint' 时需要 |
|
||
| fingerprintType | Number | N | 指纹类型 | 仅当 type 为 'fingerprint' 时需要，1:永久，2：期限，3：单次，4:循环 |
|
||
| fingerprintUserNo | Number | N | 指纹UserNo | 仅当 type 为 'fingerprint' 时需要 （选填） |
|
||
| deleteType | Number | N | 删除方式 | 仅当 type 为 'fingerprint' 时需要 1:通过APP走蓝牙删除，必需先通过APP蓝牙删除后再调用该接口,2:通过网关或WiFi锁删除，如果是WiFi锁或有连接网关，则可以传2，直接调用该接口从锁里删除指纹 |
|
||
| faceId | Number | N | 人脸Id | 添加后由监听事件返回，仅当 type 为 'face' 且operate!=1 时需要 |
|
||
| faceName | String | N | 人脸序号 | 仅当 type 为 'face' 时需要 |
|
||
| faceNumber | Number | N | 人脸名称 | 仅当 type 为 'face' 时需要 |
|
||
| faceType | Number | N | 人脸类型 | 仅当 type 为 'face' 时需要，1:永久，2：期限，4:循环 |
|
||
| faceUserNo | Number | N | 人脸UserNo | 仅当 type 为 'face' 时需要 （选填） |
|
||
| palmVeinId | Number | N | 掌静脉Id | 添加后由监听事件返回，仅当 type 为 'palmVein' 且operate!=1 时需要 |
|
||
| palmVeinName | String | N | 掌静脉序号 | 仅当 type 为 'palmVein' 时需要 |
|
||
| palmVeinNumber | Number | N | 掌静脉名称 | 仅当 type 为 'palmVein' 时需要 |
|
||
| palmVeinType | Number | N | 掌静脉类型 | 仅当 type 为 'palmVein' 时需要，1:永久，2：期限，4:循环 |
|
||
| palmVeinUserNo | Number | N | 掌静脉UserNo | 仅当 type 为 'palmVein' 时需要 （选填） |
|
||
| remoteId | Number | N | 遥控Id | 添加后由监听事件返回，仅当 type 为 'remote' 且operate!=1 时需要 |
|
||
| remoteName | String | N | 遥控序号 | 仅当 type 为 'remote' 时需要 |
|
||
| remoteNumber | Number | N | 遥控名称 | 仅当 type 为 'remote' 时需要 |
|
||
| remoteType | Number | N | 遥控类型 | 仅当 type 为 'remote' 时需要，1:永久，2：期限，4:循环 |
|
||
| remoteUserNo | Number | N | 遥控UserNo | 仅当 type 为 'remote' 时需要 （选填） |
|
||
|
||
**返回**
|
||
> Result 统一返回结果格式
|
||
>
|
||
> 收到锁版提示后，将卡片放置读卡器
|
||
|
||
|
||
**监听相关事件**
|
||
|
||
| 事件名 | 描述 | 返回值示例 |
|
||
|----------------------------|---------|-------------------------------------------------------|
|
||
| registerCardConfirm | 卡片注册成功 | {cardNumber:1,cardId:1} |
|
||
| registerFingerprintProcess | 指纹注册进度 | {status: 0,process: 0}；**process总步数在上方统一`Result`中返回** |
|
||
| registerFingerprintConfirm | 指纹注册成功 | {fingerprintNumber:1,fingerprintId:1} |
|
||
| registerFaceProcess | 人脸注册进度 | {faceNumber:1,faceId:1} |
|
||
| registerFaceConfirm | 人脸注册成功 | {faceNumber:1,faceId:1} |
|
||
| registerPalmVeinConfirm | 掌静脉注册成功 | {palmVeinNumber:1,palmVeinId:1} |
|
||
| registerRemoteConfirm | 遥控注册成功 | {remoteNumber:1,remoteId:1} |
|
||
|
||
**监听事件示例**
|
||
|
||
```js
|
||
// 监听卡片注册成功事件
|
||
starEventOn('registerCardConfirm', async (data) => {
|
||
// TODO
|
||
});
|
||
// 监听指纹注册进度事件
|
||
starEventOn('registerFingerprintProcess', async (data) => {
|
||
// TODO
|
||
});
|
||
// 监听指纹注册成功事件
|
||
starEventOn('registerFingerprintConfirm', async (data) => {
|
||
// TODO
|
||
});
|
||
// 其他事件同理...
|
||
```
|
||
|
||
## 取消操作
|
||
|
||
**调用方法**
|
||
|
||
```javascript
|
||
await plugin.registerExtendedProductsCancel(params)
|
||
```
|
||
|
||
**入参**
|
||
|
||
| 参数名称 | 数据类型 | 必须 | 描述 | 说明 |
|
||
|-------|--------|----|-------|---------------------------------------------------|
|
||
| type | String | Y | 功能类型 | ['card','fingerprint','face','remote','palmVein'] |
|
||
| keyId | String | Y | 钥匙 ID |
|
||
| uid | String | Y | 用户uid |
|
||
|
||
**返回**
|
||
无
|
||
|
||
## 获取ic卡列表
|
||
|
||
**调用方法**
|
||
|
||
```javascript
|
||
const result = await plugin.getIcCardList(params)
|
||
```
|
||
|
||
**入参**
|
||
|
||
| 参数名称 | 数据类型 | 必须 | 描述 |
|
||
|----------|--------|----|-------|
|
||
| lockId | String | Y | 锁id | |
|
||
| pageNo | String | N | 页码 |
|
||
| pageSize | String | N | 每页显示数 |
|
||
|
||
**返回**
|
||
|
||
```json
|
||
{
|
||
"list": [],
|
||
"pageNo": 1,
|
||
"pageSize": 0,
|
||
"pages": 0,
|
||
"total": 0
|
||
}
|
||
```
|
||
|
||
## 获取指纹列表
|
||
|
||
**调用方法**
|
||
|
||
```javascript
|
||
const result = await plugin.getFingerprintList(params)
|
||
```
|
||
|
||
**入参**
|
||
|
||
| 参数名称 | 数据类型 | 必须 | 描述 |
|
||
|----------|--------|----|-------|
|
||
| lockId | String | Y | 锁id | |
|
||
| pageNo | String | N | 页码 |
|
||
| pageSize | String | N | 每页显示数 |
|
||
|
||
**返回**
|
||
|
||
```json
|
||
{
|
||
"list": [],
|
||
"pageNo": 1,
|
||
"pageSize": 0,
|
||
"pages": 0,
|
||
"total": 0
|
||
}
|
||
```
|
||
|
||
## 获取人脸列表
|
||
|
||
**调用方法**
|
||
|
||
```javascript
|
||
import {getFaceList} from 'star-cloud-web'
|
||
|
||
getFaceList(params)
|
||
```
|
||
|
||
**入参**
|
||
|
||
| 参数名称 | 数据类型 | 必须 | 描述 |
|
||
|----------|--------|----|-------|
|
||
| lockId | String | Y | 锁id | |
|
||
| pageNo | String | N | 页码 |
|
||
| pageSize | String | N | 每页显示数 |
|
||
|
||
**返回**
|
||
|
||
```json
|
||
{
|
||
"list": [],
|
||
"pageNo": 1,
|
||
"pageSize": 0,
|
||
"pages": 0,
|
||
"total": 0
|
||
}
|
||
```
|
||
|
||
## 获取掌静脉列表
|
||
|
||
**调用方法**
|
||
|
||
```javascript
|
||
import {getPalmVeinList} from 'star-cloud-web'
|
||
|
||
getPalmVeinList(params)
|
||
```
|
||
|
||
**入参**
|
||
|
||
| 参数名称 | 数据类型 | 必须 | 描述 |
|
||
|----------|--------|----|-------|
|
||
| lockId | String | Y | 锁id | |
|
||
| pageNo | String | N | 页码 |
|
||
| pageSize | String | N | 每页显示数 |
|
||
|
||
**返回**
|
||
|
||
```json
|
||
{
|
||
"list": [],
|
||
"pageNo": 1,
|
||
"pageSize": 0,
|
||
"pages": 0,
|
||
"total": 0
|
||
}
|
||
```
|
||
|
||
## 获取遥控列表
|
||
|
||
**调用方法**
|
||
|
||
```javascript
|
||
import {getRemoteList} from 'star-cloud-web'
|
||
|
||
getRemoteList(params)
|
||
```
|
||
|
||
**入参**
|
||
|
||
| 参数名称 | 数据类型 | 必须 | 描述 |
|
||
|----------|--------|----|-------|
|
||
| lockId | String | Y | 锁id | |
|
||
| pageNo | String | N | 页码 |
|
||
| pageSize | String | N | 每页显示数 |
|
||
|
||
**返回**
|
||
|
||
```json
|
||
{
|
||
"list": [],
|
||
"pageNo": 1,
|
||
"pageSize": 0,
|
||
"pages": 0,
|
||
"total": 0
|
||
}
|
||
```
|
||
# 其他
|
||
|
||
## 获取服务器时间
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 获取服务器时间
|
||
* @returns Result
|
||
*/
|
||
const result = await plugin.getServerTime()
|
||
```
|
||
|
||
2. 入参
|
||
无
|
||
|
||
3. 返回
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|------|--------|---------|
|
||
| date | Number | 时间戳（毫秒） |
|
||
|
||
## 移除坏锁
|
||
|
||
1. 调用方法
|
||
|
||
```javascript
|
||
/**
|
||
* 移除坏锁
|
||
* @param params
|
||
* @param {AccountInfo} params.accountInfo 账号信息
|
||
* @param {List[int]} params.lockIds 锁Id列表
|
||
* @returns Result
|
||
*/
|
||
const result = await plugin.removeBadLock(params)
|
||
```
|
||
|
||
2. 入参
|
||
|
||
| 名称 | 类型 | 描述 |
|
||
|-------------|------------------|-------|
|
||
| accountInfo | AccountInfo | 账号信息 |
|
||
| lockIds | Array.\<Nmuber\> | 锁Id列表 |
|
||
|
||
3. 返回
|
||
无
|