MediaStream: getTrackById() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

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

関連情報