智能家居 MediaState trait 架构

action.devices.traits.MediaState - 此 trait 适用于能够报告媒体状态的设备。

MediaState trait 由 Google 助理用于以下用途：

• 了解每个设备上正在播放的内容，以及播放内容是由 Google 助理发起的还是其他来源发起的。这些信息有助于 Google 助理更好地了解用户意图。例如，用户会说“暂停《今夜秀》”，但其实际意图是“暂停当前正在播放《今夜秀》的设备”。
• 在媒体播放器之间实现便携性 - 如果 Google 助理知道正在播放的内容以及当前播放的位置，则可以在用户在房间之间移动时将该播放内容转移到另一部设备，或将播放内容保存在任意设备上以供日后使用。

您可以通过在此 trait 中配置属性来指定您的解决方案提供的媒体状态的级别和方面。此 trait 通常与 TransportControl trait 搭配使用

设备属性

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

属性	类型	说明
supportActivityState	布尔值	（默认值：false） 指明设备是否可以报告活动状态。
supportPlaybackState	布尔值	（默认值：false） 指明设备是否可以报告当前的播放状态。

示例

同时报告活动状态和播放状态以响应 SYNC 的媒体设备

{
  "supportActivityState": true,
  "supportPlaybackState": true
}

设备状态

具有此特征的实体可能会在 QUERY 操作中报告以下状态。如需详细了解如何处理 QUERY intent，请参阅intent 执行方式。

州	类型	说明
activityState	String	指示设备是否处于活动状态，以及用户是否在积极与其互动。 支持的值： INACTIVE STANDBY ACTIVE
playbackState	String	在播放媒体时指示当前状态。 支持的值： PAUSED PLAYING FAST_FORWARDING REWINDING BUFFERING STOPPED

示例

同时报告 activity 和播放状态的媒体设备

{
  "activityState": "ACTIVE",
  "playbackState": "PAUSED"
}

设备命令

无。

设备错误

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