概述

物模型是ThingsKit物联网平台为产品定义的数据模型，用于描述产品的功能。本文介绍物模型相关概念和使用限制。

功能说明

物模型是物理空间中的实体（如传感器、车载装置、楼宇、工厂等）在云端的数字化表示，从属性、服务和事件三个维度，分别描述了该实体是什么、能做什么、可以对外提供哪些信息。定义了物模型的这三个维度，即完成了产品功能的定义。

功能类型	描述
属性	用于描述设备运行时具体信息和状态。
例如，环境监测设备所读取的当前环境温度、智能灯开关状态、电风扇风力等级等。
属性可分为读写和只读两种类型。读写类型支持读取和设置属性值，只读类型仅支持读取属性值。
服务	指设备可供外部调用的指令或方法。服务调用中可设置输入和输出参数。输入参数是服务执行时的参数，输出参数是服务执行后的结果。
相比于属性，服务可通过一条指令实现更复杂的业务逻辑，例如执行某项特定的任务。
服务分为异步和同步两种调用方式。
事件	设备运行时，主动上报给云端的信息，一般包含需要被外部感知和处理的信息、告警和故障。事件中可包含多个输出参数。
例如，某项任务完成后的通知信息；设备发生故障时的温度、时间信息；设备告警时的运行状态等。
事件可以被订阅和推送。

物模型数据格式说明

产品里面新增物模型时，选择不同的功能（属性、服务、事件），属性对应不同的数据格式。
物模型数据格式查看.gif

属性数据格式	数据格式说明
int32（整数型）

物模型属性显示为整数类型（可定义范围）
|
| double（双精度浮点型） |
物模型属性显示为double 如：12.16（可定义范围）
|
| bool（布尔型） |
适用于开关，定义为0和1
|
| text（字符串） |
字符串数据格式（可定义范围）
|
| struct（结构体） |
结构体里面还有json对象数据格式如：{"jiegou":{"json":126}}
|

物模型导出

点击物模型TSL，选择属性、服务、事件，进行单独导出，也可选择导出全部（属性、服务、事件）物模型。
:::info
? 提示
导出为Json格式文件，可以文件编辑器打开自行修改数据。
:::
物模型导出.gif

物模型查看

进入物模型管理，对物模型数据进行查看具体数据和功能。
物模型查看.gif

物模型搜索

根据物模型功能类型：属性、服务、事件，功能名称/标识符进行搜索。
物模型查看.gif

编辑物模型

新增属性

进入产品物模型管理，点击编辑物模型，点击新增物模型，新增属性功能。
:::info
? 提示
物模型新增后必须点击发布上线才能生效。
属性物模型功能是显示设备接收的数据。
新增属性选择读写时，可以在设备物模型数据点击属性下发。
:::
物模型新增属性.gif

属性数据格式	数据格式说明
int32（整数型）

物模型属性显示为整数类型（可定义范围）
|
| double（双精度浮点型） |
物模型属性显示为double 如：12.16（可定义范围）
|
| bool（布尔型） |
适用于开关，定义为0和1
|
| text（字符串） |
字符串数据格式（可定义范围）
|
| struct（结构体） |
结构体里面还有json对象数据格式如：{"jiegou":{"json":126}}
|

新增服务

进入产品物模型管理，点击编辑物模型，点击新增物模型，新增服务功能。
:::info
? 提示
物模型新增后必须点击发布上线才能生效。
调用方式异步为单向下发命令，同步为双向下发命令。
服务功能适用于看板管理（仅TCP类型设备），场景联动执行动作中设备输出选择服务下发到设备。
:::
物模型新增服务.gif