--- title: 通用-情景 summary: 标准情景与自定义情景模式，含 dreamlight_scene_mode、scene_data 等 DP 协议说明。 --- ## 通用-情景 ### 功能介绍 - 情景能力作为智能照明中一个非常重要的部分，可以丰富灯光玩法，实现灯的各种效果，分为标准情景和客户自定义两种情景模式。 ### DP 协议 - dpCode: dreamlight_scene_mode 详情 (适用于幻彩情景) | 序号 | 名称 | 长度 | 类型 | 属性 | 备注 | | --- |--- | --- | --- | --- | --- | |1| 版本号 | 1 |数值| 0-25 5|默认1| |2| 情景模式编号 | 1 |数值| 0-255 |无| |3|变换方式| 1 |数值|0-255|无| |4|单元切换间隔时间| 1 |数值| 0-100 |无| |5|单元变化时间| 1 |数值| 0-100 |无| |6|设置项A| 1 |比特| Bit0：预留标识：null10：预留1：预留Bit1：预留标识：null20：预留1：预留Bit2：拓展标识：extra10：模式1：模式Bit3：拓展标识：extra20：模式1：模式Bit4：方向标识：direction0：顺时针1：逆时针Bit5：预留标识：null30：预留1：预留Bit6：预留标识：null40：预留1：预留Bit7：段落标识：segment0：全段1：分段 |无| |7|设置项B| 1 |比特| Bit0：预留标识：null50：预留1：预留Bit1：预留标识：null60：预留1：预留Bit2：预留标识：null70：预留1：预留Bit3：预留标识：null80：预留1：预留Bit4：预留标识：null90：预留1：预留Bit5：预留标识：null100：预留1：预留Bit6：预留标识：null110：预留1：预留Bit7：预留标识：null120：预留1：预留 |无| |8|设置项C| 1 |比特| Bit0：预留标识：null50：预留1：预留Bit1：预留标识：null60：预留1：预留Bit2：预留标识：null70：预留1：预留Bit3：预留标识：null80：预留1：预留Bit4：预留标识：null90：预留1：预留Bit5：预留标识：null100：预留1：预留Bit6：预留标识：null110：预留1：预留Bit7：预留标识：null120：预留1：预留 |无| |9|亮度| 1 |数值| 0-100 |无| |10|色度| 2 |数值| 0-360 |无| |11|饱和度| 1 |数值| 0-100 |无| - 常规 dpCode scene_data 协议详情 |序号| 名称|字符数| 标识| 数据类型| 字段属性| 字段说明| | --- |--- | --- | --- | --- | --- | ---| |1 | 情景号| 2| scene_id| 数值 | 最大值：255 最小值：0 步距：1 倍数：0 | 情景号：0~255 0x00 - 0xff | |2 | 单元切换间隔时间 | 2| transition_interval | 数值 | 最大值：100 最小值：0 步距：1 倍数：0 | 单元切换间隔时间：0 - 100，0X00 - 0X64| |3 | 单元变化时间 | 2| duration | 数值 | 最大值：100 最小值：0 步距：1 倍数：0| 单元变化时间：0 - 100，0X00 - 0X64| |4 |单元变化模式 | 2 | change_mode | 枚举 | 静态：0 跳变：1 渐变：2| | 5 |色度（H）| 4| H | 数值 | 最大值：360 最小值：0 步距：1 倍数：0 | 色度：0~360，0X0000 - 0X0168 | |6 | 饱和度（S）| 4| S |数值 | 最大值：1000 最小值：0 步距：1 倍数：0 | 饱和度：0~1000, 0X0000 - 0X03E8 | |7 | 明度（V）| 4 | V | 数值| 最大值：1000 最小值：0 步距：1 倍数：0 | 明度：0~1000，0X0000 - 0X03E8 | |8 | 白光亮度 | 4 | B | 数值 | 最大值：1000 最小值：0 步距：1 倍数：0 | 白光亮度：0~1000，0X0000 - 0X03E8 | | 9 | 色温值 | 4| T| 数值| 最大值：1000 最小值：0 步距：1 倍数：0 | 色温值：0~1000，0X0000-0X03E8 | ### 如何开发 - 根据 UI 交互进行 DP 的监听上报与下发 - [具体监听与下发示例](/cn/miniapp/solution-panel/ability#dp-上报监听) - 更进一步的，我们在 Tuya MiniApp IDE 上提供了扩展插件来辅助开发，点击 `扩展管理` 后可以看到 `面板 IDE 照明情景库扩展`, 下载后按照扩展上的说明方法使用即可。 ### 注意事项 - 自定义情景个数限制： - 由于嵌入式内存空间有限，一般情况下运行添加的自定义个数是有限制的，一般不超过10个 ### 相关物料 - 【功能页】：无 - 【组件】：无 - 【教程】：无 - 【API】： - [在线情景库](/cn/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)