Profile定义

更新时间：2022-02-21 GMT+08:00

查看PDF

概述

产品模型（也称Profile）用于描述设备具备的能力和特性。开发者通过定义Profile，在物联网平台构建一款设备的抽象模型，使平台理解该款设备支持的服务、属性、命令等信息。

点击放大

定义Profile

在产品创建时：如果选择使用系统模板，则系统将会自动使用相应的Profile模板，开发者可以直接使用或在此基础上进行修改；如果选择自定义产品模板，则需要完整定义Profile，操作如下：

在“产品开发”界面选择产品，选择具体产品，进入该产品的开发空间。
在产品开发空间，点击“Profile定义”，然后点击“新建服务”。
在“新建服务”区域，对服务名称、属性和命令进行定义。每个服务下，可以包含属性和命令，也可以只包含其中之一，请根据此类设备的实际情况进行配置。
1. 填写“服务名称”，“服务名称”采用首字母大写的命名方式，比如：WaterMeter、Battery。
2. 点击“新增属性”，在弹出窗口中配置属性的各项参数，点击“确定”。“属性名称”采用第一个单词首字母小写，其余单词的首字母大写的命名方式，比如batteryLevel、internalTemperature；其余参数，请根据此类设备的实际情况进行配置。
  “数据类型”的配置可参考如下原则：
  - int：当上报的数据为整数或布尔值时，可以配置为此类型。
  - decimal：当上报的数据为小数时，可以配置为此类型。
  - string：当上报的数据为字符串、枚举值或布尔值时，可以配置为此类型。如果为枚举值或布尔值，值之间需要用英文逗号（“,”）分隔。
  - DateTime：当上报的数据为日期时，可以配置为此类型。
  - jsonObject：当上报的数据为json结构体时，可以配置为此类型。
3. 点击“添加命令”，在弹出窗口中配置“命令名称”，点击“确定”。“命令名称”采用所有字母大写，单词间用下划线连接的命名方式，比如DISCOVERY，CHANGE_STATUS。
4. 点击“添加下发字段”，在弹出窗口中配置下发命令字段的各项参数，点击“确定”。“命令字段名称”采用第一个单词首字母小写，其余单词的首字母大写的命名方式，比如value；其余参数，请根据此类设备的实际情况进行配置。
5. 点击“添加响应字段”，在弹出窗口中配置响应命令字段的各项参数，点击“确定”。“响应字段名称”采用第一个单词首字母小写，其余单词的首字母大写的命名方式，比如result；其余参数，请根据此类设备的实际情况进行配置。
  响应字段非必配参数，当需要设备返回命令执行结果时，才需要定义此字段。