射灯（sxd）标准指令集

射灯标准指令

标准指令	名称	取值类型	取值说明
switch_led	电源开关	Boolean	{}
work_mode	颜色模式	Enum	{“range”:[“white”, “colour”, “scene”, “music”]}
countdown	倒计时剩余时间	Integer	{“unit”:“s”, “min”:0, “max”:86400, “scale”:0, “step”:1}
temp_value	冷暖值	Integer	{“min”:0, “max”:1000, “scale”:0, “step”:1}
bright_value	亮度值	Integer	{“min”:10, “max”:1000, “scale”:0, “step”:1}
music_data	音乐灯	JSON	{}
scene_data	场景	JSON	{}
colour_data	彩光	JSON	{}
control_data	调节	JSON	{}

标准指令示例

switch_led

表示射灯电源的开关。

取值说明

• true：打开射灯电源开关
• false：关闭射灯电源开关

代码示例

{
	"commands":[
		{
			"code":"switch_led",
			"value":true
		}
	]
}

work_mode

设置射灯预定义的颜色模式。注意，不同的产品可能支持不同的模式设置。

取值说明

• white：白色
• colour：彩色
• scene：预定义颜色
• music：预定义颜色

代码示例

{
	"commands":[
		{
			"code":"work_mode",
			"value":"white"
		}
	]
}

bright_value

调节射灯亮度。

取值说明

参考取值范围为 10~1000。具体每个产品的取值范围不同，您需要以查询到的设备属性为准。

代码示例

{
	"commands":[
		{
			"code":"bright_value",
			"value":990
		}
	]
}

temp_value

调节射灯色温（即冷暖度）。

取值说明

参考取值范围为 0~1000。

代码示例

{
	"commands":[
		{
			"code":"temp_value",
			"value":990
		}
	]
}

colour_data

以 HSV（Hue Saturation Value）的形式控制射灯的颜色变化。

取值说明

• h：0~360
• s：0~1000
• v：0~1000

代码示例

{
	"commands":[
		{
			"code":"colour_data",
			"value":{
				"h":201,
				"s":511,
				"v":899
			}
		}
	]
}

scene_data

一种自定义的形式控制灯具的颜色变化，部分灯具产品支持这种控制。

取值说明

• scene_num：情景号，取值范围为 1~256
• unit_change_mode：单元变化模式
  • static：静态
  • jump：跳变
  • gradient：渐变
• unit_switch_duration：各个情景单元间切换时间，取值范围为 0~100
• unit_gradient_duration：情景单元从上个状态切换到目标状态的渐变速度，取值范围为 0~100
• bright：亮度，取值范围为 0~1000
• temperature：色温，取值范围为 0~1000
• h：0~360
• s：0~1000
• v：0~1000

代码示例

{
	"commands":[
		{
			"code":"scene_data_v2",
			"value":{
				"scene_num":5,
				"scene_units":[
					{
						"unit_change_mode":"static",
						"unit_switch_duration":20,
						"unit_gradient_duration":20,
						"h":201,
						"s":611,
						"v":999,
						"bright":500,
						"temperature":800
					}
				]
			}
		}
	]
}

music_data

一种自定义形式控制射灯的颜色变化，部分产品支持这种控制。

取值说明

• change_mode：变色方式
  • direct：直接输出
  • gradient：渐变
• bright：亮度，取值范围为 0~1000
• temperature：色温，取值范围为 0~1000
• h：0~360
• s：0~1000
• v：0~1000

代码示例

{
	"commands":[
		{
			"code":"music_data",
			"value":{
				"change_mode":"direct",
				"bright":500,
				"temperature":800,
				"h":201,
				"s":611,
				"v":999
			}
		}
	]
}

control_data

一种自定义形式控制射灯的颜色变化，部分产品支持这种控制。

取值说明

• change_mode：变色方式
  • direct：直接输出
  • gradient：渐变
• bright：亮度，取值范围为 0~1000
• temperature：色温，取值范围为 0~1000
• h：0~360
• s：0~1000
• v：0~1000

代码示例

{
	"commands":[
		{
			"code":"control_data",
			"value":{
				"change_mode":"direct",
				"bright":500,
				"temperature":800,
				"h":201,
				"s":611,
				"v":999
			}
		}
	]
}

countdown

倒计时设置，控制射灯的开关功能。

取值说明

• 取值范围：0~86400
• 单位：秒（s）

代码示例

{
	"commands":[
		{
			"code":"countdown",
			"value":1200
		}
	]
}