スマートホームの MediaState トレイトのスキーマ

action.devices.traits.MediaState - このトレイトは、メディアの状態をレポートできるデバイスに使用されます。

MediaState トレイトは次の目的でアシスタントによって使用されます。

  • 各デバイスで再生されているメディア、およびアシスタントが再生を開始したかどうかを確認します。この情報はアシスタントがユーザーの意図をよく理解するのに役立ちます。 たとえば、ユーザーの実際の意図が「現在、今夜の番組を再生しているデバイスを一時停止して」である場合に、「今夜の番組を一時停止して」と言うかもしれません
  • メディア プレーヤー間のポータビリティ - アシスタントが再生中の曲や現在の再生位置を知っている場合、ユーザーが部屋を移動したときに別のデバイスに再生を転送したり、後で任意のデバイスで再生するために保存したりできます。

このトレイトの属性を構成することで、ソリューションが提供するメディア状態のレベルと側面を指定できます。このトレイトは通常、TransportControl トレイトと組み合わせて使用します。

デバイスの属性

このトレイトを持つデバイスは、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"
}

デバイスのコマンド

なし。

デバイスエラー

エラーと例外の一覧をご覧ください。