MediaStream

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.

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

BCD tables only load in the browser