射灯(sxd)标准状态集

更新时间:2022-01-12 07:34:22下载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
		}
	]
}