欢迎使用 Google Home 开发者中心,您可以在这里学习有关如何开发智能家居 Action 的新平台。注意:你将继续在 Actions 控制台中构建操作。
使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

智能家居 MediaState 特征架构

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

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

设备命令

无。

设备出错

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