DieMedia-Capture- und -Streams-API, oft alsMedia Streams API oderMediaStream API bezeichnet, ist eine API im Zusammenhang mitWebRTC, 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 einesMediaStream-Objekts, das einen Fluss von Audio- oder videobezogenen Daten darstellt. Siehe ein Beispiel inErhalte den Medien-Stream.

EinMediaStream besteht aus null oder mehrMediaStreamTrack-Objekten, die verschiedene Audio- oder Videotracksrepräsentieren. JederMediaStreamTrack kann über einen oder mehrereChannels verfügen. Der Channel stellt die kleinste Einheit eines Medien-Streams dar, wie z.B. ein Audiosignal, das mit einem bestimmten Lautsprecher verbunden ist, wielinks oderrechts in einem Stereo-Audiotrack.

MediaStream-Objekte haben einen einzelnenEingang und einen einzelnenAusgang. Ein vongetUserMedia() generiertesMediaStream-Objekt wird alslokal bezeichnet und hat als Quelleneingang eine der Kameras oder Mikrofone des Benutzers. Ein nicht lokalesMediaStream kann ein Medien-Element darstellen, wie z.B.<video> oder<audio>, einen über das Netzwerk stammenden Stream, der über die WebRTC-APIRTCPeerConnection erhalten wird, oder einen Stream, der mit derWeb Audio APIMediaStreamAudioDestinationNode erstellt wurde.

Der Ausgang desMediaStream-Objekts ist mit einemKonsumenten verbunden. Es kann sich um ein Medien-Element handeln, wie<audio> oder<video>, die WebRTC-APIRTCPeerConnection oder eineWeb Audio APIMediaStreamAudioSourceNode.

Schnittstellen

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

• CanvasCaptureMediaStreamTrack
• InputDeviceInfo
• MediaDeviceInfo
• MediaDevices
• MediaStream
• MediaStreamTrack
• MediaStreamTrackEvent
• MediaTrackConstraints
• MediaTrackSettings
• MediaTrackSupportedConstraints
• OverconstrainedError

Ereignisse

• addtrack
• ended
• mute
• removetrack
• unmute

Leitfäden und Tutorials

Der ArtikelFähigkeiten, Einschränkungen und Einstellungen diskutiert die Konzepte vonEinschränkungen undFähigkeiten sowie Medieneinstellungen und beinhaltet einenConstraint 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 ArtikelFotos mit getUserMedia() aufnehmen zeigt, wie SiegetUserMedia() verwenden, um auf die Kamera eines Computers oder Mobiltelefons mitgetUserMedia()-Unterstützung zuzugreifen und ein Foto damit aufzunehmen.

Spezifikationen

Browser-Kompatibilität

api.MediaStream

api.MediaStreamTrack

api.MediaDevices

api.MediaDeviceInfo

api.InputDeviceInfo

api.CanvasCaptureMediaStreamTrack

Siehe auch

• WebRTC - die Einführungsseite der API
• Fotos mit WebRTC aufnehmen: eine Demonstration und Anleitung zur Verwendung vongetUserMedia().