智能家居 MediaState 特征架构

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

Google 助理会使用 MediaState 特征来实现以下目的：

  • 了解每个设备上正在播放的内容，播放操作是否由 Google 助理启动。这些信息有助于 Google 助理更好地了解用户 intent。 例如，当用户的实际意图是“暂停当前播放今晚节目的设备”时，用户将会说“暂停今晚秀”。
  • 为了实现媒体播放器之间的可移植性 - 如果 Google 助理知道当前播放的内容以及当前播放的位置，当用户切换房间时，Google 助理可以将播放内容传输到其他设备，或者保存播放以供稍后在任意设备上播放。

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

设备属性

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

属性 类型 说明
supportActivityState Boolean

（默认值：false）

指示设备是否可以报告 activity 状态。
supportPlaybackState Boolean

（默认值：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"
}

设备命令

无。

设备出错

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