MediaStream

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.

Das MediaStream-Interface der Media Capture and Streams API repräsentiert einen Stream von Medieninhalten. Ein Stream besteht aus mehreren Tracks, wie zum Beispiel Video- oder Audiotracks. Jeder Track ist als Instanz von MediaStreamTrack spezifiziert.

Sie können ein MediaStream-Objekt entweder durch die Verwendung des Konstruktors oder durch Aufrufen von Funktionen wie MediaDevices.getUserMedia(), MediaDevices.getDisplayMedia(), oder HTMLCanvasElement.captureStream() und HTMLMediaElement.captureStream() erhalten.

EventTarget MediaStream

Konstruktor

MediaStream()

Erstellt und gibt ein neues MediaStream-Objekt zurück. Sie können einen leeren Stream, einen Stream, der auf einem bestehenden Stream basiert, oder einen Stream erstellen, der eine spezifizierte Liste von Tracks enthält (angegeben als Array von MediaStreamTrack-Objekten).

Instanz-Eigenschaften

Dieses Interface erbt Eigenschaften von seinem Elternteil, EventTarget.

MediaStream.active Schreibgeschützt

Ein Boolescher Wert, der true zurückgibt, wenn das MediaStream aktiv ist, oder false andernfalls.

MediaStream.id Schreibgeschützt

Ein String, der eine 36-stellige universell eindeutige Kennung (UUID) für das Objekt enthält.

Instanz-Methoden

Dieses Interface erbt Methoden von seinem Elternteil, EventTarget.

MediaStream.addTrack()

Speichert eine Kopie des als Argument gegebenen MediaStreamTrack. Wenn der Track bereits zum MediaStream-Objekt hinzugefügt wurde, passiert nichts.

MediaStream.clone()

Gibt einen Klon des MediaStream-Objekts zurück. Der Klon wird jedoch einen einzigartigen Wert für id haben.

MediaStream.getAudioTracks()

Gibt eine Liste der im MediaStream-Objekt gespeicherten MediaStreamTrack-Objekte zurück, deren kind-Attribut auf audio gesetzt ist. Die Reihenfolge ist nicht definiert und kann nicht nur von einem Browser zum anderen variieren, sondern auch von einem Aufruf zum anderen.

MediaStream.getTrackById()

Gibt den Track zurück, dessen ID mit der im Parameter angegebenen ID, trackId, übereinstimmt. Wenn kein Parameter angegeben ist oder wenn kein Track mit dieser ID existiert, wird null zurückgegeben. Wenn mehrere Tracks die gleiche ID haben, wird der erste zurückgegeben.

MediaStream.getTracks()

Gibt eine Liste aller im MediaStream-Objekt gespeicherten MediaStreamTrack-Objekte zurück, unabhängig vom Wert des kind-Attributs. Die Reihenfolge ist nicht definiert und kann nicht nur von einem Browser zum anderen variieren, sondern auch von einem Aufruf zum anderen.

MediaStream.getVideoTracks()

Gibt eine Liste der im MediaStream-Objekt gespeicherten MediaStreamTrack-Objekte zurück, deren kind-Attribut auf "video" gesetzt ist. Die Reihenfolge ist nicht definiert und kann nicht nur von einem Browser zum anderen variieren, sondern auch von einem Aufruf zum anderen.

MediaStream.removeTrack()

Entfernt den als Argument gegebenen MediaStreamTrack. Wenn der Track nicht Teil des MediaStream-Objekts ist, passiert nichts.

Ereignisse

addtrack

Wird ausgelöst, wenn ein neues MediaStreamTrack-Objekt hinzugefügt wird.

removetrack

Wird ausgelöst, wenn ein MediaStreamTrack-Objekt entfernt wurde.

active Nicht standardisiert

Wird ausgelöst, wenn das MediaStream aktiviert wird.

inactive Nicht standardisiert

Wird ausgelöst, wenn das MediaStream deaktiviert wird.

Spezifikationen

Specification
Media Capture and Streams
# mediastream

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
MediaStream
MediaStream() constructor
active
active event
Non-standard
addTrack
addtrack event
clone
getAudioTracks
getTrackById
getTracks
getVideoTracks
id
inactive event
Non-standard
removeTrack
removetrack event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Non-standard. Check cross-browser support before using.
See implementation notes.
Requires a vendor prefix or different name for use.
Has more compatibility info.

Siehe auch