MediaStream: getTrackById() Methode
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.
Die getTrackById()
Methode der MediaStream
Schnittstelle
gibt ein MediaStreamTrack
Objekt zurück, das die Spur mit der angegebenen ID-Zeichenfolge repräsentiert. Wenn es keine Spur mit der angegebenen ID gibt, gibt diese Methode null
zurück.
Syntax
getTrackById(id)
Parameter
id
-
Eine Zeichenfolge, die die zurückzugebende Spur identifiziert.
Rückgabewert
Wenn eine Spur gefunden wird, für die MediaStreamTrack.id
mit der angegebenen
id
-Zeichenfolge übereinstimmt, wird dieses MediaStreamTrack
Objekt zurückgegeben.
Andernfalls ist der zurückgegebene Wert null
.
Beispiele
Dieses Beispiel aktiviert eine Kommentatorspur auf einem Video, indem es das Audiolevel der Hauptaudiospur auf 50% reduziert und dann die Kommentatorspur aktiviert.
Das Beispiel geht davon aus, dass die IDs der beiden Spuren bekannt sind (zum Beispiel aus einem vorherigen Aufruf von MediaStreamTrack.id
). In einer realen Anwendung könnten Sie diese IDs speichern, wenn Sie den Stream zum ersten Mal erhalten, da sie im Browser zufällig generiert werden.
const primaryAudioTrack = stream.getTrackById(
"69f8520f-d94e-43f0-8a7c-77b1774f3b8f",
);
const commentaryTrack = stream.getTrackById(
"b5410643-2549-491e-b0f7-f08a4ebe54b8",
);
primaryAudioTrack.applyConstraints({ volume: 0.5 });
commentaryTrack.enabled = true;
Spezifikationen
Specification |
---|
Media Capture and Streams> # dom-mediastream-gettrackbyid> |
Browser-Kompatibilität
Loading…