智能家居场景特征架构
action.devices.traits.Scene
- 此 trait 用于结合场景设备类型实现虚拟设备。
如需了解详情,请参阅场景类型指南。
例如,如果设备允许用户配置
命令 - 将灯具设为特定颜色,或对各种安全性事件进行排序
功能或任何其他活动组合 - 此配置可以
通过 SYNC
公开为已命名的场景,而 Google 助理会将这些场景设为
场景示例:
- 进入派对模式。
- 启用午夜场景。
你可以将场景作为虚拟对象放置在房间中(如果相关) 消除歧义:
- 在厨房开始派对时间。
- 在卧室启用护眼模式。
场景和实际目标之间的一个区别是,Google 助理 自动对场景命令应用复数效果,允许用户触发 多个合作伙伴的场景。例如,如果用户具有“派对模式”二的场景 不同的合作伙伴,一个负责安全,一个负责灯具,启用派对模式 都会触发这两者
场景能与即将发布的“个人操作”功能更好地兼容,适用于自定义语法 (例如,激活派对模式 -> 让我们开始吧!)。
场景应始终使用用户提供的名称,而不是默认的“BobCo 场景”
命名。每个场景都是独立的虚拟设备,有自己的名称。
用户提供的名称可能来自 SYNC
。
设备属性
具有此特征的设备可能会报告以下内容
作为 SYNC
操作的一部分。学习内容
有关处理 SYNC
intent 的更多信息,请参阅
intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
sceneReversible |
布尔值 |
(默认值: 表示此场景可以取消。此属性仅适用于修改状态并记住之前状态的场景。设备支持将 |
示例
支持可翻转场景的设备。
{ "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 } }