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