通用-情景

功能介绍

  • 情景能力作为智能照明中一个非常重要的部分,可以丰富灯光玩法,实现灯的各种效果,分为标准情景和客户自定义两种情景模式。

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设置项A1比特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设置项B1比特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设置项C1比特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情景号2scene_id数值最大值:255 最小值:0 步距:1 倍数:0情景号:0~255 0x00 - 0xff
2单元切换间隔时间2transition_interval数值最大值:100 最小值:0 步距:1 倍数:0单元切换间隔时间:0 - 100,0X00 - 0X64
3单元变化时间2duration数值最大值:100 最小值:0 步距:1 倍数:0单元变化时间:0 - 100,0X00 - 0X64
4单元变化模式2change_mode枚举静态:0 跳变:1 渐变:2
5色度(H)4H数值最大值:360 最小值:0 步距:1 倍数:0色度:0~360,0X0000 - 0X0168
6饱和度(S)4S数值最大值:1000 最小值:0 步距:1 倍数:0饱和度:0~1000, 0X0000 - 0X03E8
7明度(V)4V数值最大值:1000 最小值:0 步距:1 倍数:0明度:0~1000,0X0000 - 0X03E8
8白光亮度4B数值最大值:1000 最小值:0 步距:1 倍数:0白光亮度:0~1000,0X0000 - 0X03E8
9色温值4T数值最大值:1000 最小值:0 步距:1 倍数:0色温值:0~1000,0X0000-0X03E8

如何开发

  • 根据 UI 交互进行 DP 的监听上报与下发

  • 更进一步的,我们在 Tuya MiniApp IDE 上提供了扩展插件来辅助开发,点击 扩展管理 后可以看到 面板 IDE 照明情景库扩展, 下载后按照扩展上的说明方法使用即可。

注意事项

  • 自定义情景个数限制:
    • 由于嵌入式内存空间有限,一般情况下运行添加的自定义个数是有限制的,一般不超过10个

相关物料

  • 【功能页】:无
  • 【组件】:无
  • 【教程】:无
  • 【API】: