Instruction Set-sxd

Standard instructions of spotlight

Code	Name	Type	Description
switch_led	Power switch	Boolean	{}
work_mode	Color mode	Enum	{"range":["white", "colour", "scene", "music"]}
countdown	Remaining time of countdown	Integer	{"unit":"s", "min":0, "max":86400, "scale":0, "step":1}
temp_value	Color temperature value	Integer	{"min":0, "max":1000, "scale":0, "step":1}
bright_value	Brightness value	Integer	{"min":10, "max":1000, "scale":0, "step":1}
music_data	Music light	JSON	{}
scene_data	Scene	JSON	{}
colour_data	Colored light	JSON	{}
control_data	Dimming	JSON	{}

Examples of standard instructions

switch_led

It indicates the power switch of a spotlight.

Description

• true: power on a spotlight.
• false: power off a spotlight.

Sample code

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

work_mode

Set the predefined color mode of a spotlight. The color mode varies depending on the products.

Description

• white: white light.
• colour: colored light.
• scene: predefined color.
• music: predefined color.

Sample code

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

bright_value

Adjust the brightness of a spotlight.

Description

The reference value ranges from 10 to 1000. The specific value range of each product is different, subject to the queried device attributes.

Sample code

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

temp_value

Adjust the color temperature (cool and warm value) of a spotlight.

Description

The reference value ranges from 0 to 1000.

Sample code

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

colour_data

Control the color changes of a spotlight based on the HSV (hue, saturation, value) color model.

Description

• Hue (h): 0 to 360
• Saturation (s): 0 to 1000
• Value (v): 0 to 1000

Sample code

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

scene_data

Control the color change of the light in a customized way. This control mode applies to some lights.

Description

• scene_num: the number of scene modes. Valid values: 1 to 256.
• unit_change_mode: the change mode of a light unit.
  • static: The light unit is in static mode and the color remains unchanged.
  • jump: The light unit is in jump mode and the color is suddenly changed.
  • gradient: The color is gradually changed.
• unit_switch_duration: The switching duration of a light unit. Valid values: 0 to 100.
• unit_gradient_duration: The gradient duration for a light unit to change from the previous status to the target status. Valid values: 0 to 100.
• bright: The brightness. Valid values: 0 to 1000.
• temperature: The color temperature. Valid values: 0 to 1000.
• Hue (h): 0 to 360.
• Saturation (s): 0 to 1000.
• Value (v): 0 to 1000.

Sample code

{
    "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

Control the color change of a spotlight in a customized way. This control mode applies to some lights.

Description

• change_mode: The color change mode.
  • direct: The color is changed immediately after the input.
  • gradient: The color is gradually changed.
• bright: The brightness. Valid values: 0 to 1000.
• temperature: The color temperature. Valid values: 0 to 1000.
• Hue (h): 0 to 360.
• Saturation (s): 0 to 1000.
• Value (v): 0 to 1000.

Sample code

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

control_data

Control the color change of a spotlight in a customized way. This control mode applies to some lights.

Description

• change_mode: The color change mode.
  • direct: The color is changed immediately after the input.
  • gradient: The color is gradually changed.
• bright: The brightness. Valid values: 0 to 1000.
• temperature: The color temperature. Valid values: 0 to 1000.
• Hue (h): 0 to 360.
• Saturation (s): 0 to 1000.
• Value (v): 0 to 1000.

Sample code

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

countdown

Countdown setting. Control the switch of a spotlight.

Description

• Value range: 0 to 86400.
• Unit: seconds (s).

Sample code

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