Skip to content

GET 获取灯具列表

GET /clip/v2/resource/light

说明

  • 用于获取所有的灯, 以及他们当前的状态

返回示例

json
{
  "code": 0,
  "data": {
    "arr": [
      {
        "ability": 79,
        "brightness": 100,
        "color_arr": [],
        "color_cw": 2740,
        "color_len": 0,
        "color_mode": 2,
        "color_rgb": 0,
        "color_rgb_arr": [],
        "color_x": 0,
        "color_y": 0,
        "ext_attr": {
            "motion": 2
        },
        "id": "49F6A5DD-F8FA-4617-9AE1-5F91D0E6E7EF",
        "motion": {},
        "motion_type": [
            1
        ],
        "name": "",
        "on": 1,
        "pack": [],
        "position_x": 0,
        "position_y": 0,
        "positions": "",
        "power_on": {
            "brightness": 0,
            "brightness_mode": 0,
            "color_cw": 0,
            "color_mode": 0,
            "color_x": 0,
            "color_y": 0,
            "mode": 0,
            "on": 0,
            "on_mode": 0
        },
        "support_dynamic": 0,
        "support_segment": 0,
        "sync_status": 0,
        "type": "light"
      }
    ],
    "len": 3,
    "obj": {}
  },
  "msg": "success"
}

返回结果

状态码状态码含义说明数据模型
200OKnoneInline

返回数据结构

状态码 200

名称类型必选约束中文名说明
» codeintegertruenone状态码none
» msgstringtruenone说明信息none
» dataobjecttruenonenone
»» objobjecttruenonenone
»» arr[object]falsenonenone
»»» idstringtruenone灯具UUIDnone
»»» typestringtruenone类型此处固定为 light
»»» namestringtruenone名字none
»»» onintegertruenone开关状态none
»»» brightnessintegertruenone亮度1-100
»»» color_modeintegertruenone颜色模式0 彩色HSV模式, 1 彩色XY模式, 2 冷暖色, 3 彩色多组XY模式
»»» color_cwintegertruenone冷暖值2000 - 6500
»»» color_xintegertruenoneXY模式X值XY色盘中的x值
»»» color_yintegertruenoneXY模式Y值XY色盘中的y值
»»» color_lenintegertruenone分段长度分段调光时, 分几段
»»» color_arr[object]truenone分段数据none
»»»» xintegertruenonex值none
»»»» yintegertruenoney值none
»»» pack[string]falsenoneBweeApp专用
»»» position_xintegerfalsenoneBweeApp专用
»»» position_yintegerfalsenoneBweeApp专用
»»» positionsstringtruenoneBweeApp专用
»»» power_onPowerOnfalsenone通电反应none
»»»» modeintegertruenone模式0 默认, 1 记忆, 2 自定义, 3 亮, 4 灭
»»»» on_modeintegertruenone开关模式0 默认, 1 记忆, 2 自定义
»»»» onintegertruenone开关none
»»»» brightness_modeintegertruenone亮度模式0 默认, 1 记忆, 2 自定义
»»»» brightnessintegertruenone亮度0-100
»»»» color_modeintegertruenone颜色模式0 默认, 1 记忆, 2 自定义xy, 3 自定义cw
»»»» color_xintegertruenone彩色x值none
»»»» color_yintegertruenone彩色y值none
»»»» color_cwintegertruenone冷暖2000 - 6500
»»» support_segmentintegertruenone分段能力1支持分段色, 0 不支持
»»» support_dynamicintegertruenone动态场景1支持, 0 不支持
»»» abilityintegertruenone灯具支持属性参考下面具体说明

ability是二进制表示

位号 (n)二进制值位权 (2ⁿ)说明
011是否支持开关,1表示支持,0表示不支持
112是否支持调亮度
214是否支持色温
318是否支持彩色
4116是否支持分段
5132是否支持设置长度
6164是否支持动效
71128是否支持电流设置

举例:ability=15,二进制表示0000 1111,表示支持开关,调亮度,色温,彩色