MediaStreamTrack

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.

* Some parts of this feature may have varying levels of support.

Das MediaStreamTrack-Interface der Media Capture and Streams API repräsentiert eine einzelne Medienspur innerhalb eines Streams. Typischerweise handelt es sich um Audio- oder Videospuren, aber es können auch andere Spurtypen existieren.

Einige User Agents unterklassifizieren dieses Interface, um genauere Informationen oder Funktionalitäten bereitzustellen, wie z.B. CanvasCaptureMediaStreamTrack.

Instanz-Eigenschaften

Zusätzlich zu den unten aufgelisteten Eigenschaften verfügt MediaStreamTrack über einschränkbare Eigenschaften, die mit applyConstraints() gesetzt und mit getConstraints() und getSettings() abgerufen werden können. Siehe Fähigkeiten, Einschränkungen und Einstellungen, um zu erfahren, wie man korrekt mit einschränkbaren Eigenschaften arbeitet. Bei falscher Anwendung wird Ihr Code unzuverlässig.

MediaStreamTrack.contentHint

Ein String, der von der Webanwendung verwendet werden kann, um einen Hinweis auf die Art des Inhalts der Spur zu geben, um zu steuern, wie diese von API-Verbrauchern behandelt werden sollte. Zulässige Werte hängen vom Wert der MediaStreamTrack.kind-Eigenschaft ab.

MediaStreamTrack.enabled

Ein Boolean, dessen Wert true ist, wenn die Spur aktiviert ist, d.h. sie darf den Media-Quellenstrom wiedergeben; oder false, wenn sie deaktiviert ist und den Media-Quellenstrom, sondern Stille und Schwärze nicht wiedergibt. Wenn die Spur getrennt wurde, kann dieser Wert geändert werden, hat aber keine Wirkung mehr.

Hinweis: Sie können die Standard-"Stummschalten"-Funktionalität implementieren, indem Sie enabled auf false setzen. Die muted-Eigenschaft bezieht sich auf einen Zustand, in dem aufgrund eines technischen Problems keine Medien vorhanden sind.

MediaStreamTrack.id Schreibgeschützt

Gibt einen String zurück, der eine eindeutige Kennung (GUID) für die Spur enthält; sie wird vom Browser generiert.

MediaStreamTrack.kind Schreibgeschützt

Gibt einen String zurück, der auf "audio" gesetzt ist, wenn die Spur eine Audiospur ist, und auf "video", wenn es eine Videospur ist. Dies ändert sich nicht, wenn die Spur von ihrer Quelle getrennt wird.

MediaStreamTrack.label Schreibgeschützt

Gibt einen String zurück, der ein vom User Agent zugewiesenes Label enthält, das die Spurquelle identifiziert, etwa "internal microphone". Der String kann leer bleiben und ist leer, solange keine Quelle verbunden wurde. Wenn die Spur von ihrer Quelle getrennt wird, ändert sich das Label nicht.

MediaStreamTrack.muted Schreibgeschützt

Gibt einen Boolean-Wert zurück, der angibt, ob die Spur aufgrund eines technischen Problems keine Mediendaten bereitstellen kann.

Hinweis: Sie können die Standard-"Stummschalten"-Funktionalität implementieren, indem Sie enabled auf false setzen, und die Medien wieder aktivieren, indem Sie es zurück auf true setzen.

MediaStreamTrack.readyState Schreibgeschützt

Gibt einen enumerierten String zurück, der den Status der Spur angibt. Dies wird einer der folgenden Werte sein:

"live" weist darauf hin, dass ein Eingabegerät angeschlossen ist und sein Bestes gibt, um Echtzeitdaten bereitzustellen. In diesem Fall kann die Ausgabe von Daten mit dem Attribut enabled ein- oder ausgeschaltet werden.
"ended" zeigt an, dass die Eingabe keine Daten mehr liefert und niemals neue Daten bereitstellen wird.

Instanz-Methoden

MediaStreamTrack.applyConstraints(): Ermöglicht der Anwendung, die idealen und/oder akzeptablen Wertebereiche für beliebige Anzahl verfügbarer einschränkbarer Eigenschaften des MediaStreamTrack festzulegen.
MediaStreamTrack.clone(): Gibt ein Duplikat des MediaStreamTrack zurück.
MediaStreamTrack.getCapabilities(): Gibt ein Objekt zurück, das die akzeptierten Werte oder Wertebereiche für jede einschränkbare Eigenschaft des zugehörigen MediaStreamTrack detailliert beschreibt.
MediaStreamTrack.getConstraints(): Gibt ein MediaTrackConstraints-Objekt zurück, das die aktuell gesetzten Einschränkungen für die Spur enthält; der zurückgegebene Wert entspricht den zuletzt mit applyConstraints() gesetzten Einschränkungen.
MediaStreamTrack.getSettings(): Gibt ein MediaTrackSettings-Objekt zurück, das die aktuellen Werte jeder einschränkbaren Eigenschaft des MediaStreamTrack enthält.
MediaStreamTrack.stop(): Stoppt die Wiedergabe der mit der Spur verknüpften Quelle, wobei sowohl die Quelle als auch die Spur getrennt werden. Der Spurstatus wird auf ended gesetzt.

Ereignisse

Hören Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Ereignis-Listener der oneventname-Eigenschaft dieses Interfaces zuweisen:

ended: Wird gesendet, wenn die Wiedergabe der Spur endet (wenn sich der Wert readyState in ended ändert), außer wenn die Spur durch Aufrufen von MediaStreamTrack.stop beendet wird.
mute: Wird an MediaStreamTrack gesendet, wenn der Wert der muted-Eigenschaft auf true geändert wird, was darauf hinweist, dass die Spur vorübergehend keine Daten bereitstellen kann (etwa wenn das Netzwerk eine Dienststörung erfährt).
unmute: Wird an die Spur gesendet, wenn Daten wieder verfügbar werden und der muted-Zustand beendet wird.

Spezifikationen

Specification
Media Capture and Streams # mediastreamtrack