在鸿云文档

Appearance

配置物模型(功能定义) ​

在产品列表中，单击某个产品，进入产品详情页面，切换Tab页到->功能定义。 如下图。

此时看到的是已发布的产品功能定义，如需操作功能定义，需要先撤销发布产品。如下图。

编辑物模型 ​

点击->编辑草稿，进入物模型编辑页面。如下图。

  • 所属模块： 设备管理平台支持为产品定义多组功能（属性、命令和事件）。一组功能定义的集合，就是一个物模型模块。
  • 默认模块： 设备管理平台已提供默认模块，不能删除。
  • 物模型TSL： 物模型TSL定义请看物模型TSL。

展示已有的功能列表。如下图。

点击->添加功能定义，弹出添加功能定义页面。如下图。

添加属性 ​

参数
描述
功能类型功能类型分为：属性、命令、事件。物模型。
功能名称属性的名称，例如：灯关状态。
标识符属性的唯一标识符，在产品中具有唯一性。即Tlink JSON格式中的key值，作为设备上报该属性数据的Key。例如：lightStatus。
注意： 只能输入英文字母符号、数字且第一位不能为数字。系统程序中使用的关键字也不能作为标识符：time、root、count等。
数据类型int32：32位整型。需定义取值范围、步长和单位符号。
float：单精度浮点型。需定义取值范围、步长和单位符号。
double：双精度浮点型。需定义取值范围、步长和单位符号。
enum：枚举型。定义枚举项的参数值和参数描述，例如：1表示加热模式、2表示制冷模式。
bool：布尔型。采用0或1来定义布尔值，例如：0表示关、1表示开。
text：字符串。需定义字符串的数据长度。
date：时间戳。格式为String类型的UTC时间戳，单位：毫秒。
struct：JSON对象。定义一个JSON结构体，新增JSON参数项，例如：定义灯的颜色是由Red、Green、Blue三个参数组成的结构体。不支持结构体嵌套。
array：数组。需声明数组内的元素类型、数组元素个数。元素类型可选择int32、float、double、text或struct，需确保同一个数组元素类型相同。
取值范围数据类型为int32、float、double时，可设置属性值的取值范围。
步长属性值变化的最小粒度。数据类型为int32、float、double时，可根据您的业务需要设置步长。例如：为温度计产品定义温度属性时，将数据类型设置为int32，步长为2，单位为℃，取值范围0~100。即温度每变化两度，设备上报温度值，例如：0℃、2℃、4℃、6℃、8℃等。
单位单位可选择为无，或根据实际情况选择。
读写类型读写：请求读写的方法支持（获取）和（设置）。
只读：请求只读的方法仅支持（获取）。
描述输入文字，对该功能进行说明或备注。

添加命令 ​

点击->添加功能定义，弹出添加功能定义页面。切换页签->命令。如下图。

参数
描述
功能类型功能类型分为：属性、命令、事件。物模型。
功能名称命令的名称，例如：操作灯光状态。
标识符命令的唯一标识符，在产品中具有唯一性。即Tlink JSON格式中命令的Topic值，作为下发命令给设备的标识。例如：setLight。 则topic：tlink/${productKey}/${deviceName}/command/setLight/exec
注意： 支持英文、数字和下划线（_），不超过50个字符。 第一位不能为数字。系统程序中使用的关键字不能作为标识符：set、get、post、property、event、time、value等。
调用方式异步：服务为异步调用时，云端执行调用后直接返回结果，不会等待设备的回复消息。
同步：服务为同步调用时，云端会等待设备回复；若设备没有回复，则调用超时。
输入参数可选。 设置该命令的入参，单击增加参数，在弹窗对话框中添加命令入参。
输出参数可选。 设置该命令的出参，单击增加参数，在弹窗对话框中添加命令出参。
描述输入文字，对该功能进行说明或备注。

添加事件 ​

点击->添加功能定义，弹出添加功能定义页面。切换页签->事件。如下图。

参数
描述
功能类型功能类型分为：属性、命令、事件。物模型。
功能名称事件的名称，例如：温度过高报警。
标识符事件的唯一标识符，在产品中具有唯一性。即Tlink JSON格式中命令的Topic值，作为设备上报该事件的标识。例如：temperatureAlarm。 则topic：tlink/${productKey}/${deviceName}/event/temperatureAlarm/post
注意： 支持英文、数字和下划线（_），不超过50个字符。 第一位不能为数字。系统程序中使用的关键字不能作为标识符：set、get、post、property、event、time、value等。
输出参数可选。 该事件的出参。单击增加参数，在弹窗对话框中添加一个事件出参。您可以使用某个属性作为出参，也可以自定义参数。
事件类型事件类型分为：
信息
告警
故障
描述输入文字，对该功能进行说明或备注。

发布物模型 ​

物模型发布后，才会正式生效。

在功能定义页面，编辑草稿->点击->发布上线，。如下图。

发布上线成功后，会根据草稿生成一个版本号，版本按实际情况递增。