---
name: "checkLightLibrariesVersionsUpgradable"
mode: "kit"
versionRequirements:
  - { name: "MiniKit", version: "3.7.6" }
  - { name: "@tuya-miniapp/cloud-api", version: "1.0.5" }
  - { name: "小程序基础库", version: "2.18.1" }
---

## checkLightLibrariesVersionsUpgradable

> [VERSION] MiniKit >= 3.7.6 | @tuya-miniapp/cloud-api >= 1.0.5 | 小程序基础库 >= 2.18.1

> 💡 该接口为云能力，需开通授权后使用，关于云能力可[查看文档](/cn/miniapp/common/desc/tech-stack/api) 目前云能力在 开发者工具环境无法使用，需要打包后或真机调试使用。[照明情景库](https://developer.tuya.com/cn/docs/iot/scene_library?id=Kbn3oiww4klzq) 需要在 涂鸦开发者平台产品功能定义页面开通高级能力后方可使用，否则调用云能力会出现失败的情况

### 描述

校验设备或群组绑定的库的最新版本，是否大于当前绑定的版本。若是，则认为有可更新的版本，否则认为无可更新的版本。如果 libDataType 传 0，那么任意一个数据类型有更新，则认为库是可更新的。

### 参数

`Params`

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

### 引用对象

##### `interface` GetLightLibrariesDataParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `bizId` | `string` | 业务 ID |
| `bizType` | `0 \| 1` | 业务类型 0：设备 1：群组 |
| `libType` | `"SCENE_LIB" \| "MUSIC_LIB" \| "SCENE_IMAGE_LIB"` | 库类型。SCENE_LIB：情景库。MUSIC_LIB：音乐库。SCENE_IMAGE_LIB：情景图像库。 |
| `libDataType` | `0 \| 1 \| 2` | 库数据类型。0：所有。如果为 0，那么任意一个数据类型有更新，则认为库是可更新的。1：基础数据，此类数据是涂鸦提供的绑定在面板 uiId 层面的数据。2：高级数据，此类数据是用户在微应用后台维护的数据。 |


### 示例代码

#### 请求示例

```typescript
import { checkLightLibrariesVersionsUpgradable } from '@tuya-miniapp/cloud-api';

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

#### 返回示例

```json
true
```