OneNET Studio 简介 产品介绍 快速入门 设备接入与管理 应用开发
应用开发流程 新建项目 添加设备 设备分组 场景联动 应用数据流转 应用API 应用长连接 规则引擎(新)
运维监控 数据可视化 边缘计算 人工智能AI 位置定位 语音通话 工业互联网标识 权限管理 服务协议 更新日志

设备期望属性值

1. 属性期望值流程

2. 属性期望值获取

3. 属性期望值清除


1. 属性期望值流程

在平台设置属性期望值后,平台更新属性期望值,若设备在线,将实时异步更新设备属性状态;若设备离线,期望值属性值将缓存在平台,待设备上线后,设备可主动获取属性期望值,设备业务处理后,并选择是否上报属性最新状态;


图1 属性期望值流程

2. 属性期望值获取

  • 请求topic: $sys/{pid}/{device-name}/thing/property/desired/get

OneJSON数据格式:

{
    "id" : "123",
    "version":"1.0",
    "params" : [
        "power",
        "temperature"
    ]
}

表:请求参数描述

参数 类型 描述
id String 消息id号,用户自定义,String类型的数字,长度限制13位。
version String 物模型版本号,可选字段,不填默认为1.0
params JsonObject 获取属性期望的标识符列表
  • 响应topic:$sys/{pid}/{device-name}/thing/property/desired/get/reply

OneJSON数据格式:

{
    "id":"123",
    "code":200,
    "msg":"xxxx"
    "data":{
        "power": {
            "value": "on",
            "version": 2
        }
    }
}

表:响应参数描述

参数 类型 描述
Id String 消息id号,用户自定义,String类型的数字,长度限制13位。
code Integer 结果状态码
msg String 错误信息
data Object 1.返回的期望值信息。若未在云端设置过该属性的期望值,或期望值属性被清空,返回对象中不包含该属性的标识符。key:属性标识符value:期望值version:当前期望属性值的版本。首次设置属性期望值后,版本为1。以后每次设置,版本号自增;清空期望值再设置期望值,版本号重新从1开始2.如果状态未成功,msg为携带的错误信息

3. 属性期望值清除

  • 请求topic:$sys/{pid}/{device-name}/thing/property/desired/delete

OneJSON数据格式:

{
    "id": "123",
    "version": "1.0",
    "params": {
        "power": {
            "version": 1
        },
        "temperature": { }
    }  
}

表:请求参数描述

参数 类型 描述
id String 消息id号,用户自定义,String类型的数字,长度限制13位。
version String 物模型版本号,可选字段,不填默认为1.0
params JsonObject 要清除期望的属性信息列表。key:标识符version:要删除期望属性的版本号。如果指定为1,标识平台最新版本是1时执行清除。如果指定版本为1,但平台最新版本是大于1,则忽略这个清除请求。若请求中,未指定要清除的期望值版本version,则不验证版本号,直接清除期望值。
  • 响应topic:$sys/{pid}/{device-name}/thing/property/desired/delete/reply

OneJSON数据格式:

{
    "id":"123",
    "code":200,
    "msg":"xxxx"
}

表:响应参数描述

参数 类型 描述
id String 消息id号,用户自定义,String类型的数字,长度限制13位。
code Integer 结果状态码
msg String 错误信息

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “