Media Capture and Streams API (미디어 스트림)

이 API는 오디오 혹은 비디오와 관련된 데이터를 나타내는 MediaStream (en-US) 객체 조작에 기반합니다.

MediaStream은 0개 이상의 MediaStreamTrack 객체로 구성되며, 각자 다양한 오디오와 비디오 트랙을 나타냅니다. 각각의 MediaStreamTrack은 하나 이상의 채널을 가질 수 있습니다. 채널은, 오디오로 예를 들면 스테레오 오디오 트랙에서의 "왼쪽"과 "오른쪽"처럼, 미디어 스트림의 제일 작은 단위를 나타냅니다.

MediaStream 객체는 하나의 입력과 하나의 출력을 가집니다. getUserMedia() (en-US)로 생성한 MediaStream 객체는 "로컬" 미디어 스트림이라고 부르며, 사용자의 카메라와 마이크 중 하나를 입력 출처로 사용합니다. 반면 <video>, <audio> (en-US)와 같은 미디어 요소, 네트워크에서 들어오는 스트림, WebRTC RTCPeerConnection (en-US) API로 획득한 스트림, Web Audio API MediaStreamAudioSourceNode (en-US)로 생성한 스트림 등은 비 로컬 MediaStream이라고 합니다.

MediaStream 객체의 출력은 소비자(컨슈머)로 연결됩니다. 소비자는 <video>, <audio> (en-US)와 같은 미디어 요소, WebRTC RTCPeerConnection (en-US) API, Web Audio API MediaStreamAudioSourceNode (en-US)가 가능합니다.

아래의 참고 문서에서는 Media Capture and Streams API를 구성하는 인터페이스에 대한 기초적인 지식을 찾을 수 있습니다.

• CanvasCaptureMediaStreamTrack (en-US)
• InputDeviceInfo (en-US)
• MediaDeviceKind
• MediaDeviceInfo (en-US)
• MediaDevices
• MediaStream (en-US)
• MediaStreamEvent (en-US)
• MediaStreamTrack
• MediaStreamTrackEvent (en-US)
• MediaTrackCapabilities
• MediaTrackConstraints (en-US)
• MediaTrackSettings (en-US)
• MediaTrackSupportedConstraints (en-US)
• NavigatorUserMedia
• NavigatorUserMediaError
• OverconstrainedError (en-US)
• URL

Media Capture and Streams API의 초기 명세는 MediaStreamTrack에 기반한 별도의 AudioStreamTrack과 VideoStreamTrack 인터페이스를 포함했으며, 각자 오디오와 비디오 스트림을 따로 나타냈었습니다. 그러나 이런 구분은 더 이상 존재하지 않으며, 두 인터페이스를 사용하는 코드는 MediaStreamTrack을 직접 사용하도록 업데이트해야 합니다.

• addtrack (en-US)
• ended (en-US)
• mute (en-US)
• overconstrained (en-US)
• removetrack (en-US)
• unmute (en-US)

• WebRTC
• mediaDevices.getUserMedia() (en-US)