智能小程序 Ray 开发——照明情景库 API 接口汇总（二）

getLightLibrariesDataTypes

该接口为云能力，需开通授权后使用，关于云能力可查看文档

获取设备或群组所绑定的照明库数据类型列表。通过该数据类型列表，可实现数据分类展示。

ℹ️  需要在 涂鸦开发者平台产品功能定义页面开通高级能力后方可使用，否则调用云能力会出现失败的情况

请求参数

返回参数

DataType[]

DataType 支持的数据类型列表。

• 0：所有数据类型。
• 1：基础数据，此类数据是涂鸦提供的绑定在面板 uiId 层面的数据。
• 2：高级数据，此类数据是用户在微应用后台维护的数据。

请求示例

// @ray-js/ray^1.4.14
import { getLightLibrariesDataTypes } from "@ray-js/ray";
 
getLightLibrariesDataTypes({
  bizId: "vdevo167504******003",
  bizType: 0,
  libType: "SCENE_LIB",
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

[
  1
]

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。 

checkLightLibrariesVersionsUpgradable

该接口为云能力，需开通授权后使用，关于云能力可查看文档

需引入 MiniKit，且在 >= 3.7.6 版本方可使用

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

ℹ️  需要在 涂鸦开发者平台产品功能定义页面开通高级能力后方可使用，否则调用云能力会出现失败的情况

请求参数

返回参数

boolean

请求示例

// @ray-js/ray^1.4.14
import { checkLightLibrariesVersionsUpgradable } from "@ray-js/ray";
 
checkLightLibrariesVersionsUpgradable({
  bizId: "vdevo167504******003",
  bizType: 0,
  libType: "SCENE_LIB",
  libDataType: 0
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

true;

upgradeToLatestLightLibrariesVersions

该接口为云能力，需开通授权后使用，关于云能力可查看文档

需引入 MiniKit，且在 >= 3.7.6 版本方可使用

当检测到有可更新的版本时，使用该接口将库升级到最新的版本。如果 libDataType 传 0，则会尝试将所有类型的数据都更新到最新版本。

ℹ️  需要在 涂鸦开发者平台产品功能定义页面开通高级能力后方可使用，否则调用云能力会出现失败的情况

请求参数

返回参数

boolean

请求示例

// @ray-js/ray^1.4.14
import { upgradeToLatestLightLibrariesVersions } from "@ray-js/ray";
 
upgradeToLatestLightLibrariesVersions({
  bizId: "vdevo167504******003",
  bizType: 0,
  libType: "SCENE_LIB",
  libDataType: 0
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

boolean

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。