Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
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.

js
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

Siehe auch