MediaStream: getTrackById() メソッド

getTrackById()MediaStream インターフェイスのメソッドで、指定された ID 文字列を持つトラックを表現する MediaStreamTrack オブジェクトを返します。指定した ID を持つトラックが存在しない場合は、 null を返します。

構文

js
getTrackById(id)

引数

id

取得したいトラックを識別する文字列です。

返値

引数で指定した id の文字列と同じ MediaStreamTrack.id を持つトラックが見つかった場合は、その MediaStreamTrack オブジェクトを返します。それ以外の場合は、 null を返します。

この例では、動画に含まれるコメンタリートラックを有効にしています。メインのオーディオトラックの音量を 50% にしてから、コメンタリートラックを有効にしています。

js
stream.getTrackById("primary-audio-track").applyConstraints({ volume: 0.5 });
stream.getTrackById("commentary-track").enabled = true;

仕様書

Specification
Media Capture and Streams
# dom-mediastream-gettrackbyid

ブラウザーの互換性

BCD tables only load in the browser

関連情報