getSceneRuleDetail - 查询场景规则详情

getSceneRuleDetail(params: GetSceneRuleDetailParams)

版本要求:

@tuya-miniapp/cloud-api≥1.6.0

描述

查询单个场景规则的详情

参数

参数	类型	必填	说明
		是	请求体（ruleId 来自 getSceneListByHomeID 或保存场景后的 ruleId）

返回值

类型：Promise<SceneRuleDetail>

SceneRuleDetail（单条场景规则的完整详情）

引用对象

interfaceSceneRuleDetail`getSceneRuleDetail` 返回：单条场景规则的完整详情

属性	类型	描述
		动作列表
`arrowIconUrl`	string	列表箭头图标 URL
`attribute`	number	业务属性标记（与云端约定）
`auditStatus`	number	审核状态
`background`	string	场景背景图 URL
`boundForPanel`	boolean	面板绑定
`boundForWiFiPanel`	boolean	WiFi 面板绑定
`categorys`	string[]	场景分类标签列表
`code`	string	场景/规则编码
`commonField`	string	通用扩展字段（与云端约定，常为序列化对象，如 `{"subMatchType":1}`）
		条件列表
`containDeviceDelete`	boolean	是否包含已删除设备相关标记
`coverIcon`	string	图标 URL
`description`	string	场景描述
`deviceIds`	string[]	关联设备 ID 列表
`disableTime`	number	禁用截止时间戳（若有，毫秒）
`displayColor`	string	背景色（无 `#` 前缀）
`enabled`	boolean	是否启用
`forceCloudTrigger`	boolean	是否强制云端触发
`gmtCreate`	number	创建时间戳（毫秒）
`gmtModified`	number	最近修改时间戳（毫秒）
`id`	string	场景/规则 ID
`iotAutoAlarm`	boolean	IoT 自动化告警相关标记
`isAlarmIssue`	boolean	是否告警类联动
`isLogicRule`	boolean	是否为逻辑规则类场景
`linkageType`	number	联动类型
`localLinkage`	boolean	是否本地联动
`matchType`	number	匹配类型 1:任一条件 2:全部满足 3:表态式匹配
`name`	string	场景名称
`needCleanGidSid`	boolean	是否需要清理 gid/sid 等关联缓存
`needValidOutOfWork`	boolean	是否校验非工作时段
`newLocalScene`	boolean	是否新本地场景模型
`offGwSync`	boolean	网关同步标记
`offGwSyncSuccess`	boolean	网关同步是否已成功
`orderWeight`	number	列表排序权重
`outOfWork`	number	非工作时段等状态标记
`ownerId`	string	家庭 ID
`panelType`	number	面板类型
`permissionCode`	string	权限码
`roomIds`	string[]	关联房间 ID 列表
`ruleGenre`	number	规则类型 1:场景 2:自动化
`ruleSource`	number	规则来源渠道/系统
`ruleType`	number	规则来源类型 1.系统定义 2.商家定义 3.用户定义 4.安防规则 5.服务定义
`runtimeEnv`	string	运行环境（如 `prod`）
`scenarioRule`	boolean	是否在 App 场景 tab 中展示
`status`	boolean	场景/规则状态
`statusConditions`	unknown[]	状态型条件集合（结构由云端定义）
`stickyOnTop`	boolean	是否置顶展示
`subMatchType`	number	子匹配类型
`uid`	string	用户 ID

示例代码

请求示例

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

getSceneRuleDetail({
  gid: '46718684',
  ruleId: 'rMoXvUMZWDTckvau',
  ruleGenre: 2,        // 1:场景 2:自动化
  homeModel: true,
})
  .then(detail => {
    console.log('Scene detail:', detail.name);
    // 定时器条件（entityType=6）的 expr 为对象数组
    const timer = detail.conditions.find(c => c.entityType === 6);
    console.log('Timer expr:', timer?.expr);
  })
  .catch(error => {
    console.error('Failed:', error);
  });

返回示例（节选）

{
  "id": "rMoXvUMZWDTckvau",
  "name": "嘻嘻嘻",
  "ruleGenre": 2,
  "actions": [
    {
      "actionExecutor": "appPushTrigger",
      "actionStrategy": "edge",
      "devDelMark": false,
      "enabled": true
    }
  ],
  "conditions": [
    {
      "entityId": "timer",
      "entitySubIds": "timer",
      "entityType": 6,
      "expr": [
        {
          "date": "20260714",
          "time": "11:28",
          "dayLoops": "229376",
          "monthLoops": "000000100000"
        }
      ],
      "extraInfo": {
        "jumpUrl": "/pages/duration/index"
      }
    }
  ]
}