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

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

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

  • 各デバイスで再生中のコンテンツ、再生済みかどうかを知るには 呼び出すことができます。この情報は、アシスタントがユーザーの意図をより深く理解するのに役立ちます。 たとえば、ユーザーの実際の意図が以下の場合、ユーザーは「Pause the Tonight Show」と言います。 「現在「Tonight Show」を再生しているデバイスを一時停止して」
  • メディア プレーヤー間でのポータビリティのため(再生中の曲とメディア プレーヤーをアシスタントが アシスタントはその再生位置を別のデバイスに転送して 別の部屋での移動や、後で任意のデバイスで再生できるよう保存できます。

ソリューションが提供するメディア状態のレベルと側面は、 このトレイトの属性を設定します。このトレイトは通常、 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"
}

デバイスのコマンド

なし。

デバイスエラー

詳しくは、 エラーと例外をご覧ください。