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⁩.

DasMediaStream-Interface derMedia Capture and Streams API repräsentiert einen Stream von Medieninhalten. Ein Stream besteht aus mehrerenTracks, wie zum Beispiel Video- oder Audiotracks. Jeder Track ist als Instanz vonMediaStreamTrack spezifiziert.

Sie können einMediaStream-Objekt entweder durch die Verwendung des Konstruktors oder durch Aufrufen von Funktionen wieMediaDevices.getUserMedia(),MediaDevices.getDisplayMedia(), oderHTMLCanvasElement.captureStream() undHTMLMediaElement.captureStream() erhalten.

Konstruktor

MediaStream(): Erstellt und gibt ein neuesMediaStream-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 vonMediaStreamTrack-Objekten).

Instanz-Eigenschaften

Dieses Interface erbt Eigenschaften von seinem Elternteil,EventTarget.

MediaStream.activeSchreibgeschützt: Ein Boolescher Wert, dertrue zurückgibt, wenn dasMediaStream aktiv ist, oderfalse andernfalls.
MediaStream.idSchreibgeschü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 gegebenenMediaStreamTrack. Wenn der Track bereits zumMediaStream-Objekt hinzugefügt wurde, passiert nichts.
MediaStream.clone(): Gibt einen Klon desMediaStream-Objekts zurück. Der Klon wird jedoch einen einzigartigen Wert fürid haben.
MediaStream.getAudioTracks(): Gibt eine Liste der imMediaStream-Objekt gespeichertenMediaStreamTrack-Objekte zurück, derenkind-Attribut aufaudio 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, wirdnull zurückgegeben. Wenn mehrere Tracks die gleiche ID haben, wird der erste zurückgegeben.
MediaStream.getTracks(): Gibt eine Liste aller imMediaStream-Objekt gespeichertenMediaStreamTrack-Objekte zurück, unabhängig vom Wert deskind-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 imMediaStream-Objekt gespeichertenMediaStreamTrack-Objekte zurück, derenkind-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 gegebenenMediaStreamTrack. Wenn der Track nicht Teil desMediaStream-Objekts ist, passiert nichts.

Ereignisse

addtrack: Wird ausgelöst, wenn ein neuesMediaStreamTrack-Objekt hinzugefügt wird.
removetrack: Wird ausgelöst, wenn einMediaStreamTrack-Objekt entfernt wurde.
activeNicht standardisiert: Wird ausgelöst, wenn das MediaStream aktiviert wird.
inactiveNicht standardisiert: Wird ausgelöst, wenn das MediaStream deaktiviert wird.

Spezifikationen

Specification
Media Capture and Streams # mediastream

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen •Fehler mit dieser Übersetzung melden

Movatterモバイル変換