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

getLightLibrariesDataTypes

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

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

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

请求参数

参数名	类型	是否必填	说明
bizId	string	true	业务 ID
bizType	number	true	业务类型 0：设备 1：群组
libType	string	true	库类型。SCENE_LIB：情景库。MUSIC_LIB：音乐库。SCENE_IMAGE_LIB：情景图像库。

返回参数

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，那么任意一个数据类型有更新，则认为库是可更新的。

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

请求参数

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

返回参数

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，则会尝试将所有类型的数据都更新到最新版本。

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

请求参数

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

返回参数

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 小程序开发。