自定义功能

更新时间：2023-08-02 09:37:12下载pdf

产品功能是具体智能设备功能的抽象，用于描述产品功能及参数。如果您需要的产品功能不在标准功能中时，您可以自定义功能。

功能说明

添加自定义功能时，您需要考虑功能点、功能点 ID、功能点名称、标识名、数据类型、数据传输类型等属性。更多详情，请参考产品功能。
为产品稳定性考虑，建议您的每个产品的标准功能点和自定义功能点累计不超过 40 个。若超过，请注意产品稳定性测试。
每种功能都可以通过不同数据类型定义，涂鸦支持布尔型、数值型、枚举型、故障型、字符串型、透传型这 6 种数据类型。
- 布尔型、数值型和枚举型是基础类型，大部分功能可通过这 3 种数据类型定义。
- 故障型专门用于故障定义，便于在后台统计故障。
- 字符串型和透传型用于较复杂功能，只有当其他类型无法满足需求时，才推荐使用。
极速免开发产品不支持添加自定义功能。
自定义功能支持在嵌入式开发过程中，针对 DP（Data Point）进行特殊配置，您可以按需选择。具体规则如下：
- 被动上报：如果不是主动上报，必须下发指令才能上报，防止上报过于频繁。
- 重复上报：表示该 DP 支持重复上报相同值。
- DP 路由：用来控制蜂窝网络和蓝牙双协议模组的 DP 选择的接入协议。支持以下三种模式：
  - 不设置：优先选择蜂窝网络，当蜂窝网络断开后，选择蓝牙协议。
  - 蓝牙优先：优先选择蓝牙，当蓝牙未连接时，选择蜂窝网络。
  - 强制蓝牙：强制选择蓝牙，当蓝牙未连接时，面板需要有错误提示。
- 无需上云：针对配置类型 DP，嵌入式 SDK 在配网时读取配置项，SDK 可以仅上报给 App 而无需上报到云端。

前提条件

您已经创建了至少一款产品。详细步骤，请参考创建产品。

操作步骤

登录涂鸦 IoT 开发平台。
在产品列表中，找到一款开发中的产品。
查看产品的 自定义功能，按照需求，您可以：
- 单击 添加功能 新增自定义功能。
- 单击删除删除指定自定义功能。
- 单击编辑编辑指定自定义功能。

功能示例

布尔型

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

数值型

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

枚举型

适用功能：该功能下存在有限的自定义值集合。枚举值每输入一个，需要回车一次，枚举值将确认生成。
功能示例：
- 档位：低档，中档和高档。
- 模式：舒适模式、睡眠模式、智能模式和节能模式。
- 颜色：红色、蓝色、绿色、黑色。
编辑功能时，枚举值支持小写拉丁字母、数字和下划线。按回车键后，枚举值自动生成。枚举值编码从 0 开始，在硬件联调中以枚举值编码进行传输。每个枚举值长度不超过 15 字符，最多支持定义 10 个枚举值。