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