智慧型住宅 MediaState 特性結構定義
action.devices.traits.MediaState
- 此屬性適用於可回報媒體狀態的裝置。
Google 助理會將「MediaState
」特性用於以下目的:
- 瞭解每部裝置正在播放的內容 (無論是否由 Google 助理啟動)。這項資訊可幫助 Google 助理進一步瞭解使用者的意圖。 舉例來說,當實際使用者為「暫停目前播放今晚節目」 時,使用者會看見「暫停播放今晚的節目」。
- 為了讓媒體播放器保持可攜性,如果 Google 助理知道目前播放的內容和目前播放的裝置的位置,當使用者在不同房間間移動時,Google 助理可以將該次播放內容轉移到其他裝置,或是將播放內容儲存至之後的任意裝置播放。
您可以利用這項特徵設定屬性,藉此指定解決方案提供的媒體狀態層級和麵向。這類屬性通常會與 TransportControl
特徵搭配使用
裝置屬性
具有此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求一文。
屬性 | 類型 | 說明 |
---|---|---|
supportActivityState |
布林 |
(預設: 指出裝置是否能回報活動狀態。 |
supportPlaybackState |
布林 |
(預設: 指出裝置是否可以回報目前的播放狀態。 |
範例
用於回報活動及同步狀態的媒體裝置
{ "supportActivityState": true, "supportPlaybackState": true }
裝置狀態:STATE
具有此特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求一文。
州 | 類型 | 說明 |
---|---|---|
activityState |
字串 |
指出裝置是否處於啟用狀態,且使用者正在與裝置互動。 支援的值:
|
playbackState |
字串 |
指定播放媒體時的目前狀態。 支援的值:
|
範例
同時回報活動和播放狀態的媒體裝置
{ "activityState": "ACTIVE", "playbackState": "PAUSED" }
裝置指令
無。