门锁标准指令集和状态集

更新时间:2023-07-19 05:39:38下载pdf

门锁中,除了透传(Raw)类型之外的 DP(Data Point),例如设备状态上报 DP、开门记录 DP、告警记录 DP,需要通过订阅标准指令和状态集 DP,才能获取对应 DP 内容和参数值。

下发门锁通用能力控制

门锁通用能力下发控制一般通过标准指令实现,详情请参考 智能门锁标准指令集和状态集 和下文 获取设备详情 接口。

录入解锁方式结果推送

更多详情,请参考 门锁解锁方式录入

支持的门锁类型

  • Wi-Fi 门锁
  • Zigbee 门锁
  • 蓝牙门锁
  • Wi-Fi 门禁
  • 可视对讲门锁
  • 蓝牙配件
  • 保活 Wi-Fi 门锁

参数说明

参数名 类型 说明
bizCode String 事件类型码
devId String 设备 ID
uuid String 设备 UUID
bizData Object 解锁方式状态
ts Long 时间戳

bizCode

bizCode 说明
doorUnlockMethodStatus 门锁解锁方式状态

bizData

code 数据类型 说明
finish Boolean 是否完成录入
operate Integer 操作
  • 1:发起操作
  • 2:取消操作
raised Boolean 是否已发起
totalPeriod Integer 总录入次数(会单独且只会推送一次总录入次数)
period Integer 剩余录入次数
event String 事件:
  • unlockMethodEntry:录入解锁方式
  • unlockMethodDelete:删除解锁方式

数据格式

{
    "bizCode":"doorUnlockMethodStatus",
    "bizData":{
        "finish":false,
        "operate":1,
        "raised":true,
        "totalPeriod":2,
        "period":2,
        "event":"unlockMethodEntry"
    },
    "uuid":"xxxx",
    "devId":"xxxx"
}

获取设备详情

更多详情,请参考 设备控制 接口。

接口描述

可查询设备的详情信息,包括设备指令集和设备最新状态。

接口地址

GET /v1.0/devices/{device_id}

请求参数

参数名 类型 参数类型 必填 说明
device_id String URI 设备 ID

返回参数

参数名 类型 说明
code Integer 响应码,详见 错误码
success Boolean 判断请求是否成功。
  • true:成功
  • false:失败
msg String 请求失败返回的信息,成功则返回空值。
result Object<result> 返回结果。

result 说明

参数名 类型 说明
id String 设备编号
name String 设备名称
uid String 用户 ID
local_key String 密钥
category String 产品类别
product_id String 产品 ID
product_name String 产品名称
sub Boolean 判断是否为子设备
  • true:是
  • false:不是
uuid String 设备唯一标识
owner_id String 家庭 ID
online Boolean 设备在线状态
status Object<status> 设备功能状态
active_time Long 设备激活时间,时间戳,精确到秒
biz_type Long 应用 biztype
icon String 设备图标
ip String 设备 IP

status 说明

参数名 类型 说明
code String 功能点 Code
value String 功能点的值
type String 功能点的类型

请求示例

GET /v1.0/devices/vdevo153490924188132

SDK 示例

TuyaClient client = new TuyaClient(clientId, secret, RegionEnum.CN);
DeviceVo deviceVo = client.getDeviceInfo(DEV_ID);
System.out.println("获取设备信息: ");
System.out.println(JSONObject.toJSONString(deviceVo));

返回示例

{
    "success": true,
    "result": {
        "active_time": 1589505938,
        "biz_type": 299009,
        "category": "qt",
        "create_time": 1560827137,
        "icon": "smart/icon/15402589135gknz23xajb_0.png",
        "id": "60613135b121cddc294****",
        "ip": "120.198.****.****",
        "local_key": "3a9b50126fe473****",
        "name": "体脂秤",
        "online": true,
        "owner_id": "1070****",
        "product_id": "g0er6hSKgMqr****",
        "product_name": "Wifi scales_OEM",
        "status": [
            {
                "code": "weight",
                "value": "48900"
            },
            {
                "code": "left_hand_r",
                "value": "0"
            },
            {
                "code": "right_hand_r",
                "value": "0"
            },
            {
                "code": "left_leg_r",
                "value": "0"
            },
            {
                "code": "right_leg_r",
                "value": "0"
            },
            {
                "code": "body_r",
                "value": "653"
            },
            {
                "code": "battery_low",
                "value": "false"
            }
        ],
        "sub": false,
        "time_zone": "+08:00",
        "uid": "ay157896239864843g****",
        "update_time": 1589764585,
        "uuid": "60613135b23cddc294****"
    }
}

错误码

以下为该接口常见的业务异常,更多的异常错误,请参考 全局错误码

错误码 说明
500 系统错误
1106 权限非法