智能家居 MediaState 特征架构
action.devices.traits.MediaState
- 此特征用于能够报告媒体状态的设备。
Google 助理会使用 MediaState
特征来达成以下目的:
- 为了了解每个设备上正在播放的内容,无论播放是否由 Google 助理启动。这些信息有助于 Google 助理更好地了解用户 intent。例如,如果用户的实际意图是“暂停目前播放今晚节目的设备”,则用户会说“暂停今晚节目”。
- 为实现媒体播放器之间的可移植性 - 如果 Google 助理知道正在播放的内容和当前播放的位置,则当用户在不同房间之间移动时,Google 助理便可以将该播放转移到其他设备,或将播放内容保存到日后在任何设备上。
您可以通过配置此特征中的属性来指定解决方案提供的媒体状态级别和方面。此特征通常与 TransportControl
特征结合使用
设备属性
具有此特征的设备可能会在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
supportActivityState |
Boolean |
(默认值: 指示设备是否可以报告 activity 状态。 |
supportPlaybackState |
Boolean |
(默认值: 指明设备是否可以报告当前的播放状态。 |
示例
媒体设备,用于报告 SYNC 响应的活动和播放状态
{ "supportActivityState": true, "supportPlaybackState": true }
设备状态
具有此特征的实体可能会在 QUERY
操作中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
activityState |
String |
指明设备是否处于活动状态,以及用户是否在主动与其互动。 支持的值:
|
playbackState |
String |
指示播放媒体时的当前状态。 支持的值:
|
示例
同时报告 activity 和播放状态的媒体设备
{ "activityState": "ACTIVE", "playbackState": "PAUSED" }
设备命令
无。