欢迎使用 Google Home 开发者中心,这是一个学习如何开发智能家居 Action 的新平台。注意:构建 Action 的工作仍需在 Actions 控制台中完成。

智能家居 MediaState 特征架构

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

Google 助理会使用“MediaState”特征来达成以下目的:

  • 为了解每台设备上的播放内容,播放是否由 Google 助理启动。这些信息有助于 Google 助理更好地了解用户 intent。例如,如果用户的实际意图是“暂停目前播放今晚节目的设备”,用户就会说“暂停今晚节目”。
  • 为实现媒体播放器之间的可移植性 - 如果 Google 助理知道当前正在播放的内容和当前播放的位置,那么当用户在不同房间之间移动时,Google 助理可以将该播放转移到其他设备,或者将播放内容保存到任意设备上供日后使用。

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

设备属性

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

属性 类型 说明
supportActivityState Boolean

(默认:false

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

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

设备命令

无。

设备错误

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