Media Capture and Streams API (Media Stream)

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

Sie bietet die Schnittstellen und Methoden zum Arbeiten mit Streams und deren einzelnen Tracks, die Einschränkungen im Zusammenhang mit Datenformaten, die Erfolgs- und Fehlerrückrufe bei der asynchronen Nutzung der Daten sowie die Ereignisse, die während des Prozesses ausgelöst werden.

Konzepte und Nutzung

Die API basiert auf der Manipulation eines MediaStream-Objekts, das einen Fluss von Audio- oder videobezogenen Daten darstellt. Siehe ein Beispiel in Erhalte den Medien-Stream.

Ein MediaStream besteht aus null oder mehr MediaStreamTrack-Objekten, die verschiedene Audio- oder Videotracks repräsentieren. Jeder MediaStreamTrack kann über einen oder mehrere Channels verfügen. Der Channel stellt die kleinste Einheit eines Medien-Streams dar, wie z.B. ein Audiosignal, das mit einem bestimmten Lautsprecher verbunden ist, wie links oder rechts in einem Stereo-Audiotrack.

MediaStream-Objekte haben einen einzelnen Eingang und einen einzelnen Ausgang. Ein von getUserMedia() generiertes MediaStream-Objekt wird als lokal bezeichnet und hat als Quelleneingang eine der Kameras oder Mikrofone des Benutzers. Ein nicht lokales MediaStream kann ein Medien-Element darstellen, wie z.B. <video> oder <audio>, einen über das Netzwerk stammenden Stream, der über die WebRTC-API RTCPeerConnection erhalten wird, oder einen Stream, der mit der Web Audio API MediaStreamAudioDestinationNode erstellt wurde.

Der Ausgang des MediaStream-Objekts ist mit einem Konsumenten verbunden. Es kann sich um ein Medien-Element handeln, wie <audio> oder <video>, die WebRTC-API RTCPeerConnection oder eine Web Audio API MediaStreamAudioSourceNode.

Schnittstellen

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

Ereignisse

Leitfäden und Tutorials

Der Artikel Fähigkeiten, Einschränkungen und Einstellungen diskutiert die Konzepte von Einschränkungen und Fähigkeiten sowie Medieneinstellungen und beinhaltet einen Constraint Exerciser, mit dem Sie die Ergebnisse verschiedener Einschränkungssets ausprobieren können, die auf die Audio- und Videotracks der A/V-Eingabegeräte des Computers angewendet werden (wie die Webcam und das Mikrofon).

Der Artikel Fotos mit getUserMedia() aufnehmen zeigt, wie Sie getUserMedia() verwenden, um auf die Kamera eines Computers oder Mobiltelefons mit getUserMedia()-Unterstützung zuzugreifen und ein Foto damit 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