スマートホームの TransportControl トレイトのスキーマ
action.devices.traits.TransportControl
- このトレイトは、メディアの再生を操作できる(一時停止中に音楽を再開するなど)デバイスに使用します。
デバイスの属性
この特性を持つデバイスは、SYNC
オペレーションの一部として次の属性を報告する可能性があります。SYNC
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
属性 | タイプ | 説明 |
---|---|---|
transportControlSupportedCommands |
配列 |
必須。 このデバイスでサポートされているトランスポート制御コマンドを記述する文字列のリスト。 |
[item, ...] |
文字列 |
サポートされているコマンド。 サポートされている値:
|
例
再生コマンドをサポートするデバイス
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
デバイスのステータス
なし
デバイスのコマンド
この特性を持つデバイスは、EXECUTE
オペレーションの一部として次のコマンドに応答できます。EXECUTE
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
action.devices.commands.mediaStop
メディアの再生を一時停止します。
このコマンドには次の属性が必要です。{ "transportControlSupportedCommands": [ "STOP" ] }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
プロパティがありません |
例
パラメータなし
{ "command": "action.devices.commands.mediaStop", "params": {} }
action.devices.commands.mediaNext
次のメディア項目にスキップします。
このコマンドには次の属性が必要です。{ "transportControlSupportedCommands": [ "NEXT" ] }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
プロパティがありません |
例
パラメータなし
{ "command": "action.devices.commands.mediaNext", "params": {} }
action.devices.commands.mediaPrevious
前のメディア項目にスキップします。
このコマンドには次の属性が必要です。{ "transportControlSupportedCommands": [ "PREVIOUS" ] }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
プロパティがありません |
例
パラメータなし
{ "command": "action.devices.commands.mediaPrevious", "params": {} }
action.devices.commands.mediaPause
メディアの再生を一時停止します。
このコマンドには次の属性が必要です。{ "transportControlSupportedCommands": [ "PAUSE" ] }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
プロパティがありません |
例
パラメータなし
{ "command": "action.devices.commands.mediaPause", "params": {} }
action.devices.commands.mediaResume
メディアの再生を再開します。
このコマンドには次の属性が必要です。{ "transportControlSupportedCommands": [ "RESUME" ] }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
プロパティがありません |
例
パラメータなし
{ "command": "action.devices.commands.mediaResume", "params": {} }
action.devices.commands.mediaSeekRelative
相対位置までシークします。
このコマンドには次の属性が必要です。{ "transportControlSupportedCommands": [ "SEEK_RELATIVE" ] }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
relativePositionMs |
Integer |
必須。 シーク再生する順(正の整数)または後方(負の整数)のミリ秒。 |
例
10 秒早送り
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": 10000 } }
10 秒巻き戻し
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": -10000 } }
action.devices.commands.mediaSeekToPosition
絶対位置までシークします。
このコマンドには次の属性が必要です。{ "transportControlSupportedCommands": [ "SEEK_TO_POSITION" ] }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
absPositionMs |
Integer |
必須。 シークする絶対位置のミリ秒。 |
例
30 秒までシーク
{ "command": "action.devices.commands.mediaSeekToPosition", "params": { "absPositionMs": 30000 } }
action.devices.commands.mediaRepeatMode
リピート再生モードを設定します。
このコマンドには次の属性が必要です。{ "transportControlSupportedCommands": [ "SET_REPEAT" ] }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
isOn |
ブール値 |
必須。 リピート モードをオンにする場合は true、繰り返しモードをオフにする場合は false です。 |
isSingle |
ブール値 |
(デフォルト: 指定した場合、true はアイテムの繰り返しモードを有効にすることを意味し、false は通常の繰り返しモード(再生リストなど)をオンにすることを意味します。 |
例
繰り返す間隔
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true } }
リピート: オフ
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": false } }
1 つのトラックを繰り返す
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true, "isSingle": true } }
action.devices.commands.mediaShuffle
現在のプレイリストをシャッフルします。
このコマンドには次の属性が必要です。{ "transportControlSupportedCommands": [ "SHUFFLE" ] }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
プロパティがありません |
例
パラメータなし
{ "command": "action.devices.commands.mediaShuffle", "params": {} }
action.devices.commands.mediaClosedCaptioningOn
字幕をオンにする。
このコマンドには次の属性が必要です。{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
closedCaptioningLanguage |
文字列 |
字幕の言語または地域。 |
userQueryLanguage |
文字列 |
ユーザークエリの言語または言語 / 地域。 |
例
英語の字幕をオンにする
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "en" } }
韓国語の字幕をオンにする
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR" } }
アメリカ英語のユーザークエリを使用して、韓国語の字幕をオンにする
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR", "userQueryLanguage": "en-US" } }
action.devices.commands.mediaClosedCaptioningOff
字幕をオフにする。
このコマンドには次の属性が必要です。{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
プロパティがありません |
例
字幕をオフにする
{ "command": "action.devices.commands.mediaClosedCaptioningOff", "params": {} }