光源产品面板 DP 交互

本文介绍光源产品面板 DP（Data Point）交互时，面板下发和设备上报的相关 DP Code 和数据说明。

开关灯

在开关灯时，面板会等待上报后才做出反应。

操作	DP Code	数据	备注
面板下发	switch_led	开灯为：true 关灯为：false	-
设备上报	switch_led	开灯为：true 关灯为：false	-

切换到白光模式

切换到白光时，只会下发模式数据，不会下发白光亮度 DP 及色温 DP。

操作	DP Code	数据	备注
面板下发	work_mode	white	-
设备上报	work_mode	white	-

切换到彩光模式

切换到彩光时，只会下发模式数据，不会下发彩光 DP 数据。

操作	DP Code	数据	备注
面板下发	work_mode	colour	-
设备上报	work_mode	colour	-

切换到情景模式

切换到情景时，只会下发模式数据，不会下发情景 DP 数据。

操作	DP Code	数据	备注
面板下发	work_mode	scene	-
设备上报	work_mode	scene	-

切换到音乐模式

切换到情景时，只会下发模式数据。

操作	DP Code	数据	备注
面板下发	work_mode	scene	-
设备上报	work_mode	scene	-

调节白光亮度

可分为滑动调节和单击调节两种操作。

滑动调节

滑动调节在滑动过程中会以每 300ms 的间隔时间使用调节 DP 下发数据，滑动结束时下发亮度 DP。

• 滑动过程中时：

  操作	DP Code	数据	备注
  面板下发	control_data	例如 100000000000003e803e8	如果产品不支持色温时，色温值面板一般会下发 1000
  设备上报	-	-	不需要上报

• 滑动结束时：

  操作	DP Code	数据	备注
  面板下发	bright_value	例如 1000	-
  设备上报	bright_value	1000	-

单击调节

单击调节会直接下发亮度 DP。

操作	DP Code	数据	备注
面板下发	bright_value	例如 1000	-
设备上报	bright_value	1000	-

调节白光色温

可分为滑动调节和单击调节两种操作。

滑动调节

滑动调节在滑动过程中会以每 300ms 的间隔时间使用调节 DP 下发数据，滑动结束时下发色温 DP。

• 滑动过程中时：

  操作	DP Code	数据	备注
  面板下发	control_data	例如 100000000000003e803e8	-
  设备上报	-	-	不需要上报

• 滑动结束时：

  操作	DP Code	数据	备注
  面板下发	temp_value	例如 1000	-
  设备上报	temp_value	1000	-

单击调节

单击调节会直接下发色温 DP。

操作	DP Code	数据	备注
面板下发	temp_value	例如 1000	-
设备上报	temp_value	1000	-

调节彩光

彩光 DP 以 颜色模型 HSV 格式下发，可分别进行色度、饱和度、亮度三个分量的调节，每一个分量的调节可分为滑动调节和单击调节两种操作。

滑动调节

滑动调节在滑动过程中会以每 300ms 的间隔时间使用调节 DP 下发数据，滑动结束时下发彩光 DP。

• 滑动过程中时：

  操作	DP Code	数据	备注
  面板下发	control_data	例如 1000003e803e800000000	-
  设备上报	-	-	不需要上报

• 滑动结束时：

  操作	DP Code	数据	备注
  面板下发	colour_data	例如 000003e803e8	-
  设备上报	colour_data	000003e803e8	-

单击调节

单击调节会直接下发色温 DP。

操作	DP Code	数据	备注
面板下发	colour_data	例如 000003e803e8	-
设备上报	colour_data	000003e803e8	-

切换情景

当页面切换到场景列表页面时，可以进行切换情景操作。

操作	DP Code	数据	备注
面板下发	scene_data	例如 00323200000003e803e800000000	-
设备上报	scene_data	00323200000003e803e800000000	-

编辑情景

一般可支持用户编辑情景名称、调节模式、调节速度、修改颜色、添加颜色、删除颜色等操作。

在修改颜色时，面板会实时下发调节 DP 以使用户可以预览到灯光的效果，除此之外的其他操作会下发情景 DP，以使用户可以在编辑过程中就可以预览场景的效果。

修改颜色时

操作	DP Code	数据	备注
面板下发	control_data	例如 修改彩光 1000003e803e800000000 修改白光 100000000000003e803e8	-
设备上报	-	-	不需要上报

其他操作

操作	DP Code	数据	备注
面板下发	scene_data	例如 00323200000003e803e800000000	-
设备上报	scene_data	00323200000003e803e800000000	-

音乐功能

当面板切换到音乐模式后，有些面板可能会直接打开麦克风，而有些面板会需要用户单击 开始按钮 打开麦克风。在打开麦克风后，当手机接收到有声源输入，则 App 会将声音转为颜色后，下发给设备。

操作	DP Code	数据	备注
面板下发	music_data	例如 彩光 1000003e803e800000000 白光 100000000000003e803e8	-
设备上报	-	-	不需要上报

倒计时功能

倒计时功能的作用为在倒计时结束时将灯的开关状态取反。

面板在下发倒计时后，为了保证面板数据与设备同步，一般不会进行倒计时效果处理，设备需要每 30 秒上报一次倒计时数据。

如果在倒计时过程中，设备的开关状态被取反了，则此时设备需要结束倒计时，并上报 0 数值，以使面板展示结束倒计时。

倒计时设定

操作	DP Code	数据	备注
面板下发	countdown	例如 240	-
设备上报	countdown	240	-

倒计时过程中设备上报

操作	DP Code	数据	备注
设备上报	countdown	210	-

倒计时过程中开关灯

操作	DP Code	数据	备注
设备上报	countdown_data	0	-
设备上报	switch_led	true 或 false	-