getLightLibrariesData – 涂鸦小程序

getLightLibrariesData(data: GetLightLibrariesDataParams)

版本要求:

@tuya-miniapp/cloud-api≥1.0.5小程序基础库≥2.18.1

描述

获取设备或群组所绑定的照明（情景/音乐等）库，然后将库中的数据输出。例如，情景库中的情景参数信息。

参数

参数	类型	必填	说明
		是	请求参数：bizId（业务 ID）、bizType（业务类型，0：设备 1：群组）、libType（库类型。SCENE_LIB：情景库。MUSIC_LIB：音乐库。SCENE_IMAGE_LIB：情景图像库。）、libDataType（库数据类型。0：所有。如果为 0，那么任意一个数据类型有更新，则认为库是可更新的。1：基础数据，此类数据是涂鸦提供的绑定在面板 uiId 层面的数据。2：高级数据，此类数据是用户在微应用后台维护的数据。）

返回值

类型：Promise<GetLightLibrariesDataResult>

Plate[]（每个元素含 plateId、plateName、plateIcon、plateIconDisplayType、data 等；data 内为分组数据及 items，items 为情景库或图像库条目，字段见文档 Plate、Data、SceneLibraryItem 表）

引用对象

typeGetLightLibrariesDataResult

Plate[]

合法值

`GetLightLibrariesDataParams.bizType`

值	说明	小程序基础库最低版本
`0`	-	-
`1`	-	-

`GetLightLibrariesDataParams.libType`

值	说明	小程序基础库最低版本
`SCENE_LIB`	-	-
`MUSIC_LIB`	-	-
`SCENE_IMAGE_LIB`	-	-

`GetLightLibrariesDataParams.libDataType`

值	说明	小程序基础库最低版本
`0`	-	-
`1`	-	-
`2`	-	-

示例代码

请求示例

import { getLightLibrariesData } from '@tuya-miniapp/cloud-api';

getLightLibrariesData({
  bizId: 'vdevo167504******003',
  bizType: 0,
  libType: 'SCENE_LIB',
  libDataType: 0,
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

[
  {
    "plateIconDisplayType": 0,
    "plateId": 2774,
    "data": [
      {
        "iconDisplayType": 3,
        "iconDisplaySize": "166*102",
        "items": [
          {
            "sceneName": "晚安",
            "icon": "https://images.tuyacn.com/light/library/icon/bixc94box***.png",
            "sort": 0,
            "sceneDesc": "50",
            "dpCode": "sceneData",
            "sceneId": 3537,
            "sceneData": "000e0d0000000000000000c80000"
          }
        ]
      }
    ],
    "plateName": "温馨生活",
    "plateIcon": ""
  },
  {
    "plateIconDisplayType": 0,
    "plateId": 2775,
    "data": [
      {
        "iconDisplayType": 3,
        "iconDisplaySize": "166*102",
        "items": [
          {
            "sceneName": "海洋",
            "icon": "https://images.tuyacn.com/light/library/icon/bixbr00rh***.png",
            "sort": 4,
            "sceneDesc": "0",
            "dpCode": "sceneData",
            "sceneId": 3543,
            "sceneData": "1746460200f003e803e80000000046460200dc02bc03e800000000"
          }
        ]
      }
    ],
    "plateName": "主题心情",
    "plateIcon": ""
  }
]