产品功能定义

定义产品功能

定义产品功能，是产品开发的第一步。 产品功能由3部分组合完成，包括标准功能、自定义功能及云功能。

标准功能

标准功能，是该类别下提供的常用功能。你可以直接选择启用，启用后可根据产品实际功能进行编辑。无用的功能可删除，删除后仍可再次启用。

需要注意的是，标准功能由于已与部分App界面组件绑定，因此标准功能不支持更改标识符、功能类型及数据传输类别。其他属性可编辑。

自定义功能

自定义功能：如果你的产品功能不在标准功能中，你可以自定义功能。 功能点是对产品功能的抽象表示，每种功能都可以通过不同功能类型定义。目前平台提供：布尔型、数值型、枚举型、故障型、字符串型、透传型这6种功能类型。

其中，布尔型、数值型、枚举型是基础类型，大部分功能都可通过这3种功能类型定义。故障型专门用于故障定义，便于故障在后台的统计。字符串型和透传型为高级类型，用于较复杂功能，只有当其他类型无法满足时，才推荐使用。

对于如何定义功能点，下文将有详细介绍。

云功能

目前支持的云功能包括云定时和网页跳转功能。

云定时功能，为涂鸦云包装的定时功能，包括设定开关时间及周循环，无需硬件嵌入式开发。 网页跳转功能，主要可用于设置产品购买的微商城、产品使用说明等各种页面。

目前，只有部分界面模板支持云功能，请设置时综合考虑。开启效果如下：

如何自定义功能点

功能点相关概念

功能点：即具体智能设备功能的抽象，用于描述产品功能及其参数。

功能点ID：功能点的编码，后续设备与云端的功能数据传输通过功能点ID进行。

功能点名称：自定义的功能名称

标识名：功能点code值，用于App显示功能名称的多语言管理。支持字母、数字、下划线，以字母开头。

数据类型：

• 布尔型（bool）：非真即假的二值型变量。如：开关功能，开/关
• 数值型（value）：适用于可线性调节类型的数据。如：温度调节，温度范围20-40℃
• 枚举型（enum）：自定义的有限集合值。如：工作档位，低档/中档/高档
• 故障型（fault）：专门用于上报和统计故障的功能点，支持多故障，数据只上报
• 字符串型（string）：以字符串形式传输的功能点。
• 透传型（raw）：以二进制形式透传的功能点。一般不建议使用，对于上述功能点无法满足的复杂功能可采用。

数据传输类型：

• 可下发可上报：指令数据可以下发给设备，设备数据可以上报给云端；
• 只上报：数据只支持从设备上报；
• 只下发：数据只支持从云端下发；

功能类型详解

布尔型

适用功能：非真即假的二值型变量功能。 功能范例：设备的开关、取暖器的童锁、电风扇的摇头、空气净化器的滤芯复位等功能，均可采用布尔型表示。

数值型

适用功能：适用于可线性调节类型的数据。

功能案例：

• 温度调节，温度范围20-40，间距为1，单位为℃，表达含义为该产品可调节温度20-40℃，每操作一次变化1℃。
• 如预约功能，可预约1、2、3……12小时开关机，则可设置数值范围为：1-12，间距：1，单位：小时。

枚举型

适用功能：该功能下有有限的自定义值集合。

功能案例：

• 档位，低档/中档/高档；
• 模式：舒适模式、睡眠模式、智能模式、节能模式；
• 颜色：红色、蓝色、绿色、黑色；

注意：编辑功能点时，枚举值支持字母、数字、下划线。按回车键后，枚举值自动生成。枚举值编码从0开始，与硬件联调中以枚举值编码进行传输。每个枚举值长度不超过15字符，最多支持定义10个枚举值。

枚举值每输入一个，需要回车一次，枚举值将确认生成。

故障型

适用功能：专门用于上报和统计故障的功能点，后续此类型功能将被用于统计。

功能案例：

• 温度传感器故障、电机故障、高温故障……

注意：故障型的数据格式为bitmap型，可支持多故障定义。故障型功能只支持数据上报，因此数据传输类型只可选择 只上报。

字符串型

适用功能：以字符串形式传输的功能点。如果以上4种功能类型不能满足产品功能定义，可约定通过字符串形式传输数据。

注意：字符串型最大长度不超过255字节。

透传型

适用功能：以二进制形式透传的功能点。一般不建议使用，对于上述功能点无法满足的复杂功能可采用。

注意：透传型最大长度不超过255字节。

目前每个产品，最多支持25个功能点。如果您的产品功能点数超过25个，可与涂鸦技术支持联系，为您寻找更好的解决方案。