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

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

Google 助理會將 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"
}

裝置指令

無。

裝置錯誤

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