智慧型住宅媒體狀態結構定義
action.devices.traits.MediaState
- 這個特性會用於能夠回報媒體狀態的裝置。
Google 助理會將 MediaState
特性用於以下用途:
- 確認每部裝置正在播放的內容 (無論是否由 Google 助理啟動)。這項資訊可協助 Google 助理更加瞭解使用者的意圖。舉例來說,如果使用者實際意圖是「暫停裝置播放今晚節目」,使用者就會看到「暫停播放今晚節目」。
- 為媒體播放器的可攜性:如果 Google 助理知道正在播放的內容,以及目前播放的位置,當使用者在房間間移動時,Google 助理可以將播放內容轉移到其他裝置,或是將播放內容保存在任一裝置上。
您可以設定這個特性中的屬性,藉此指定解決方案提供的媒體狀態和特點。這個特性通常與 TransportControl
特性搭配使用
裝置屬性
具此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求。
屬性 | 類型 | 說明 |
---|---|---|
supportActivityState |
布林 |
(預設值: 指定裝置是否能回報活動狀態。 |
supportPlaybackState |
布林 |
(預設值: 指定裝置是否能回報目前的播放狀態。 |
範例
媒體活動會回報活動和同步狀態的活動和播放狀態
{ "supportActivityState": true, "supportPlaybackState": true }
裝置狀態
具有這個特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求。
州 | 類型 | 說明 |
---|---|---|
activityState |
String |
指出裝置是否有效,且使用者正在與裝置互動。 支援的值:
|
playbackState |
String |
播放媒體時指定目前狀態。 支援的值:
|
範例
會回報活動和播放狀態的媒體裝置
{ "activityState": "ACTIVE", "playbackState": "PAUSED" }
裝置指令
無。