智能家居场景 trait 架构

action.devices.traits.Scene - 此 trait 用于与 SCENE 设备类型一起实现虚拟设备。

如需了解详情，请参阅场景类型指南。

例如，如果设备允许用户配置一键式组合命令（将灯光设置为特定颜色、按顺序启用各种安全功能或任何其他活动组合），此配置可以通过 SYNC 作为命名场景进行公开，然后 Google 助理会通过简单的启用语法将这些场景提供给用户：

• 启动派对模式。
• 启用午夜场景。

作为虚拟对象，场景可以放置在房间中（如果相关）以进行区分：

• 在厨房开启派对模式。
• 在卧室中开启夜灯模式。

场景和实体目标之间的一个区别是，Google 助理会自动对场景命令应用复数效果，让用户能够触发多个合作伙伴的场景。例如，如果用户在两个不同的合作伙伴处设置了“派对模式”场景（一个用于安全，一个用于照明），则启用派对模式将触发这两个场景。

场景将与即将推出的自定义语法个人 Action 进行良好互动（例如，启用派对模式 -> 让我们开始派对吧！）。

场景应始终使用用户提供的名称，而不是默认的“BobCo 场景”命名。每个场景都是自己的虚拟设备，具有自己的名称。用户提供的名称可能会通过 SYNC 传入。

设备属性

具有此 trait 的设备可能会在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅intent 执行方式。

属性	类型	说明
sceneReversible	布尔值	（默认值：false） 表示此场景可以取消。此属性仅适用于修改状态并记住之前状态的场景。设备支持将 deactivate 参数设为 true 的 ActivateScene 命令。

示例

支持可逆场景的设备。

{
  "sceneReversible": true
}

设备状态

无。

设备命令

具有此 trait 的设备可能会在 EXECUTE 操作期间响应以下命令。如需详细了解如何处理 EXECUTE intent，请参阅intent 执行方式。

action.devices.commands.ActivateScene

启用或停用场景。

参数

参数	类型	说明
deactivate	布尔值	必填。 如果场景可撤消，则为 true；如果场景可激活，则为 false。

示例

按名称激活场景。

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

按名称停用场景。

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

设备错误

查看错误和异常的完整列表。