什么是物模型

物模型是设备平台为产品定义的数据模型，用于描述产品的功能并基于物模型进行统一数据交互的协议规范。本文主要介绍物模型相关概念，方便您快速了解。

核心价值点

• 解放端侧人力，更专注端侧业务逻辑实现 / 能力打造：通过设备端只需要对通信协议进行统一的封装和抽象，即可通过统一标准的协议去描述设备属性，使设备端应用程序研发能更加注重业务逻辑的实现而非通信协议的制定。
• 易于实现多场景的设备控制，而无需入侵设备代码：接入大模型、米家等只需要进行云云对接，无需侵入设备代码。
• 易于监控与数据分析：物模型采用结构化的数据上报至云端，云端会记录属性的历史数据，变更数据一目了然，还能基于物模型定义快速生成可视化图表。

应用场景示例

功能说明

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

物模型TSL

设备平台通过定义一种物的描述JSON文件来描述产品的功能，称为TSL（Thing Specification Language），物模型TSL文件格式为JSON，相关字段说明请参见 物模型TSL字段说明。

常见问题

1. 与设备影子有什么区别？

设备影子后续不推荐使用。

• 具备 设备上行/下行消息 的数据格式校验能力。使用物模型通讯协议前，必须为产品定义物模型，在通讯时才能校验通过。一方面，可以有效避免因为数据格式错误导致的异常（例如：①上报了新的状态，但应用层UI 无法展示 / 显示异常，② 由于应用传递了错误参数，导致设备运行异常）另一方面，通过物模型定义才能使设备上报的数据能够被其他应用程序进行自动解析和处理，实现数据的读取、控制和监测。
• 具备 事件上报、行为（服务）调用的能力，设备影子则不具备。
• 具备 事件记录、行为调用 数据记录的能力，可以用于统计类似每个事件上报次数、行为的调用次数等，单纯依靠MQTT Broker 则不具备这个能力。
• 云端可以基于物模型对统一对一个产品下的一批设备进行批量设置、批量的行为调用，设备影子则不具备此能力。