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.
Die MediaStreamTrack
-Schnittstelle der Media Capture and Streams API repräsentiert eine einzelne Medienspur innerhalb eines Streams; in der Regel handelt es sich dabei um Audio- oder Videospuren, aber auch andere Spurtypen können existieren.
Einige Benutzeragenten unterklassen diese Schnittstelle, um genauere Informationen oder Funktionen bereitzustellen, wie zum Beispiel CanvasCaptureMediaStreamTrack
.
Instanz-Eigenschaften
Zusätzlich zu den unten aufgeführten Eigenschaften hat MediaStreamTrack
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. Ein inkorrektes Vorgehen führt dazu, dass Ihr Code unzuverlässig wird.
MediaStreamTrack.contentHint
-
Ein String, der von der Webanwendung verwendet werden kann, um einen Hinweis darauf zu geben, welche Art von Inhalt die Spur enthält, um zu steuern, wie sie von API-Verbrauchern behandelt werden soll. Erlaubte Werte hängen vom Wert der
MediaStreamTrack.kind
-Eigenschaft ab. MediaStreamTrack.enabled
-
Ein Boolean mit dem Wert
true
, wenn die Spur aktiviert ist, das heißt, der Medienquellenstream abgespielt werden darf; oderfalse
, wenn sie deaktiviert ist, das heißt, sie stellt den Medienquellenstream nicht dar, sondern liefert Stille und Schwärze. Wenn die Spur getrennt wurde, kann dieser Wert geändert werden, hat jedoch keine weitere Wirkung.Hinweis: Sie können eine standardmäßige Stummschaltfunktionalität implementieren, indem Sie
enabled
auffalse
setzen. Diemuted
-Eigenschaft bezieht sich auf eine Bedingung, bei der aufgrund eines technischen Problems kein Medium vorhanden ist. MediaStreamTrack.id
Nur lesbar-
Gibt einen String zurück, der eine eindeutige Kennung (GUID) für die Spur enthält; sie wird vom Browser generiert.
MediaStreamTrack.kind
Nur lesbar-
Gibt einen String zurück, der auf
"audio"
gesetzt ist, wenn die Spur eine Audiospur ist, und auf"video"
, wenn sie eine Videospur ist. Es ändert sich nicht, wenn die Spur von ihrer Quelle getrennt wird. MediaStreamTrack.label
Nur lesbar-
Gibt einen String zurück, der eine vom Benutzeragenten zugewiesene Kennzeichnung enthält, die die Spurquelle identifiziert, wie in
"internal microphone"
. Der String kann leer bleiben und ist leer, solange keine Quelle verbunden ist. Wenn die Spur von ihrer Quelle getrennt wird, ändert sich die Kennzeichnung nicht. MediaStreamTrack.muted
Nur lesbar-
Gibt einen Boolean-Wert zurück, der angibt, ob die Spur aufgrund eines technischen Problems keine Mediendaten bereitstellen kann.
Hinweis: Sie können eine standardmäßige Stummschaltfunktionalität implementieren, indem Sie
enabled
auffalse
setzen und das Medium durch Zurücksetzen auftrue
wieder aktivieren. MediaStreamTrack.readyState
Nur lesbar-
Gibt einen enumerierten String zurück, der den Status der Spur angibt. Dies ist einer der folgenden Werte:
"live"
, was bedeutet, dass ein Eingang verbunden ist und sein Bestes tut, um in Echtzeit Daten bereitzustellen. In diesem Fall kann die Ausgabe der Daten über das Attributenabled
ein- oder ausgeschaltet werden."ended"
, was bedeutet, dass der Eingang keine Daten mehr liefert und auch keine neuen Daten mehr bereitstellen wird.
Instanz-Methoden
MediaStreamTrack.applyConstraints()
-
Ermöglicht der Anwendung, die idealen und/oder akzeptablen Wertebereiche für eine beliebige Anzahl der verfügbaren einschränkbaren Eigenschaften der
MediaStreamTrack
vorzugeben. MediaStreamTrack.clone()
-
Gibt eine Kopie der
MediaStreamTrack
zurück. MediaStreamTrack.getCapabilities()
-
Gibt ein Objekt zurück, das die akzeptierten Werte oder den Wertebereich für jede einschränkbare Eigenschaft der zugehörigen
MediaStreamTrack
detailliert beschreibt. MediaStreamTrack.getConstraints()
-
Gibt ein
MediaTrackConstraints
-Objekt zurück, das die derzeit gesetzten Einschränkungen für die Spur enthält; der zurückgegebene Wert entspricht den zuletzt mitapplyConstraints()
gesetzten Einschränkungen. MediaStreamTrack.getSettings()
-
Gibt ein
MediaTrackSettings
-Objekt zurück, das die aktuellen Werte jeder der einschränkbaren Eigenschaften derMediaStreamTrack
enthält. MediaStreamTrack.stop()
-
Stoppt das Abspielen der mit der Spur verbundenen Quelle, sowohl die Quelle als auch die Spur werden getrennt. Der Zustand der Spur wird auf
ended
gesetzt.
Ereignisse
Hören Sie diese Ereignisse mithilfe von addEventListener()
oder durch Zuordnen eines Ereignis-Listeners zur oneventname
-Eigenschaft dieser Schnittstelle:
ended
-
Wird gesendet, wenn die Wiedergabe der Spur endet (wenn sich der Wert von
readyState
zuended
ändert), außer wenn die Spur durch Aufruf vonMediaStreamTrack.stop
beendet wird. mute
-
Wird an die
MediaStreamTrack
gesendet, wenn der Wert dermuted
-Eigenschaft auftrue
geändert wird, was anzeigt, dass die Spur vorübergehend keine Daten liefern kann (z.B. wenn das Netzwerk eine Dienststörung hat). unmute
-
Wird an die Spur gesendet, wenn wieder Daten verfügbar sind und der
muted
-Zustand endet.
Spezifikationen
Specification |
---|
Media Capture and Streams # mediastreamtrack |
Browser-Kompatibilität
BCD tables only load in the browser