智慧型住宅 MediaState 特徵結構定義
action.devices.traits.MediaState
- 這個特性用於可回報媒體狀態的裝置。
Google 助理會將 MediaState
特徵用於下列用途:
- 瞭解每部裝置正在播放的內容,無論是否是由 Google 助理啟動。這些資訊可協助 Google 助理進一步瞭解使用者意圖。舉例來說,使用者的實際意圖為「暫停裝置目前播放今晚節目」時,會說出「Pause the Tonight Show」。
- 為確保媒體播放器之間的可攜性,如果 Google 助理知道正在播放的內容和目前播放的位置,當使用者在房間之間移動時,Google 助理可以將該播放內容傳輸至另一部裝置,或是儲存播放內容供日後任意裝置使用。
您可設定此特性的屬性,指定解決方案提供的媒體狀態層級和層面。這項特性通常會與 TransportControl
特徵搭配使用
裝置屬性
具備這個特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱「意圖執行要求」。
屬性 | 類型 | 說明 |
---|---|---|
supportActivityState |
布林 |
(預設值: 指出裝置能否回報活動狀態。 |
supportPlaybackState |
布林 |
(預設值: 指定裝置能否回報目前的播放狀態。 |
範例
用於回報 SYNC 回應活動和播放狀態的媒體裝置
{ "supportActivityState": true, "supportPlaybackState": true }
裝置狀態
具有這個特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱「意圖執行要求」。
狀態 | 類型 | 說明 |
---|---|---|
activityState |
String |
指出裝置是否為使用中,以及使用者是否積極與裝置互動。 支援的值:
|
playbackState |
String |
播放媒體時用來表示目前狀態。 支援的值:
|
範例
會回報活動和播放狀態的媒體裝置
{ "activityState": "ACTIVE", "playbackState": "PAUSED" }
裝置指令
無。