Media Capture and Streams API (Media Stream)
Die Media Capture and Streams API, oft als Media Streams API oder MediaStream API bezeichnet, ist eine API, die sich auf WebRTC bezieht und Unterstützung für das Streaming von Audio- und Videodaten bietet.
Sie bietet die Schnittstellen und Methoden zur Arbeit mit den Streams und ihren zugehörigen Tracks, die mit Datenformaten verbundenen Einschränkungen, die Erfolgs- und Fehlercallbacks bei asynchroner Nutzung der Daten sowie die während des Prozesses ausgelösten Ereignisse.
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 in Holen Sie sich den Medien-Stream.
Ein MediaStream
besteht aus null oder mehr MediaStreamTrack
-Objekten, die verschiedene Audio- oder Video-Tracks darstellen. Jeder MediaStreamTrack
kann ein oder mehrere Kanäle haben. Der Kanal stellt die kleinste Einheit eines Medienstreams dar, wie ein Audiosignal, das einem bestimmten Lautsprecher zugeordnet ist, wie links oder rechts in einem Stereo-Audiotrack.
MediaStream
-Objekte haben einen einzigen Eingang und einen einzigen Ausgang. Ein MediaStream
, das durch getUserMedia()
erzeugt wird, wird als lokal bezeichnet und hat als Quelleneingang eine der Kameras oder Mikrofone des Nutzers. Ein nicht-lokales MediaStream
kann ein Medien-Element wie <video>
oder <audio>
darstellen, ein Stream, der über das Netzwerk kommt und über die WebRTC RTCPeerConnection
API erhalten wird, oder ein Stream, der mit der Web Audio API MediaStreamAudioDestinationNode
erstellt wurde.
Der Ausgang des MediaStream
-Objekts ist mit einem Konsumenten verknüpft. Dies kann ein Medienelement wie <audio>
oder <video>
, die WebRTC RTCPeerConnection
API oder ein Web Audio API MediaStreamAudioSourceNode
sein.
Schnittstellen
In diesen Referenzartikeln finden Sie die grundlegenden Informationen, die Sie über jede der Schnittstellen wissen müssen, aus denen die Media Capture and Streams API besteht.
Ereignisse
Leitfäden und Tutorials
Der Artikel Fähigkeiten, Einschränkungen und Einstellungen diskutiert die Konzepte von Einschränkungen und Fähigkeiten sowie Medien-Einstellungen und enthält einen Constraint-Übungsmodus, mit dem Sie mit den Ergebnissen verschiedener Einschränkungssätze experimentieren können, die auf die Audio- und Videotracks der A/V-Eingabegeräte des Computers (wie Webcam und Mikrofon) angewendet werden.
Der Artikel Fotos mit getUserMedia() aufnehmen zeigt, wie Sie mit getUserMedia()
auf die Kamera eines Computers oder Mobiltelefons mit getUserMedia()
-Unterstützung zugreifen und ein Foto aufnehmen können.
Browser-Kompatibilität
api.MediaStream
BCD tables only load in the browser
api.MediaStreamTrack
BCD tables only load in the browser
api.MediaDevices
BCD tables only load in the browser
api.MediaDeviceInfo
BCD tables only load in the browser
api.InputDeviceInfo
BCD tables only load in the browser
api.CanvasCaptureMediaStreamTrack
BCD tables only load in the browser
Siehe auch
- WebRTC - die Einführungsseite zur API
- Standbilder mit WebRTC aufnehmen: eine Demonstration und Anleitung zur Verwendung von
getUserMedia()
.