スマートホームの MediaState トレイトのスキーマ
action.devices.traits.MediaState - このトレイトは、メディアの状態を報告できるデバイスに使用します。
MediaState トレイトは次の目的でアシスタントによって使用されます。
- 各デバイスで再生されているものが、アシスタントによって再生が開始されたかどうかを知るため。この情報は、アシスタントがユーザーのインテントを詳細に理解するのに役立ちます。たとえば、ユーザーの実際のインテントが「今夜の番組を再生しているデバイスを一時停止」であれば、「今夜の番組を一時停止して」と話しかけます。
- メディア プレーヤー間のポータビリティのため - アシスタントが再生中の曲と現在の再生位置を認識している場合、ユーザーが部屋を移動したときにその再生を別のデバイスに転送したり、後で任意のデバイスで再生を保存したりできます。
このトレイトの属性を構成することで、ソリューションが提供するメディア状態のレベルとアスペクトを指定できます。通常、このトレイトは TransportControl トレイトと組み合わせて使用します。
デバイスの属性
このトレイトを持つデバイスは、SYNC オペレーションの一部として次の属性を報告できます。SYNC インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。
| 属性 | タイプ | 説明 |
|---|---|---|
supportActivityState |
ブール値 |
（デフォルト: デバイスがアクティビティの状態を報告できるかどうかを指定します。 |
supportPlaybackState |
ブール値 |
（デフォルト: デバイスが現在の再生状態を報告できるかどうかを示します。 |
例
SYNC レスポンスのアクティビティと再生状態の両方をレポートするメディア デバイス
{
"supportActivityState": true,
"supportPlaybackState": true
}
デバイスのステータス
このトレイトを使用するエンティティは、QUERY オペレーションの一部として次の状態を報告できます。QUERY インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。
| 状態 | タイプ | 説明 |
|---|---|---|
activityState |
String |
デバイスがアクティブで、ユーザーが積極的に操作しているかどうかを示します。 サポートされる値:
|
playbackState |
String |
メディアを再生する際の現在の状態を示します。 サポートされる値:
|
例
アクティビティと再生状態の両方をレポートするメディア デバイス
{
"activityState": "ACTIVE",
"playbackState": "PAUSED"
}
デバイスのコマンド
なし。