智慧型住宅媒體狀態結構定義

action.devices.traits.MediaState - 這個特性會用於能夠回報媒體狀態的裝置。

Google 助理會將 MediaState 特性用於以下用途:

  • 確認每部裝置正在播放的內容 (無論是否由 Google 助理啟動)。這項資訊可協助 Google 助理更加瞭解使用者的意圖。舉例來說,如果使用者實際意圖是「暫停裝置播放今晚節目」,使用者就會看到「暫停播放今晚節目」
  • 為媒體播放器的可攜性:如果 Google 助理知道正在播放的內容,以及目前播放的位置,當使用者在房間間移動時,Google 助理可以將播放內容轉移到其他裝置,或是將播放內容保存在任一裝置上。

您可以設定這個特性中的屬性,藉此指定解決方案提供的媒體狀態和特點。這個特性通常與 TransportControl 特性搭配使用

裝置屬性

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

屬性 類型 說明
supportActivityState 布林

(預設值:false)

指定裝置是否能回報活動狀態。

supportPlaybackState 布林

(預設值:false)

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

範例

媒體活動會回報活動和同步狀態的活動和播放狀態

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

裝置狀態

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

類型 說明
activityState String

指出裝置是否有效,且使用者正在與裝置互動。

支援的值:

INACTIVE
STANDBY
ACTIVE
playbackState String

播放媒體時指定目前狀態。

支援的值:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

範例

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

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

裝置指令

無。

裝置 ERRORS

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