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.
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.
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.
Ein Boolean mit dem Wert true, wenn die Spur aktiviert ist, das heißt, der Medienquellenstream abgespielt werden darf; oder false, 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 auf false setzen. Die muted-Eigenschaft bezieht sich auf eine Bedingung, bei der aufgrund eines technischen Problems kein Medium vorhanden ist.
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.
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.
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 auf false setzen und das Medium durch Zurücksetzen auf true wieder aktivieren.
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 Attribut enabled ein- oder ausgeschaltet werden.
"ended", was bedeutet, dass der Eingang keine Daten mehr liefert und auch keine neuen Daten mehr bereitstellen wird.
Ermöglicht der Anwendung, die idealen und/oder akzeptablen Wertebereiche für eine beliebige Anzahl der verfügbaren einschränkbaren Eigenschaften der MediaStreamTrack vorzugeben.
Gibt ein Objekt zurück, das die akzeptierten Werte oder den Wertebereich für jede einschränkbare Eigenschaft der zugehörigen MediaStreamTrack detailliert beschreibt.
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 mit applyConstraints() gesetzten Einschränkungen.
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.
Hören Sie diese Ereignisse mithilfe von addEventListener() oder durch Zuordnen eines Ereignis-Listeners zur oneventname-Eigenschaft dieser Schnittstelle:
Wird gesendet, wenn die Wiedergabe der Spur endet (wenn sich der Wert von readyState zu ended ändert), außer wenn die Spur durch Aufruf von MediaStreamTrack.stop beendet wird.
Wird an die MediaStreamTrack gesendet, wenn der Wert der muted-Eigenschaft auf true geändert wird, was anzeigt, dass die Spur vorübergehend keine Daten liefern kann (z.B. wenn das Netzwerk eine Dienststörung hat).
Tip: you can click/tap on a cell for more information.
Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
Requires a vendor prefix or different name for use.
Has more compatibility info.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.