saveDeviceLinkageScene(params: SaveDeviceLinkageSceneParams)

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

描述

保存或编辑场景(仅支持设备联动设备)

参数

参数类型必填说明
是请求体

返回值

类型:Promise<SaveDeviceLinkageSceneResult>
SaveDeviceLinkageSceneResult(字段含义见类型定义与 minituya 返回参数)

引用对象

typeSaveDeviceLinkageSceneResult
属性类型描述
namestring场景名称
ruleIdstring场景ID
ruleGenrenumber规则类型 1:场景,2自动化

示例代码

请求示例

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

// 新增场景
saveDeviceLinkageScene({
  gid: '123456789',
  name: '回家模式',
  coverIcon: 'https://example.com/icon.png',
  actions: [
    {
      devDelMark: false,
      entityId: 'device_001',
      executorProperty: {
        '1': true,
        '2': 50,
      },
      extraProperty: {},
    },
  ],
  conditions: [
    {
      entitySubIds: '1',
      iconUrl: 'https://example.com/icon.png',
      entityId: 'device_002',
      expr: [['1', '==', 'true']],
      devDelMark: false,
      entityType: 1,
      extraInfo: {},
    },
  ],
  enabled: true,
  matchType: 1,
  displayColor: '#FF5722',
})
  .then(response => {
    console.log('Scene saved:', response);
  })
  .catch(error => {
    console.error('Failed to save scene:', error);
  });

// 更新场景
saveDeviceLinkageScene({
  gid: '123456789',
  id: 'scene_001',
  name: '回家模式(已更新)',
  coverIcon: 'https://example.com/icon.png',
  actions: [
    {
      id: 'action_001',
      devDelMark: false,
      entityId: 'device_001',
      executorProperty: {
        '1': true,
        '2': 80,
      },
      extraProperty: {},
    },
  ],
  conditions: [],
  enabled: true,
  matchType: 1,
  displayColor: '#FF5722',
})
  .then(response => {
    console.log('Scene updated:', response);
  })
  .catch(error => {
    console.error('Failed to update scene:', error);
  });

返回示例

{
  "name": "回家模式",
  "ruleId": "scene_001",
  "ruleGenre": 1
}