智能家居场景特征架构
action.devices.traits.Scene
- 此特征用于同时实现虚拟设备和 SCENE 设备类型。
如需了解详情,请参阅场景类型指南。
例如,如果设备允许用户配置一键式命令分组(将灯光设置为特定颜色,或对各种安全功能进行排序,或其他任何 activity 组合),此配置可通过 SYNC
作为已命名的场景公开,Google 助理将通过简单的激活语法向用户提供这些场景:
- 进入派对模式。
- 启用午夜场景。
作为虚拟对象,可以将场景放置在房间中(如果适用),以消除歧义:
- 开始在厨房里聚会。
- 启用卧室的夜间模式。
场景和物理目标之间的一个区别是,Google 助理会自动对场景命令应用复数效果,允许用户跨多个合作伙伴触发场景。例如,如果用户在两个不同的合作伙伴上使用“派对模式”场景,一个针对安全,另一个针对灯光,则启用派对模式将触发这两者。
场景可与即将针对自定义语法进行的个人 Action 很好地交互(例如,“激活派对模式”->“让我们开始派对吧!”)。
场景应始终使用用户提供的名称,而非默认的“BobCo Scene”命名。每个场景都是自己的虚拟设备,具有自己的名称。用户提供的名称可能来自 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 } }