智慧型住宅 MediaState 特徵架構

action.devices.traits.MediaState：這個特徵適用於可回報媒體狀態的裝置。

MediaState 特徵可用於以下用途：

  • 瞭解每部裝置正在播放的內容，以及是否由 Google 助理啟動播放。這項資訊可協助 Google 助理進一步瞭解使用者意圖。 舉例來說，使用者會說「暫停今晚秀」，但實際意圖是「暫停目前播放今晚秀的裝置」。
  • 在媒體播放器之間移轉內容：如果 Google 助理知道正在播放的內容和目前播放的位置，當使用者在房間之間移動時，Google 助理就能將播放內容轉移到其他裝置，或將播放內容儲存起來，以便日後在任意裝置上播放。

您可以透過設定這個特徵的屬性，指定解決方案提供的媒體狀態層級和面向。這個特徵通常會與 TransportControl 特徵一起使用

裝置屬性

具備此特徵的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱「意圖執行要求」。

屬性 類型 說明
supportActivityState 布林值

(預設值：false)

指出裝置是否可回報活動狀態。
supportPlaybackState 布林值

(預設值：false)

指出裝置是否能回報目前的播放狀態。

範例

同時回報活動和播放狀態的媒體裝置，以便回應 SYNC 回應

{
  "supportActivityState": true,
  "supportPlaybackState": true
}

裝置狀態

具有此特徵的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖，請參閱「意圖執行要求」。

州 類型 說明
activityState String

指出裝置是否處於活動狀態，以及使用者是否正在與裝置互動。

支援的值：

INACTIVE
STANDBY
ACTIVE
playbackState String

在播放媒體時指出目前的狀態。

支援的值：

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

範例

同時回報活動和播放狀態的媒體裝置

{
  "activityState": "ACTIVE",
  "playbackState": "PAUSED"
}

裝置指令

無。

裝置錯誤

請參閱錯誤和例外狀況的完整清單。