---
title: 接口能力 - 对照明情景库的能力我们提供了下接口能力，开发者可直接调用 `API` 完成计量相关业务开发。
---

# 照明情景库

> 该接口为云能力，需开通授权后使用，关于云能力可[查看文档](/cn/miniapp/common/desc/tech-stack/api) <br/>_**<font color="red">目前云能力在 `开发者工具`环境无法使用，需要打包后或真机调试使用。</font>**_

## 接口能力

对照明情景库的能力我们提供了下接口能力，开发者可直接调用 `API` 完成计量相关业务开发。

**注意，以下 API 需要在 `@ray-js/ray^1.4.14` 使用。**

| 接口名                                | 描述                                                |
| ------------------------------------- | --------------------------------------------------- |
| checkLightLibrariesVersionsUpgradable | 校验所绑定的库是否存在可更新的版本                  |
| upgradeToLatestLightLibrariesVersions | 升级设备或群组使用的库版本到最新                    |
| getLightLibrariesData                 | 获取设备或群组所绑定的照明（情景/音乐等）库中的数据 |
| getLightLibrariesDataTypes            | 获取设备或群组的所绑定的照明库数据类型              |