射灯（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
        }
    ]
}