# 功能定义

创建产品后，需要将产品的功能及特性转换为数字化模型（物模型），在系统中统一管理，这种产品的数字化模型包含属性、服务、事件三个部分，说明如下：

功能类型	类型说明
属性	用于描述设备各方面的状态，属性值可在云端读取和设置。如温度、湿度、开关等。
服务	用于描述设备可以实现的复杂业务逻辑，可定义多个供云端调用的参数和返回参数，使设备可以执行复杂的任务。如空调设置多个定时开关和温度等。
事件	用于描述设备运行时上传给云端的事件，可定义多个输出参数，分为信息、告警、故障三种类型。如空调运行发生故障等。

# 操作步骤

进入项目的产品列表
选择相应产品，单击查看。

选择功能定义，单击添加功能。

输入功能信息。
- 功能类型：选择功能类型。
- 功能名称：功能的名称，同类型功能的名称在产品内具有唯一性，不能重复。支持中文、英文、日文、数字、中英文括号、其他字符（_、-、@、/、\）的组合，长度不超过 30 个字符。
- 标识符：功能的标识符，对于产品具有唯一性，不能重复。支持英文、数字、下划线（_）的组合，长度不超过 50 个字符。不能使用的系统保留字：set、get、post、time、value。
配置功能参数。
1. 属性：
  - 数据类型：选择属性值的数据类型。点此查看功能参数说明
  - 读写类型：云端对属性值的读写权限类型，有如下 2 种类型：
    - 读写：云端可以查询、修改属性值
    - 只读：云端可以查询属性值
2. 服务：
  - 调用方式：云端对服务的调用方式，有如下 2 种类型：
    - 异步：云端调用服务后直接返回结果（暂只支持异步调用方式）
    - 同步：云端调用服务后等待设备回复，设备在规定时间内返回结果，否则调用超时
  - 参数输入：定义服务的输入参数，每个服务不超过 20 个输入参数。点此查看功能参数说明 (opens new window)
  - 参数输出：定义服务的输出参数，每个服务不超过 20 个输出参数。点此查看功能参数说明 (opens new window)
3. 事件：
  - 事件类型：定选择事件的类型，有如下 3 种类型：
    - 信息：设备主动上报的普通信息
    - 告警：设备发生异常状况时上报的信息
    - 故障：设备出现故障时主动上报的信息
  - 参数输出：定义事件的输出参数，每个服务不超过 50 个输出参数。点此查看功能参数说明 (opens new window)
输入功能描述。
- 描述：功能做简要描述，长度不超过 100 个字符。
单击确定即可添加功能。

# 功能参数说明

数据类型	字段信息	描述	示例
int（整数型）、 float（单精度浮点型）、double（双精度浮点型）	取值范围（最小值）、取值范围（最大值）	定义属性值的取值范围	温度最小值：0 温度最大值：100
	步长	定义属性值变化的步长	2
	单位	选择属性的单位	无
enum （枚举型）	枚举项	定义属性的多个枚举项编号及其描述	0~煮饭 1~煲汤 2~蒸鱼 ……
bool （布尔型）	布尔值	定义非 0 即 1 的布尔值	0~开 1~关
text （字符串）	数据长度	定义字符串最大长度，单位为字节	设备型号长度不超过 2048 个字节
date （时间型）	时间格式	时间格式统一为 String 类型的 UTC 时间戳（毫秒）	无
struct （JSON 对象）	JSON 对象	可新增 JSON 参数项	无
array （数组型）	元素类型	若数据类型为 array，可根据业务需要定义数组的元素类型，有如下 5 种类型： --int：整数型 --float：单精度浮点型 --double：双精度浮点型 --text：字符串 --struct：JSON 对象	无
array （数组型）	元素个数	定义数组的元素个数	5

← 创建产品发布产品 →