previewLightScene(data: PreviewLightSceneParams)

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

描述

根据场景规则 JSON 数据，预览照明场景效果，返回执行成功和失败的动作列表。

参数

参数类型必填说明
是请求参数：ownerId（家庭 ID）、previewExpr（预览的场景 JSON 数据，包含场景的完整配置信息；PreviewExprData 字段说明见文档「previewExpr 字段说明」）

返回值

类型：Promise<PreviewLightSceneResult>
successActions（执行成功的设备 ID 列表）、failActions（执行失败的设备 ID 列表）

引用对象

interfacePreviewLightSceneResult
属性类型描述
successActionsstring[]执行成功的动作列表
failActionsstring[]执行失败的动作列表

示例代码

请求示例

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

const params = {
  ownerId: '214276111',
  previewExpr: JSON.stringify({
    actions: [
      {
        executorProperty: {
          switch_led: false,
        },
        actionExecutor: 'lightDevice',
      },
    ],
    parentRegionId: 65570551,
    originPercent: 0,
    targetPercent: 0,
    type: 2,
  }),
};

previewLightScene(params)
  .then(result => {
    console.log('场景预览结果:', result);
    console.log('成功的设备:', result.successActions);
    console.log('失败的设备:', result.failActions);
  })
  .catch(error => {
    console.error('场景预览失败:', error);
  });

返回示例

{
  "successActions": ["6c4003f3231bb36d40q123", "6c135cd26c3fcab5862456"],
  "failActions": ["6c9fb53eqkzdw123", "6c7d2bgchtp9x345"]
}