## General-Scene

### Function Introduction
- Scene capability is a very important part of intelligent lighting. It can enrich the lighting gameplay and realize various lighting effects. It is divided into two scene modes: standard scene and customer-defined scene.
### DP protocol
- dpCode: dreamlight_scene_mode Details (applicable to fantasy scene)

| Serial number | Name | Length | Type | Attribute | Remarks |
| --- |--- | --- | --- | --- | --- |
|1| Version number | 1 | Value | 0-25 5| Default 1|
|2| Scene mode number | 1 | Value | 0-255 | None|
|3| Transformation mode | 1 | Value | 0-255 | None|
|4| Unit switching interval time | 1 | Value | 0-100 | None|
|5| Unit change time | 1 | Value | 0-100 | None|
|6| Setting item A | 1 | Bit| Bit0: Reserved flag: null10: Reserved 1: Reserved Bit1: Reserved flag: null20: Reserved 1: Reserved Bit2: Extension flag: extra10: Mode 1: Mode Bit3: Extension flag: extra20: Mode 1: Mode Bit4: Direction flag: direction0: Clockwise 1: Counterclockwise Bit5: Reserved flag: null30: Reserved 1: Reserved Bit6: Reserved flag: null40: Reserved 1: Reserved Bit7: Segment flag: segment0: Full segment 1: Segmented |None|
|7|Setting item B| 1 |Bit| Bit0: Reserved flag: null50: Reserved 1: ReservedBit1: Reserved flag: null60: Reserved 1: ReservedBit2: Reserved flag: null70: Reserved 1: ReservedBit3: Reserved flag: null80: Reserved 1: ReservedBit4: Reserved flag: null90: Reserved 1: ReservedBit5: Reserved flag: null100: Reserved 1: ReservedBit6: Reserved flag: null110: Reserved 1: ReservedBit7: Reserved flag: null120: Reserved 1: Reserved |None|
|8|Setting item C| 1 |Bit| Bit0: Reserved flag: null50: Reserved 1: ReservedBit1: Reserved flag: null60: Reserved 1: ReservedBit2: Reserved flag: null70: Reserved 1: ReservedBit3: Reserved flag: null80: Reserved 1: ReservedBit4: Reserved flag: null90: Reserved 1: ReservedBit5: Reserved flag: null100: Reserved 1: ReservedBit6: Reserved flag: null110: Reserved 1: ReservedBit7: Reserved flag: null120: Reserved 1: Reserved |None|
|9|Brightness| 1 |Value| 0-100 |None|
|10|Chroma| 2 |Value| 0-360 |None|
|11|Saturation| 1 |Value| 0-100 |None|

- General dpCode scene_data protocol details

|Serial number| Name|Number of characters| Flag| Data type| Field attribute| Field description|
| --- |--- | --- | --- | --- | --- | ---|
|1 | Scene ID| 2| scene_id| Value | Maximum value: 255 Minimum value: 0 Step: 1 Multiple: 0 | Scene ID: 0~255 0x00 - 0xff |
|2 | Unit switching interval | 2| transition_interval | Value | Maximum value: 100 Minimum value: 0 Step: 1 Multiple: 0 | Unit switching interval: 0 - 100, 0X00 - 0X64|
|3 | Unit change time | 2| duration | Value | Maximum value: 100 Minimum value: 0 Step: 1 Multiple: 0 | Unit change time: 0 - 100, 0X00 - 0X64|
|4 | Unit change mode | 2 | change_mode | Enumeration | Static: 0 Jump: 1 Gradient: 2|
| 5 | Hue (H) | 4 | H | Value | Maximum: 360 Minimum: 0 Step: 1 Multiple: 0 | Hue: 0~360, 0X0000 - 0X0168 |
|6 | Saturation (S) | 4 | S | Value | Maximum: 1000 Minimum: 0 Step: 1 Multiple: 0 | Saturation: 0~1000, 0X0000 - 0X03E8 |
|7 | Brightness (V) | 4 | V | Value | Maximum: 1000 Minimum: 0 Step: 1 Multiple: 0 | Brightness: 0~1000, 0X0000 - 0X03E8 |
|8 | White light brightness | 4 | B | Value | Maximum: 1000 Minimum: 0 Step: 1 Multiple: 0 | White light brightness: 0~1000, 0X0000 - 0X03E8 |
| 9 | Color temperature value | 4| T| Value | Maximum value: 1000 Minimum value: 0 Step: 1 Multiple: 0 | Color temperature value: 0~1000, 0X0000-0X03E8 |

### How to develop
- Monitor and report DP according to UI interaction
- [Specific monitoring and reporting examples](/en/miniapp/solution-panel/ability#device-function-point-management)

- Furthermore, we provide extension plug-ins on Tuya MiniApp IDE to assist development. Click `Extension Management` to see `Panel IDE Lighting Scenario Library Extension`. After downloading, follow the instructions on the extension to use it.

### Notes
- Limitation on the number of custom scenarios:
- Due to the limited embedded memory space, the number of custom scenarios added during operation is generally limited, usually not exceeding 10

### Related materials
- [Function page]: 
  - None
- [Component]: 
  - None
- [Tutorial]: 
  - None
- [API]:
  - [Online scenario library](/en/miniapp/solution-ai/ability/lamp-solution/lamp/ability-set/cloud#%E7%85%A7%E6%98%8E%E6%83%85%E6%99%AF%E5%BA%93)