智能家居 MediaState Trait 架构

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

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

  • 了解每个设备上正在播放的内容,以及播放是否处于 由 Google 助理发起这些信息有助于 Google 助理更好地了解用户意图。 例如,如果用户的实际意图是,他们会说“Pause the Tonight Show” “暂停当前正在播放今晚节目的设备”
  • 实现媒体播放器之间的便携性 - 前提是 Google 助理知道正在播放的内容以及 当前播放的位置,Google 助理可将播放的音频作为 用户在房间之间移动,或将播放内容保存下来供以后在任意设备上播放。

您可以指定解决方案提供媒体状态的级别和方面, 配置此 trait 中的属性。此 trait 通常与 TransportControl 个特征

设备属性

具有此特征的设备可能会报告以下内容 作为 SYNC 操作的一部分。学习内容 有关处理 SYNC intent 的更多信息,请参阅 intent 执行方式

属性 类型 说明
supportActivityState 布尔值

(默认值:false

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

supportPlaybackState 布尔值

(默认值:false

指示设备是否可以报告当前的播放状态。

示例

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

{
  "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"
}

设备命令

无。

设备错误

查看完整列表 错误和异常