智能家居场景特征架构

action.devices.traits.Scene - 此 trait 用于结合场景设备类型实现虚拟设备。

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

例如,如果设备允许用户配置 命令 - 将灯具设为特定颜色,或对各种安全性事件进行排序 功能或任何其他活动组合 - 此配置可以 通过 SYNC 公开为已命名的场景,而 Google 助理会将这些场景设为 场景示例:

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

你可以将场景作为虚拟对象放置在房间中(如果相关) 消除歧义:

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

场景和实际目标之间的一个区别是,Google 助理 自动对场景命令应用复数效果,允许用户触发 多个合作伙伴的场景。例如,如果用户具有“派对模式”二的场景 不同的合作伙伴,一个负责安全,一个负责灯具,启用派对模式 都会触发这两者

场景能与即将发布的“个人操作”功能更好地兼容,适用于自定义语法 (例如,激活派对模式 -> 让我们开始吧!)。

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

设备属性

具有此特征的设备可能会报告以下内容 作为 SYNC 操作的一部分。学习内容 有关处理 SYNC intent 的更多信息,请参阅 intent 执行方式

属性 类型 说明
sceneReversible 布尔值

(默认值:false

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

示例

支持可翻转场景的设备。

{
  "sceneReversible": true
}

设备状态

无。

设备命令

具有此特征的设备可能会响应以下内容 作为 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
  }
}

设备错误

查看完整列表 错误和异常