智能家居场景特征架构

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

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

例如,如果设备允许用户配置一键式命令分组(将灯设置为特定颜色、为各种安全功能或任何其他 activity 组合排序),可以通过 SYNC 将这个配置作为已命名的场景公开,并且 Google 助理将通过简单的激活语法向用户提供这些场景:

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

作为虚拟对象,场景可以放置在会议室中(如果相关),以消除歧义:

  • 开始在厨房里参加派对。
  • 激活卧室的夜间模式。

场景和目标的实际区别之一在于,Google 助理会自动对场景命令应用复数效果,使用户能够跨多个合作伙伴触发场景。例如,如果用户在两个不同的合作伙伴处有一个“派对模式”场景,一个场景用于安全,另一个用于灯具,激活派对模式将同时触发这两个场景。

场景将与即将进行的针对自定义语法的个人操作进行良好互动(例如,启用派对模式 -> 让我们开始派对吧!)。

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

设备属性

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

属性 类型 说明
sceneReversible Boolean

(默认:false

表示此场景可以取消。此属性仅与修改状态并记住之前状态的场景相关。设备支持 ActivateScene 命令,并将 deactivate 参数设为 true。

示例

设备支持可逆转场景。

{
  "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
  }
}

设备错误

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