zy上云api


物模型

<h1>概述</h1> <p>物模型指将物理空间中的实体数字化,并在云端构建该实体的数据模型。在物联网平台中,定义物模型即定义产品功能,完成功能定义后,系统将自动生成该产品的物模型。</p> <p>物模型TSL(Thing Specification Language)是一个JSON格式的文件。它是物理空间中的实体,如无人机、相机、机场等在云端的数字化表示,从属性、服务和事件三个维度,分别描述了该实体是什么、能做什么、可以对外提供哪些信息。定义了这三个维度,即完成了产品功能的定义。</p> <p>物模型将产品功能类型分为三类:属性、服务和事件。定义了这三类功能,即完成了物模型的定义。</p> <table> <thead> <tr> <th><strong>功能类型</strong></th> <th><strong>说明</strong></th> </tr> </thead> <tbody> <tr> <td><strong>属性 (Property)</strong></td> <td>一般用于描述设备运行时的状态,如飞机姿态、电池电量、相机模式等。属性支持 <code>Get</code> 和 <code>Set</code> 请求方式,应用系统可发起对属性的读取和设置请求。</td> </tr> <tr> <td><strong>服务 (Service)</strong></td> <td>设备可被外部调用的能力和方法,可设置输入参数和输出参数。相比于属性,服务可以通过一条指令实现更复杂的业务逻辑。<code>Service</code> 无需设置 <code>Set</code> 或 <code>Get</code> 某个 <code>Property</code> 的内容。</td> </tr> <tr> <td><strong>事件 (Event)</strong></td> <td>设备运行时的事件。事件一般包含需要被外部感知和处理的通知信息,可包含多个输出参数。如飞机靠近禁飞区、设备发生故障等事件。事件一般会被额外的系统订阅,用于告警或后续的处理动作。</td> </tr> </tbody> </table> <h1>物模型文件规范</h1> <p>任何一个产品的物模型文件均由四部分组成。</p>

页面列表

ITEM_HTML