ControlMediaコマンド

Note: Sign in to the developer console to build or publish your skill.

ControlMediaコマンド

メディアプレイヤーの再生、一時停止、トラックの変更、その他の一般的な操作の実行を制御します。

プロパティ

ControlMediaコマンドには、標準のコマンドプロパティに加えて、以下の表に示すプロパティがあります。typeプロパティをControlMediaに設定します。

コマンドを実行するために値が必要なプロパティの場合、以下の表の「デフォルト」列に「必須」と表示されています。それ以外の場合はデフォルト値が表示されますが、デフォルト値がないこともあります。

プロパティ	型	デフォルト	説明
`command`	commandからの列挙値	必須	メディアプレイヤーで発行するコマンドです（`play`など）。
`componentId`	Selector	`:source`	Videoコンポーネントです。
`value`	整数	0	`seek`、`seekTo`、`setTrack`の各コマンドに必要なオプションのデータ値です。

次に例を示します。

{
  "type": "ControlMedia",
  "componentId": "myAudioPlayer",
  "command": "next"
}

ControlMediaコマンドは、playサブコマンドを除き、すべての操作を高速モードでサポートしています。

command

command列挙値で、メディアプレイヤーで実行される操作を指定します。以下の表に、利用可能なコマンドを示します。

プロパティ	再生／一時停止の状態	値	高速モード	説明
`play`	再生中	—	×	メディア再生を開始します。
`pause`	一時停止	—	◯	メディア再生を停止します。
`next`	一時停止	—	◯	ソース配列で次のメディアトラックに進みます。
`previous`	一時停止	—	◯	ソース配列で前のメディアトラックに戻ります。
`rewind`	一時停止	—	◯	再生中のメディアトラックを最初まで早戻しします。
`seek`	保持	相対オフセット（ミリ秒）	◯	メディアの再生位置を指定された`value`にオフセットします。
`seekTo`	保持	絶対時間（ミリ秒）	◯	メディアの再生位置を指定された`value`に設定します。
`setTrack`	一時停止	トラックインデックス	◯	ソース配列の現在のトラックを、指定された`value`にあるトラックに変更します。

play

現在のメディアトラックと位置からの再生を開始します。このコマンドは、ビデオトラックの現在のリピートカウンターには影響しません。ビデオが再生されていない場合、play操作によってonPlayイベントが生成されます。

{
  "type": "ControlMedia",
  "componentId": "myAudioPlayer",
  "command": "play"
}

pause

ビデオ再生を一時停止します。ビデオが既に再生中の場合、pause操作によってonPauseイベントが生成されます。

{
  "type": "ControlMedia",
  "componentId": "myAudioPlayer",
  "command": "pause"
}

ビデオ再生を一時停止して、次のビデオトラックの先頭に移動します。リピートカウンターは、新しいビデオトラックにも適用されます。たとえば、このビデオトラックが2回繰り返すように設定されている場合、playコマンドを実行すると、この新しいビデオトラックが合計3回再生されることになります。ビデオプレイヤーが既に最後のビデオトラックである場合、ビデオのシーク位置は最後のビデオトラックの末尾に移動し、リピートカウンターはゼロにリセットされます。

次に例を示します。

{
  "type": "ControlMedia",
  "componentId": "myAudioPlayer",
  "command": "next"
}

このコマンドを呼び出しても、ビデオ再生は自動的に開始されません。ビデオ再生を開始するには、明示的にplayコマンドを開始する必要があります。

ビデオ再生を一時停止して、前のビデオトラックの先頭に移動します。リピートカウンターは、新しいビデオトラックにも適用されます。たとえば、このビデオトラックが2回繰り返すように設定されている場合、playコマンドを実行すると、この新しいビデオトラックが合計3回再生されることになります。ビデオプレイヤーが既に最初のビデオトラックである場合、ビデオのシーク位置は最初のビデオトラックの先頭に移動し、リピートカウンターはリロードされます。

次に例を示します。

{
  "type": "ControlMedia",
  "componentId": "myAudioPlayer",
  "command": "previous"
}

rewind

ビデオ再生を一時停止して、現在のビデオトラックをリロードします。新しいビデオトラックのリピートカウンターはリロードされます。

次に例を示します。

{
  "type": "ControlMedia",
  "componentId": "myAudioPlayer",
  "command": "rewind"
}

seek

プレイヤーの再生位置に相対的な変更を適用します。この値は、プレイヤーの現在位置に相対的で、現在のトラックの有効な範囲に合わせて切り取られます。seek操作では、ビデオ再生の状態が保持されます。seekコマンドを発行したときにビデオが再生中の場合、ビデオは新しい位置にジャンプして再生を続けます。seekコマンドを発行したときにビデオが一時停止していた場合、ビデオは一時停止したまま新しい位置にジャンプします。

たとえば、ビデオトラックが切り取られた、以下のようなVideoコンポーネントがあるとします。

{
  "type": "Video",
  "id": "MyVideoPlayer",
  "source": {
    "url": "http://example.com/example.mp4",
    "offset": 500,
    "duration": 1000
  }
}

以下のコマンドを実行するとき、プレイヤーの速度が700ミリ秒であると仮定します。

{
  "type": "ControlMedia",
  "componentId": "MyVideoPlayer",
  "command": "seek",
  "value": 500
}

このコマンドによって、プレイヤーの再生位置が1200ミリ秒（700+500）に移動します。同じコマンドをもう一度実行すると、ソースの定義でプレイヤーの再生位置が500～1500ミリ秒の間に限定されているため、再生位置は1700ミリ秒ではなく1500ミリ秒に移動します。

seekコマンドは、現在のビデオトラックのリピートカウンターを変更しません。

seekTo

プレイヤーの位置を絶対値に設定します。この位置は、現在のトラックの有効な範囲に合わせて切り取られます。seekTo操作では、ビデオ再生の状態が保持されます。seekToコマンドを発行したときにビデオが再生中の場合、ビデオは新しい位置にジャンプして再生を続けます。seekToコマンドを発行したときにビデオが一時停止していた場合、ビデオは一時停止したまま新しい位置にジャンプします。

たとえば、ビデオトラックが切り取られた、以下のようなVideoコンポーネントがあるとします。

{
  "type": "Video",
  "id": "MyVideoPlayer",
  "source": {
    "url": "http://example.com/example.mp4",
    "offset": 500,
    "duration": 1000
  }
}

以下のコマンドを実行すると、ビデオの再生位置は900ミリ秒にジャンプします。

{
  "type": "ControlMedia",
  "componentId": "MyVideoPlayer",
  "command": "seekTo",
  "value": 900
}

トラックの有効な範囲外に移動しようとするコマンドを実行すると、ビデオはトラックの範囲に合わせて切り取られます。たとえば、以下のコマンドはプレイヤーの再生位置を500ミリ秒に移動します。

{
  "type": "ControlMedia",
  "componentId": "MyVideoPlayer",
  "command": "seekTo",
  "value": 10
}

seekToコマンドは、現在のビデオトラックのリピートカウンターを変更しません。

setTrack

ビデオ再生を一時停止して、現在のトラックを変更します。トラックの0から始まるインデックスを、コマンドのvalueプロパティに渡します。このインデックスは、ソース配列内の有効なインデックスである必要があり、有効でない場合はコマンドが無視されます。トラックが変更されなくても、トラックのリピートカウンターはリロードされます。

次に例を示します。

{
  "type": "ControlMedia",
  "componentId": "myAudioPlayer",
  "command": "setTrack",
  "value": 2
}

componentId

Videoコンポーネントを識別するセレクターです。これを指定しない場合、デフォルトで:sourceになります。:sourceセレクターは、ControlMediaコマンドを発行したコンポーネントをターゲットにします。

value

コマンドに設定する値です。seek、seekTo、setTrackの各コマンドのvalueを設定します。

このページは役に立ちましたか？

フィードバックを送信

最終更新日: 2025 年 12 月 02 日

ControlMediaコマンド

プロパティ

command

play

pause

next

previous

rewind

seek

seekTo

setTrack

componentId

value

関連トピック