智慧型住宅 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"
}
裝置指令
無。