---
title: 品类 API
summary: 照明情景库、库数据类型、版本校验与升级等云端 API 接口说明。
---

## 品类 API

### 照明情景库
- **接口： 获取设备或群组所绑定的照明（情景/音乐等）库中的数据**
  - 含义：获取设备或群组所绑定的照明（情景/音乐等）库，然后将库中的数据输出。例如，情景库中的情景参数信息。
  - 接口详情：[getLightLibrariesData](/cn/miniapp/develop/ray/api/light/light-library/getLightLibrariesData)

- **接口： 获取设备或群组的所绑定的照明库数据类型**
  - 含义：获取设备或群组所绑定的照明库数据类型列表。通过该数据类型列表，可实现数据分类展示。
  - 接口详情：[getLightLibrariesDataTypes](/cn/miniapp/develop/ray/api/light/light-library/getLightLibrariesDataTypes)

- **接口： 校验所绑定的库是否存在可更新的版本**
  - 含义：校验设备或群组绑定的库的最新版本，是否大于当前绑定的版本。若是，则认为有可更新的版本，否则认为无可更新的版本。如果 libDataType 传 0，那么任意一个数据类型有更新，则认为库是可更新的。
  - 接口详情：[checkLightLibrariesVersionsUpgradable](/cn/miniapp/develop/ray/api/light/light-library/checkLightLibrariesVersionsUpgradable)

- **接口：升级设备或群组使用的库版本到最新**
  - 含义：当检测到有可更新的版本时，使用该接口将库升级到最新的版本。如果 libDataType 传 0，则会尝试将所有类型的数据都更新到最新版本。
  - 接口详情：[upgradeToLatestLightLibrariesVersions](/cn/miniapp/develop/ray/api/light/light-library/upgradeToLatestLightLibrariesVersions)