getLightAppAiRuleNames(data: GetLightAppAiRuleNamesParams)

版本要求:
@tuya-miniapp/cloud-api≥1.2.0

描述

获取 App 端侧 AI 照明方案名称列表。该接口用于获取指定房间可用的灯光场景方案，包括基础场景（开/关）和 DIY 场景。返回的场景列表包含场景名称、颜色、图标、开灯百分比以及可选的场景数据列表。

参数

参数类型必填说明
是请求参数：ownerId（家庭 ID）、roomId（房间 ID）、sceneType（场景类型：1 基础场景开，2 基础场景关，3 DIY 场景）

返回值

类型：Promise<GetLightAppAiRuleNamesResult>
场景信息对象数组（nameRosettaKey、name、turnOnPercent、color、icon、sceneDataList、id 等，详见文档「返回参数」表及 SceneData 结构）

引用对象

typeGetLightAppAiRuleNamesResult
LightAppAiNameInfo[]

示例代码

请求示例

import { getLightAppAiRuleNames } from '@tuya-miniapp/cloud-api';

const params = {
  ownerId: '2142765',
  roomId: 65570111,
  sceneType: 3,
};

getLightAppAiRuleNames(params)
  .then(result => {
    console.log('场景方案列表:', result);
    result.forEach(scene => {
      console.log(`场景名称: ${scene.name}`);
      console.log(`开灯比例: ${scene.turnOnPercent}%`);
      console.log(`颜色: ${scene.color}`);
    });
  })
  .catch(error => {
    console.error('获取场景列表失败:', error);
  });

返回示例

[
  { "color": "50657A", "name": "全亮", "turnOnPercent": 100 },
  { "color": "71C149", "name": "全关" },
  { "color": "50657A", "name": "聊天", "turnOnPercent": 60 },
  { "color": "EA903A", "name": "家人互动", "turnOnPercent": 60 },
  { "color": "BA7B69", "name": "亲子互动", "turnOnPercent": 60 },
  { "color": "4E7ACE", "name": "接待", "turnOnPercent": 60 },
  {
    "color": "DC4F58",
    "name": "场景 31",
    "sceneDataList": [{ "sceneId": 112000112, "sceneData": "******" }]
  },
  {
    "color": "EA903A",
    "name": "场景 32",
    "sceneDataList": [{ "sceneId": 112000212, "sceneData": "******" }]
  }
]