吸顶灯（xdd） 标准指令集

吸顶灯（xdd） 标准指令集

code	名称	数据类型	取值描述
switch_night_light	夜灯开关	Boolean	{}
do_not_disturb	勿扰模式	Boolean	{}
scene_data	场景	Json	{}
work_mode	模式	Enum	{"range":["white","colour","scene","music"]}
control_data	调节 DP 控制	Json	{}
music_data	音乐灯模式控制	Json	{}
countdown	倒计时 1	Integer	{"unit":"s","min":0,"max":86400,"scale":0,"step":1}
colour_data	彩光	Json	{}
temp_value	冷暖值	Integer	{"min":0,"max":1000,"scale":0,"step":1}
bright_value	亮度值	Integer	{"min":10,"max":1000,"scale":0,"step":1}
switch_led	开关	Boolean	{}

标准指令示例

switch_night_light

表示吸顶灯夜灯的开关。

• 取值说明

  • true：打开吸顶灯夜灯开关。
  • false：关闭吸顶灯夜灯开关。

• 代码示例

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

do_not_disturb

表示勿扰模式的开关。

• 取值说明

  • true：打开勿扰模式开关。
  • false：关闭勿扰模式开关。

• 代码示例

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

scene_data

场景模式控制吸顶灯的颜色变化。

• 取值说明

  • scene_num：情景模式数选择，1~8。
  • 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",
              "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
                      }
          }
      ]
  }
  

work_mode

设置吸顶灯预定义的颜色模式。

• 取值说明

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

• 代码示例

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

control_data

DP 控制吸顶灯的颜色变化。

• 取值说明

  • 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
              }
          }
      ]
  }
  
  

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
              }
          }
      ]
  }
  
  

countdown

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

• 取值说明

  • 单位：秒。
  • 取值范围：0~86400

• 代码示例

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

colour_data

以 HSV 的形式控制吸顶灯的颜色变化。

• 取值说明

  • h：色相，0~360。
  • s：饱和度，0~1000。
  • v：明度，0~1000。

• 代码示例

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

temp_value

调节吸顶灯色温(冷暖)

• 取值说明
  取值范围为 0~1000。

• 代码示例

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

bright_value

调节吸顶灯亮度。

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

• 代码示例

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

switch_led

表示吸顶灯电源的开关。

• 取值说明

  • true：打开吸顶灯电源开关。
  • false：关闭吸顶灯电源开关。

• 代码示例

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