---
title: 通用-白光
summary: 亮度与色温调节，支持一路、二路白光，含 bright_value、temp_value DP 协议及组件说明。
---

## 通用-白光

### 功能介绍
#### 亮度值
  - 亮度调节默认有渐变效果，从1%亮度调节到100%亮度渐变时间为800ms。
  - 亮度调节范围：1%-100%，面板下发的值的范围：10-1000，亮度调节范围和面板下发的值为线性对应关系。
  - 免开发平台上，白光亮度最大值默认为100%，白光亮度最小值默认为10%，支持自主设置。白光亮度最小值建议不要设置低于10%，避免存在调节到最低亮度灯熄灭的情况发生。
  - 亮度转换[公式](/cn/miniapp/solution-panel/ability/common/utils/number#%E8%BD%AC%E6%8D%A2%E6%95%B0%E5%80%BC)。

#### 冷暖值
  - 球泡灯常见色温范围为：2700K-6500K，色温越高，对应的颜色越冷。
  - 色温调节范围：0%-100%，面板下发的值的范围：0-1000，色温调节范围和面板下发的值为线性对应关系。

#### 彩光支持路数
  - [一路](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/quick-start/base)
  - [二路](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/quick-start/base)

### DP 协议
| DP code    | DP 含义 | DP 类型 | 备注 |
| -------- | ------- |------- |------- |
| bright_value  | 亮度值    | 数值（value）范围（10-1000） |  |
| temp_value  | 冷暖值    | 数值（value）范围（0-1000） |  |

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

### 注意事项
- 暂无
### 相关物料
- 【功能页】：无
- 【组件】：
  1. [常规触摸滑动条](https://developer.tuya.com/material/library_oHEKLjj0/component?code=ComponentsTyLamp&subCode=LampTouchSlider)
  2. [常规百分比滑动条](https://developer.tuya.com/material/library_oHEKLjj0/component?code=ComponentsTyLamp&subCode=LampPercentSlider)
  3. [竖向触摸滑动条](https://developer.tuya.com/material/library_oHEKLjj0/component?code=ComponentsTyLamp&subCode=LampVerticalTouchSlider)
  4. [竖向百分比滑动条](https://developer.tuya.com/material/library_oHEKLjj0/component?code=ComponentsTyLamp&subCode=LampVerticalPercentSlider)
  5. [常规亮度滑动条](https://developer.tuya.com/material/library_oHEKLjj0/component?code=ComponentsTyLamp&subCode=LampBrightSlider)
  6. [色温滑动条](https://developer.tuya.com/material/library_oHEKLjj0/component?code=ComponentsTyLamp&subCode=LampTempSlider)
  7. [矩形色温色盘](https://developer.tuya.com/material/library_oHEKLjj0/component?code=ComponentsTyLamp&subCode=LampRectWhitePicker)
  8. [圆形色温色盘](https://developer.tuya.com/material/library_oHEKLjj0/component?code=ComponentsTyLamp&subCode=LampCirclePickerWhite)
- 【教程】：无
- 【API】：无