智能家居场景特征架构

action.devices.traits.Scene - 此特征用于同时实现虚拟设备和 SCENE 设备类型。

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

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

• 进入派对模式。
• 激活午夜场景。

作为虚拟对象，可以将场景放置在房间中（如果适用），以避免歧义：

• 在厨房中开始派对时间。
• 在卧室内启用护眼模式。

场景和实际目标之间的一个区别是，Google 助理会自动对场景命令应用复数效果，从而允许用户跨多个合作伙伴触发场景。例如，如果用户在两个不同的合作伙伴上使用“派对模式”场景，一个用于安全，一个用于灯光，启用派对模式将同时触发这两者。

场景可与即将推出的个人 Action 很好地交互，以实现自定义语法（例如，“激活派对模式”->“让我们开始派对吧！”）。

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

设备属性

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

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

示例

支持可逆场景的设备。

{
  "sceneReversible": true
}

设备状态

无。

设备命令

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

action.devices.commands.ActivateScene

启用或停用场景。

参数

参数	类型	说明
deactivate	Boolean	必填。 如果场景可反转，则为 true，取消场景；值为 false 时激活场景。

示例

按名称激活场景。

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

按名称停用场景。

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

设备出错

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