---
title: 通用-彩光
summary: 彩光 HSV 颜色模型与 DP 协议，含 control_data、colour_data 及三路/四路/五路支持说明。
---

## 通用-彩光

### 功能介绍
- 涂鸦彩光 DP 色值采用 [HSV 颜色模型](https://baike.baidu.com/item/HSV%E9%A2%9C%E8%89%B2%E6%A8%A1%E5%9E%8B/21501482)，通过面板下发 HSV 模型颜色对应的字符串值。
  - 1、色调（H）
    色调调节范围：0-360，面板下发的值的范围0-360，色环调节范围和面板下发的值为线性对应关系。
  - 2、饱和度（S）
    饱和度调节范围：0%-100%，面板下发的值的范围0-1000，色环调节范围和面板下发的值为线性对应关系。
  - 3、明度（V）
    明度调节范围：1%-100%，面板下发的值的范围10-1000，色环调节范围和面板下发的值为线性对应关系。
- 彩光支持展示：
  - [三路](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/quick-start/base)
  - [四路](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/quick-start/base)
  - [五路](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/quick-start/base)

### DP 协议

- 实时下发 DP: control_data (**具体设备是否可用参考[设备通信协议](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/protocols)**)

|序号 |名称 | 字符数 | 标识 |数据类型 | 字段属性 |字段说明|
| ----|---- | ------- |---|---- |---|---- |
|1|变化方式|1|change_mode|枚举|跳变：0,渐变：1| |
|2|色度|4|H|数值|最大值：360 最小值：0 步距：1 倍数：0| 色度：0 - 360，0X0000 - 0X0168|
|3|饱和度|4|S|数值|最大值：1000 最小值：0 步距：1 倍数：0| 饱和度：0 - 1000, 0X0000 - 0X03E8|
|4|明度|4|V|数值|最大值：1000 最小值：0 步距：1 倍数：0|明度：0 - 1000，0X0000 - 0X03E8|
|5|白光亮度|4|B|数值|最大值：1000 最小值：0 步距：1 倍数：0| 白光亮度：0 - 1000 0X0000 - 0X03E8|
|6|色温值|4|T|数值|最大值：1000 最小值：0 步距：1 倍数：0| 色温值：0 - 1000，0X0000 - 0X03E8|

- 彩光 DP: [colour_data](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/dp-parser/ColourTransformer) 

|序号 |名称 | 字符数 | 标识 |数据类型 | 字段属性 |字段说明|
| ----|---- | ------- |---|---- |---|---- |
|1|色度|4|H|数值|最大值：360 最小值：0 步距：1 倍数：0| 色度：0 - 360，0X0000 - 0X0168|
|2|饱和度|4|S|数值|最大值：1000 最小值：0 步距：1 倍数：0| 饱和度：0 - 1000, 0X0000 - 0X03E8|
|3|明度|4|V|数值|最大值：1000 最小值：0 步距：1 倍数：0|明度：0 - 1000，0X0000 - 0X03E8|

### 如何开发
- 根据 UI 交互进行 DP 的监听上报与下发
  - [具体监听与下发示例](/cn/miniapp/solution-panel/ability#dp-上报监听)

### 注意事项
- 协议问题：
  - Sig Mesh
    - 不支持 dpCode "control_data" 实时下发
    - 不推荐存在涂抹交互方式，操作快的话很容易丢包，可以考虑点选交互方式，
    - 如果是涂抹完后，改变颜色再进行下发的交互的话也是可以的
    - 原则是：不能短时间内进行大量 DP 数据的下发
  - Beacon
    - 由于 Beacon DP 数据只下发不会上报，所以相关数据需要存储到云端，以保证状态的同步性

### 相关物料
- 【功能页】：无
- 【组件】：
  1. [触摸滑动条](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/component#%E9%80%9A%E7%94%A8%E7%85%A7%E6%98%8E%E8%A7%A6%E6%91%B8%E6%BB%91%E5%8A%A8%E6%9D%A1)
  2. [照明基础滑动条](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/component#%E9%80%9A%E7%94%A8%E7%99%BE%E5%88%86%E6%AF%94%E6%BB%91%E5%8A%A8%E6%9D%A1)
  3. [圆形彩光色盘](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/component#%E9%80%9A%E7%94%A8%E5%9C%86%E5%BD%A2%E5%BD%A9%E5%85%89%E8%89%B2%E7%9B%98)
  4. [环形彩光色盘](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/component#%E9%80%9A%E7%94%A8%E7%8E%AF%E5%BD%A2%E5%BD%A9%E5%85%89%E8%89%B2%E7%9B%98)
  5. [明矩形色盘组件照](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/component#%E9%80%9A%E7%94%A8%E6%98%8E%E7%9F%A9%E5%BD%A2%E8%89%B2%E7%9B%98%E7%BB%84%E4%BB%B6%E7%85%A7)
  6. [照明彩色圆形色块环](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/component#%E9%80%9A%E7%94%A8%E7%85%A7%E6%98%8E%E5%BD%A9%E8%89%B2%E5%9C%86%E5%BD%A2%E8%89%B2%E5%9D%97%E7%8E%AF)
  7. [照明彩光色卡](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/component#%E9%80%9A%E7%94%A8%E7%85%A7%E6%98%8E%E5%BD%A9%E5%85%89%E8%89%B2%E5%8D%A1)
  8. [照明色彩收藏组件](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/component#%E9%80%9A%E7%94%A8%E7%85%A7%E6%98%8E%E8%89%B2%E5%BD%A9%E6%94%B6%E8%97%8F%E7%BB%84%E4%BB%B6)
- 【教程】：无
- 【SDK】：无
- 【API】：无