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

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

MediaState 特徵可用於以下用途:

  • 瞭解每部裝置正在播放的內容,以及是否由 Google 助理啟動播放。這些資訊有助於 Google 助理進一步瞭解使用者的意圖。 舉例來說,使用者在實際意圖時,會看到「Pause the Tonight Show」(暫停今晚的節目) 「暫停目前播放《Tonight Show》的裝置」。
  • 可讓媒體播放器在偵測到目前播放的內容和 就代表目前播放進度,Google 助理可以將播放內容轉移到其他裝置, 使用者在不同裝置之間移動,或是將播放內容儲存至任意裝置上。

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

裝置屬性

具備這項特徵的裝置可能會回報下列資料: 在 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"
}

裝置指令

無。

裝置錯誤

查看完整清單 錯誤和例外狀況