射灯(sxd)标准状态集

更新时间:2024-09-20 06:30:14下载pdf

支持下发和上报的状态

Code 名称 取值类型 取值说明
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}
scene_data 场景 JSON {}
colour_data 彩光 JSON {}

标准状态示例

switch_led

该状态值表示灯具电源的开关。

取值说明

  • true:打开灯具电源开关
  • false:关闭灯具电源开关

代码示例

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

work_mode

该状态值能够设置射灯预定义的颜色模式。注意,不同的产品可能支持不同的模式设置。

取值说明

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

代码示例

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

bright_value

该状态值表示射灯亮度。

取值说明

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

代码示例

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

temp_value

该状态值表示射灯色温(即冷暖)。

取值说明

参考取值范围为 0~1000。

代码示例

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

colour_data

该状态值以 HSV(Hue Saturation Value)的形式控制射灯的颜色变化。

取值说明

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

代码示例

{
    "status":[
        {
            "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

代码示例

{
    "status":[
        {
            "code":"scene_data",
            "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}]}"
        }
    ]
}

countdown

该状态值表示倒计时设置,控制射灯的开关功能。

取值说明

  • 取值范围:0~86400
  • 单位:秒(s)

代码示例

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