自定义功能

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

功能说明

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

前提条件

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

操作步骤

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

功能示例

布尔型

• 适用功能：非真即假的二值型变量功能。

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

  

数值型

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

  • 温度调节，温度范围 20-40，间距为 1，单位为 ℃，表达含义为该产品可调节温度 20-40℃，每操作一次变化 1℃。

  • 预约功能，可预约 1、2、3……12 小时开关机，则可设置数值范围为：1-12，间距：1，单位：小时。

    

枚举型

• 适用功能：该功能下存在有限的自定义值集合。枚举值每输入一个，需要回车一次，枚举值将确认生成。

• 功能示例：

  • 档位：低档，中档和高档。
  • 模式：舒适模式、睡眠模式、智能模式和节能模式。
  • 颜色：红色、蓝色、绿色、黑色。
  编辑功能时，枚举值支持小写拉丁字母、数字和下划线。按回车键后，枚举值自动生成。枚举值编码从 0 开始，在硬件联调中以枚举值编码进行传输。每个枚举值长度不超过 15 字符，最多支持定义 30 个枚举值。

  

故障型

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

• 功能示例：温度传感器故障、电机故障和高温故障等。

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

  

字符串型

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

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

  

透传型

• 适用功能：以二进制形式透传的功能。一般不建议使用。针对其他功能类型无法满足的复杂功能，可采用透传型数据。

• 注意事项：透传型数据的最大长度不超过 255 字节。

  

下一步

完成自定义功能设置后，您可以考虑：

• 添加 高级功能。
• 设置 设备交互 样式。

常见问题

更多详情，请参考 自定义功能常见问题。