智能家居 MediaState trait 架构
action.devices.traits.MediaState - 此 trait 适用于能够报告媒体状态的设备。
MediaState trait 由 Google 助理用于以下用途:
- 了解每个设备上播放的内容,以及播放内容是由 Google 助理发起的还是其他来源发起的。这些信息有助于 Google 助理更好地理解用户意图。 例如,用户会说“暂停《今夜秀》”,但其实际意图是“暂停当前正在播放《今夜秀》的设备”。
- 在媒体播放器之间实现便携性 - 如果 Google 助理知道正在播放的内容以及当前播放的位置,则可以在用户在房间之间移动时将该播放内容转移到另一部设备,或将播放内容保存在任意设备上以供日后使用。
您可以通过在此 trait 中配置属性来指定您的解决方案提供的媒体状态的级别和方面。此 trait 通常与 TransportControl trait 搭配使用
设备属性
具有此 trait 的设备可能会在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent,请参阅intent 执行方式。
| 属性 | 类型 | 说明 |
|---|---|---|
supportActivityState |
布尔值 |
(默认值: 指明设备是否可以报告活动状态。 |
supportPlaybackState |
布尔值 |
(默认值: 指明设备是否可以报告当前的播放状态。 |
示例
同时报告活动状态和播放状态以响应 SYNC 的媒体设备
{
"supportActivityState": true,
"supportPlaybackState": true
}设备状态
具有此 trait 的实体可能会在 QUERY 操作期间报告以下状态。如需详细了解如何处理 QUERY intent,请参阅intent 执行方式。
| 州 | 类型 | 说明 |
|---|---|---|
activityState |
String |
指明设备是否处于活动状态以及用户是否正在与设备进行积极互动。 支持的值:
|
playbackState |
String |
在播放媒体时指示当前状态。 支持的值:
|
示例
同时报告活动和播放状态的媒体设备
{
"activityState": "ACTIVE",
"playbackState": "PAUSED"
}设备命令
无。