标准事物定义

标准事物定义

通过提供统一和开放的常用事物描述模板，既可以减少设备功能定义工作量，又可以提高产品可交互性。

用户在创建产品时，可以选择使用标准的事物描述，或者在自定义事物描述使用标准的属性或操作等。

关于如何自定义事物描述请参考设备管理后台界面。

标准事物描述

https://{domain-name}/v2/device/schema/list

标准事物描述模板 (schema) 定义了一些常见的标准类型的设备，并详细描述了其基本属性，操作和事件。

用户在开发和添加新产品前，可以指定其标准模式的名称，这样新创建的设备就包含这个标准模式的属性，操作和事件。

使用标准模式可以大大减少用户重复定义产品能力描述的时间，还可以促进物联网设备接口的标准化。

例如:

{
    "@context": "https://iot.domain-name.org/schemas",
    "@type": "OnOffSwitch",
    "id": "OnOffSwitch",
    "name": "On/Off Switch",
    "description": "On/Off 开关示例",
    "properties": {
        "temperature": {
            "@type": "temperature"
        }
    },
    "actions": {
        "setOn": {
            "@type": "setOn"
        }
    },
    "events": {
        "overheated": {
            "@type": "overheated"
        }
    }
}

上述文档描述了一个标准设备 OnOffSwitch 开关，它包含一个标准属性 temperature, 一个标准操作 setOn 以及一个标准事件 overheated

标准属性模板

https://{domain-name}/v2/device/schema/property/list

标准属性定义了标准模式 (schema) 包含的属性的描述

如温湿度等:

{
    "temperature": {
        "title": "Temperature",
        "type": "number",
        "unit": "°C"
    },
    "humidity": {
        "title": "Humidity",
        "type": "number",
        "unit": "%RH",
        "minimum": 0,
        "maximum": 100
    }
}

标准操作模板

https://{domain-name}/v2/device/schema/actions/list

标准操作定义了标准模式 (schema) 包含的操作的描述

例如:

{
    "setOff": {},
    "setOn": {},
}

标准事件模板

https://{domain-name}/v2/device/schema/events/list

标准事件定义了标准模式 (schema) 包含的事件的描述

例如:

{
    "overheated": {
        "type": "number",
        "unit": "degree celcius"
    }
}

常见单位

本节定义了常用的标准数据单位类型

未分类

能量

温度

容量

质量比

电容

电流

电压

时间

速度

功率

电气

压力

重量

体积

面积

长度

经纬度