Media Capture and Streams API (Media Stream)

We’d love to hear your thoughts on the next set of proposals for the JavaScript language. You can find a description of the proposals here.
Please take two minutes to fill out our short survey.

Die Media Capture and Streams API, oft als Media Streams API oder MediaStream API bezeichnet, ist eine API im Zusammenhang mit WebRTC, die Unterstützung für das Streamen von Audio- und Videodaten bietet.

Sie bietet die Schnittstellen und Methoden zum Arbeiten mit den Streams und deren einzelnen Tracks, Einschränkungen in Bezug auf Datenformate, Erfolgs- und Fehler-Callbacks bei der asynchronen Nutzung der Daten und die Ereignisse, die während des Prozesses ausgelöst werden.

Konzepte und Verwendung

Die API basiert auf der Manipulation eines MediaStream-Objekts, das einen Fluss von Audio- oder videobezogenen Daten darstellt. Sehen Sie ein Beispiel unter Den Medienstream erhalten.

Ein MediaStream besteht aus null oder mehr MediaStreamTrack-Objekten, die verschiedene Audio- oder Video-Tracks repräsentieren. Jeder MediaStreamTrack kann einen oder mehrere Kanäle haben. Der Kanal stellt die kleinste Einheit eines Medienstreams dar, wie z.B. ein Audiosignal, das einem bestimmten Lautsprecher zugeordnet ist, etwa links oder rechts in einem Stereo-Audiotrack.

MediaStream-Objekte haben einen einzigen Eingang und einen einzigen Ausgang. Ein durch getUserMedia() erzeugtes MediaStream-Objekt wird lokal genannt und hat als Eingangsquelle eine der Kameras oder Mikrofone des Benutzers. Ein nicht-lokales MediaStream kann ein Medienelement wie <video> oder <audio> darstellen, einen über das Netzwerk kommenden Stream, der über die WebRTC-API RTCPeerConnection erhalten wurde, oder einen Stream, der unter Verwendung der Web Audio API MediaStreamAudioDestinationNode erstellt wurde.

Der Ausgang des MediaStream-Objekts ist mit einem Verbraucher verbunden. Dies kann ein Medienelement wie <audio> oder <video> sein, die WebRTC-API RTCPeerConnection oder ein Web Audio API MediaStreamAudioSourceNode.

Schnittstellen

In diesen Referenzartikeln finden Sie die grundlegenden Informationen, die Sie über jede der Schnittstellen der Media Capture and Streams API wissen müssen.

Ereignisse

Leitfäden und Tutorials

Der Artikel Fähigkeiten, Einschränkungen und Einstellungen behandelt die Konzepte von Einschränkungen und Fähigkeiten sowie Medieneinstellungen und enthält einen Einschränkungs-Übungsbereich, mit dem Sie die Ergebnisse verschiedener Einschränkungssätze testen können, die auf die Audio- und Videotracks der A/V-Eingabegeräte des Computers (wie seine Webcam und sein Mikrofon) angewendet werden.

Der Artikel Stillfotos mit getUserMedia() aufnehmen zeigt, wie getUserMedia() verwendet wird, um auf die Kamera eines Computers oder Mobiltelefons zuzugreifen, das getUserMedia() unterstützt, und damit ein Foto aufzunehmen.

Spezifikationen

Specification
Media Capture and Streams
Media Capture from DOM Elements

Browser-Kompatibilität

api.MediaStream

api.MediaStreamTrack

api.MediaDevices

api.MediaDeviceInfo

api.InputDeviceInfo

api.CanvasCaptureMediaStreamTrack

Siehe auch