歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

智慧型住宅 MediaState 特性結構定義

action.devices.traits.MediaState - 此屬性適用於可回報媒體狀態的裝置。

Google 助理會將「MediaState」特性用於以下目的:

  • 瞭解每部裝置正在播放的內容 (無論是否由 Google 助理啟動)。這項資訊可幫助 Google 助理進一步瞭解使用者的意圖。 舉例來說,當實際使用者為「暫停目前播放今晚節目」 時,使用者會看見「暫停播放今晚的節目」
  • 為了讓媒體播放器保持可攜性,如果 Google 助理知道目前播放的內容和目前播放的裝置的位置,當使用者在不同房間間移動時,Google 助理可以將該次播放內容轉移到其他裝置,或是將播放內容儲存至之後的任意裝置播放。

您可以利用這項特徵設定屬性,藉此指定解決方案提供的媒體狀態層級和麵向。這類屬性通常會與 TransportControl 特徵搭配使用

裝置屬性

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

屬性 類型 說明
supportActivityState 布林

(預設:false)

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

supportPlaybackState 布林

(預設:false)

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

範例

用於回報活動及同步狀態的媒體裝置

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

裝置狀態:STATE

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

類型 說明
activityState 字串

指出裝置是否處於啟用狀態,且使用者正在與裝置互動。

支援的值:

INACTIVE
STANDBY
ACTIVE
playbackState 字串

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

支援的值:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

範例

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

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

裝置指令

無。

裝置錯誤:ERRORS

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