MediaDevices

MediaDevices 인터페이스는 카메라, 마이크, 공유 화면 등 현재 연결된 미디어 입력 장치로의 접근 방법을 제공하는 인터페이스입니다. 다르게 말하자면, 미디어 데이터를 제공하는 모든 하드웨어로 접근할 수 있는 방법입니다.

속성

부모 인터페이스인 EventTarget의 속성을 상속합니다.

이벤트

devicechange

사용자 컴퓨터에 미디어 입출력 장치가 추가되거나 제거됐을 때 발생합니다.
ondevicechange 속성으로도 사용할 수 있습니다.

메서드

부모 인터페이스인 EventTarget의 메서드를 상속합니다.

enumerateDevices()

시스템에서 사용 가능한 미디어 입출력 장치의 정보를 담은 배열을 가져옵니다.

getSupportedConstraints()

MediaStreamTrack 인터페이스가 지원하는 제약을 나타내는 MediaTrackSupportedConstraints 호환 객체를 반환합니다.

See Capabilities and constraints in Media Capture and Streams API (Media Stream) to learn more about constraints and how to use them.

getDisplayMedia()

MediaStream으로 캡처해 공유나 녹화 용도로 사용할 화면 혹은 화면의 일부(창)를 선택하도록 사용자에게 요청합니다. MediaStream으로 이행하는 Promise를 반환합니다.

getUserMedia()

사용자에게 권한을 요청한 후, 시스템의 카메라와 오디오 각각 혹은 모두 활성화하여, 장치의 입력 데이터를 비디오/오디오 트랙으로 포함한 MediaStream을 반환합니다.

예제

'use strict';

// Put variables in global scope to make them available to the browser console.
var video = document.querySelector('video');
var constraints = window.constraints = {
  audio: false,
  video: true
};
var errorElement = document.querySelector('#errorMsg');

navigator.mediaDevices.getUserMedia(constraints)
.then(function(stream) {
  var videoTracks = stream.getVideoTracks();
  console.log('Got stream with constraints:', constraints);
  console.log('Using video device: ' + videoTracks[0].label);
  stream.onremovetrack = function() {
    console.log('Stream ended');
  };
  window.stream = stream; // make variable available to browser console
  video.srcObject = stream;
})
.catch(function(error) {
  if (error.name === 'ConstraintNotSatisfiedError') {
    errorMsg('The resolution ' + constraints.video.width.exact + 'x' +
        constraints.video.width.exact + ' px is not supported by your device.');
  } else if (error.name === 'PermissionDeniedError') {
    errorMsg('Permissions have not been granted to use your camera and ' +
      'microphone, you need to allow the page access to your devices in ' +
      'order for the demo to work.');
  }
  errorMsg('getUserMedia error: ' + error.name, error);
});

function errorMsg(msg, error) {
  errorElement.innerHTML += '<p>' + msg + '</p>';
  if (typeof error !== 'undefined') {
    console.error(error);
  }
}

명세

브라우저 호환성

같이 보기

• 인터페이스가 속한 Media Capture and Streams API
• getDisplayMedia() 메서드를 정의하는 Screen Capture API
• WebRTC API
• 장치에 접근할 때 사용할 MediaDevices 객체의 참조를 반환하는 Navigator.mediaDevices