미디어 캡처 및 스트림

MediaStream

MediaStream 생성자 알고리즘을 참조하십시오.

매개변수가 없습니다.

MediaStream

MediaStream 생성자 알고리즘을 참조하십시오.

MediaStream

MediaStream 생성자 알고리즘을 참조하십시오.

id, 유형: DOMString, 읽기 전용

id 속성은 객체가 생성될 때 초기화된 값을 반드시 반환해야 합니다.

MediaStream이 생성되면 사용자 에이전트는 식별자 문자열을 반드시 생성하고, 스트림 id를 초기화하는 방법을 지정하는 특수 목적 알고리즘의 일부로 객체가 생성되는 경우를 제외하고 객체의 id 속성을 해당 문자열로 반드시 초기화해야 합니다. 좋은 방법은 UUID [rfc4122]를 사용하는 것이며, UUID는 정규 형식에서 36자입니다. 핑거프린팅을 방지하기 위해 구현은 UUID를 생성할 때 RFC 4122의 4.4절 또는 4.5절의 형식을 사용해야 합니다.

스트림 id를 초기화하는 방법을 지정하는 알고리즘의 예로 수신 네트워크 구성 요소를 MediaStream 객체와 연결하는 알고리즘이 있습니다. [WEBRTC]

active, 유형: boolean, 읽기 전용

active 속성은 이 MediaStream이 활성 상태이면 true를, 그렇지 않으면 false를 반드시 반환해야 합니다.

onaddtrack, 유형: EventHandler

이 이벤트 핸들러의 이벤트 유형은 addtrack입니다.

onremovetrack, 유형: EventHandler

이 이벤트 핸들러의 이벤트 유형은 removetrack입니다.

getAudioTracks()

이 스트림의 오디오 트랙을 나타내는 MediaStreamTrack 객체의 시퀀스를 반환합니다.

getAudioTracks 메서드는 이 스트림의 트랙 집합에 있는 [[Kind]]가 "audio"와 같은 모든 MediaStreamTrack 객체의 스냅샷을 나타내는 시퀀스를 반드시 반환해야 합니다. 트랙 집합에서 시퀀스로의 변환은 사용자 에이전트가 정의하며 호출 간에 순서가 안정적일 필요는 없습니다.

getVideoTracks()

이 스트림의 비디오 트랙을 나타내는 MediaStreamTrack 객체의 시퀀스를 반환합니다.

getVideoTracks 메서드는 이 스트림의 트랙 집합에 있는 [[Kind]]가 "video"와 같은 모든 MediaStreamTrack 객체의 스냅샷을 나타내는 시퀀스를 반드시 반환해야 합니다. 트랙 집합에서 시퀀스로의 변환은 사용자 에이전트가 정의하며 호출 간에 순서가 안정적일 필요는 없습니다.

getTracks()

이 스트림의 모든 트랙을 나타내는 MediaStreamTrack 객체의 시퀀스를 반환합니다.

getTracks 메서드는 [[Kind]]와 관계없이 이 스트림의 트랙 집합에 있는 모든 MediaStreamTrack 객체의 스냅샷을 나타내는 시퀀스를 반드시 반환해야 합니다. 트랙 집합에서 시퀀스로의 변환은 사용자 에이전트가 정의하며 호출 간에 순서가 안정적일 필요는 없습니다.

getTrackById()

getTrackById 메서드는 이 스트림의 트랙 집합에서 [[Id]]가 trackId와 같은 MediaStreamTrack 객체를 반드시 반환하거나, 그러한 트랙이 존재하지 않으면 null을 반환해야 합니다.

addTrack()

주어진 MediaStreamTrack을 이 MediaStream에 추가합니다.

addTrack 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 합니다:

1. track을 메서드의 인수로 하고 stream을 메서드가 호출된 MediaStream 객체로 합니다.

2. track이 이미 stream의 트랙 집합에 있으면 이 단계를 중단합니다.

3. track을 stream의 트랙 집합에 추가합니다.

removeTrack()

주어진 MediaStreamTrack 객체를 이 MediaStream에서 제거합니다.

removeTrack 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 합니다:

1. track을 메서드의 인수로 하고 stream을 메서드가 호출된 MediaStream 객체로 합니다.

2. track이 stream's 트랙 집합에 없으면 이 단계를 중단합니다.

3. stream의 트랙 집합에서 track을 제거합니다.

clone()

주어진 MediaStream 및 그 모든 트랙을 복제합니다.

clone() 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 합니다:

1. streamClone을 새로 생성된 MediaStream 객체로 합니다.

2. streamClone.MediaStream.id를 새로 생성된 값으로 초기화합니다.

3. 이 MediaStream 객체의 각 트랙을 복제하고 그 결과를 streamClone의 트랙 집합에 추가합니다.

4. streamClone을 반환합니다.

addtrack 또는 removetrack 이벤트를 발생시킬 것으로 예상되는 사용자 에이전트 코드는 다른 객체의 참조를 통해 대상 MediaStream 객체가 유지되도록 해야 합니다. MediaStream 객체를 가비지 컬렉션하려고 할 때 addtrack 또는 removetrack 이벤트 리스너의 존재를 고려할 필요는 없습니다.

constructor()

새로운 MediaStreamTrackEvent를 생성합니다.

track 유형: MediaStreamTrack, 읽기 전용

track 속성은 이벤트와 연결된 MediaStreamTrack 객체를 나타냅니다.

track 유형: MediaStreamTrack, 필수

mediaDevices 유형: MediaDevices, 읽기 전용

this의 관련 전역 객체의 연결된 MediaDevices를 반환합니다.

ondevicechange 유형: EventHandler

이 이벤트 핸들러의 이벤트 유형은 devicechange입니다.

enumerateDevices

사용자 에이전트에서 사용할 수 있는 미디어 입력 및 출력 장치에 관한 정보를 수집합니다.

이 메서드는 프로미스를 반환합니다. 열거가 성공하면 프로미스는 이행되며, 사용자 에이전트에서 사용할 수 있는 미디어 입력 및 출력 장치를 나타내는 MediaDeviceInfo 객체의 시퀀스를 제공합니다.

이 시퀀스에서 입력 장치를 나타내는 요소는 MediaDeviceInfo를 확장하는 InputDeviceInfo 유형입니다.

카메라 및 마이크 소스는 열거할 수 있어야 합니다. 추가 소스 유형을 추가하는 명세는 해당 소스 유형을 열거할 수 있어야 하는지에 대한 권고 사항을 제공합니다.

enumerateDevices() 메서드가 호출되면 사용자 에이전트는 다음 단계를 실행해야 합니다:

1. p를 새로운 프로미스로 합니다.

2. proceed를 this로 장치 열거를 진행할 수 있음을 확인한 결과로 합니다.

3. mediaDevices를 this로 합니다.

4. 다음 단계를 병렬로 실행합니다:

   1. proceed가 false인 동안, 사용자 에이전트는 mediaDevices로 장치 열거를 진행할 수 있음의 결과로 proceed를 설정하기 위해 대기열에 넣은 태스크가 proceed를 true로 설정할 때까지 다음 단계로 진행하기 위해 반드시 기다려야 합니다.

   2. resultList를 mediaDevices 및 mediaDevices.[[storedDeviceList]]를 사용하여 장치 정보 객체 목록을 생성한 결과로 합니다.

   3. p를 resultList로 이행합니다.

5. p를 반환합니다.

mediaDevices와 deviceList가 주어졌을 때 장치 정보 객체 목록을 생성하려면 다음 단계를 실행합니다:

1. resultList를 빈 목록으로 합니다.

2. microphoneList, cameraList 및 otherDeviceList를 빈 목록으로 합니다.

3. document를 mediaDevices의 관련 전역 객체의 연결된 Document로 합니다.

4. deviceList에서 발견된 각 장치 device에 대해 다음 하위 단계를 실행합니다:

   1. device가 마이크가 아니거나 document가 "microphone"으로 식별되는 기능을 사용할 수 있도록 허용되지 않았다면, 이 하위 단계를 중단하고 다음 장치가 있으면 계속 진행합니다.

   2. deviceInfo를 mediaDevices를 사용하여 device를 나타내는 장치 정보 객체를 생성한 결과로 합니다.

   3. device가 시스템 기본 마이크이면 deviceInfo를 microphoneList의 앞에 추가합니다. 그렇지 않으면 deviceInfo를 microphoneList의 뒤에 추가합니다.

5. deviceList에서 발견된 각 장치 device에 대해 다음 하위 단계를 실행합니다:

   1. device가 카메라가 아니거나 document가 "camera"로 식별되는 기능을 사용할 수 있도록 허용되지 않았다면, 이 하위 단계를 중단하고 다음 장치가 있으면 계속 진행합니다.

   2. deviceInfo를 mediaDevices를 사용하여 device를 나타내는 장치 정보 객체를 생성한 결과로 합니다.

   3. device가 시스템 기본 카메라이면 deviceInfo를 cameraList의 앞에 추가합니다. 그렇지 않으면 deviceInfo를 cameraList의 뒤에 추가합니다.

6. mediaDevices에서 마이크 정보를 노출할 수 있음이 false이면, microphoneList를 첫 번째 항목까지만 남깁니다.

7. mediaDevices에서 카메라 정보를 노출할 수 있음이 false이면, cameraList를 첫 번째 항목까지만 남깁니다.

8. deviceList에서 발견된 각 장치 device에 대해 다음 하위 단계를 실행합니다:

   1. device가 마이크이거나 device가 카메라이면 이 하위 단계를 중단하고 다음 장치가 있으면 계속 진행합니다.

   2. device, microphoneList, cameraList 및 mediaDevices를 입력으로 하여 카메라와 마이크 이외 장치의 노출 결정 알고리즘을 실행합니다. 이 알고리즘의 결과가 false이면 이 하위 단계를 중단하고 다음 장치가 있으면 계속 진행합니다.

   3. deviceInfo를 mediaDevices를 사용하여 device를 나타내는 장치 정보 객체를 생성한 결과로 합니다.

   4. deviceInfo를 otherDeviceList의 뒤에 추가합니다.

   5. device가 시스템 기본 오디오 출력이면 다음 하위 단계를 실행합니다:

      1. defaultAudioOutputInfo를 mediaDevices를 사용하여 device를 나타내는 장치 정보 객체를 생성한 결과로 합니다.

      2. defaultAudioOutputInfo의 deviceId를 "default"로 설정합니다.

      3. 사용자 에이전트는 이것이 시스템 기본 오디오 출력임을 명시하도록 defaultAudioOutputInfo의 label을 업데이트해야 합니다.

      4. defaultAudioOutputInfo를 otherDeviceList의 앞에 추가합니다.

9. microphoneList의 모든 장치를 순서대로 resultList의 뒤에 추가합니다.

10. cameraList의 모든 장치를 순서대로 resultList의 뒤에 추가합니다.

11. otherDeviceList의 모든 장치를 순서대로 resultList의 뒤에 추가합니다.

12. resultList를 반환합니다.

이 메서드는 미디어 캡처 장치의 가용성을 통해 브라우징 세션과 출처 전반에 걸쳐 지속되는 정보를 반환하므로, 사용자 에이전트가 노출하는 핑거프린팅 표면을 증가시킵니다.

관련 전역 객체의 연결된 Document가 캡처하지 않은 동안에는 이 메서드가 노출하는 정보를 두 비트로 제한합니다. 즉, 카메라가 있는지와 마이크가 있는지 여부입니다. 사용자 에이전트는 예를 들어 관련 전역 객체의 연결된 Document가 합리적이라고 간주되는 제약 조건으로 getUserMedia()를 호출할 때까지 시스템에 카메라와 마이크가 있는 것처럼 가장하여 이를 완화할 수 있습니다.

관련 전역 객체의 연결된 Document가 캡처를 시작한 후에는 모든 미디어 캡처 장치의 목록을 통해 추가적인 지속성 교차 출처 정보를 제공하며, 여기에는 캡처 장치의 그룹화 및 사람이 읽을 수 있는 레이블도 포함되어 핑거프린팅 표면이 더 증가합니다.

사용자 에이전트는 장치 레이블을 정제하여 노출을 제한할 수 있습니다. 예를 들어 레이블에서 발견된 사용자 이름은 제거하되, 장치 제조업체나 모델 정보는 유지할 수 있습니다. 정제된 레이블을 통해 사용자가 해당 장치를 식별할 수 있도록 하는 것이 중요합니다.

deviceId 유형: DOMString, 읽기 전용

표현된 장치의 식별자입니다. 장치는 해당 식별자와 kind에 의해 반드시 고유하게 식별되어야 합니다.

저장된 식별자를 인식할 수 있도록 하기 위해, 식별자는 최상위 순회 가능 항목의 동일 출처 Document들에서 반드시 동일해야 합니다. 자식 탐색 가능 항목에서는, 문서 간 식별자가 동일한지 여부에 대한 결정이 사이트 간 상관관계 완화 조치를 방해하지 않도록, 존재하는 경우 저장소(예: localStorage)에 대한 사용자 에이전트의 파티셔닝 규칙을 반드시 따라야 합니다. 식별자가 사용자를 고유하게 식별할 수 있다면, 해당 식별자를 서로 다른 출처에서 동일한 사용자의 상관관계를 파악하는 데 사용하지 못하도록 다른 출처의 문서에서 추측할 수 없도록 반드시 해야 합니다. 식별자가 사용자에 연결되어 있지 않고 User-Agent 문자열과 같은 다른 수단으로 추측할 수 있다면 출처 간에 재사용할 수 있습니다.

이 출처의 페이지에서 어떤 로컬 장치라도 라이브 MediaStreamTrack에 연결되었거나, 이 출처에 로컬 장치에 접근하기 위한 저장된 권한이 부여되었다면, 아래에 자세히 설명된 경우를 제외하고 이 식별자는 반드시 지속되어야 합니다. 고유하고 안정적인 식별자를 통해 애플리케이션은 여러 번의 방문에 걸쳐 특정 소스를 저장하고, 가용성을 확인하고, 직접 요청할 수 있습니다.

그러나 이 출처의 페이지에서 어떤 로컬 장치도 라이브 MediaStreamTrack에 연결되지 않았고, 이 출처에 로컬 장치에 접근하기 위한 저장된 권한도 부여되지 않은 동안에는 사용자 에이전트가 이 출처의 마지막 브라우징 세션이 닫힌 후 이 식별자를 지울 수 있습니다. 사용자 에이전트가 이 조건에서 식별자를 지우지 않기로 선택한다면, 쿠키와 마찬가지로 사용자가 식별자를 시각적으로 확인하고 삭제할 수 있도록 반드시 해야 합니다.

deviceId는 브라우징 세션 간에 지속될 수 있고 핑거프린팅 메커니즘으로 사용될 가능성을 줄이기 위해, deviceId는 쿠키 [COOKIES]와 같은 다른 지속성 저장소 메커니즘처럼 취급해야 합니다. 즉, 사용자 에이전트는 쿠키 사용이 차단된 사이트에 대해 장치 식별자를 지속해서는 안 되며, 다른 지속성 저장소가 지워질 때 출처별 장치 식별자를 사용자 에이전트가 반드시 교체해야 합니다.

kind 유형: MediaDeviceKind, 읽기 전용

표현된 장치의 종류입니다.

label 유형: DOMString, 읽기 전용

이 장치를 설명하는 레이블입니다(예: "외장 USB 웹캠"). 이 레이블은 최종 사용자가 장치를 서로 구분할 수 있도록 하기 위한 것입니다. 애플리케이션은 레이블에 장치 유형이나 모델과 같은 특정 정보가 포함되어 있다고 가정할 수 없습니다. 장치에 연결된 레이블이 없다면 이 속성은 빈 문자열을 반드시 반환해야 합니다.

groupId 유형: DOMString, 읽기 전용

표현된 장치의 그룹 식별자입니다. 두 장치가 동일한 물리적 장치에 속하면 동일한 그룹 식별자를 가집니다. 예를 들어 동일한 헤드셋의 스피커와 마이크를 나타내는 오디오 입력 및 출력 장치는 동일한 groupId를 가집니다.

그룹 식별자는 각 문서에 대해 반드시 고유하게 생성되어야 합니다.

toJSON

호출되면 [WEBIDL]의 기본 toJSON 단계를 실행합니다.

getCapabilities

사용자가 제공한 제약 조건이 없는 경우, 장치의 MediaStream의 기본 오디오 또는 비디오 트랙을 (해당 kind 값에 따라) 설명하는 MediaTrackCapabilities 객체를 반환합니다. 이러한 기능은 id가 이 MediaDeviceInfo의 deviceId 속성 값인 getUserMedia({deviceId: id})가 반환한 MediaStream에서 이 유형의 첫 번째 MediaStreamTrack에 getCapabilities()를 호출하여 얻을 수 있는 기능과 반드시 동일해야 합니다.

어떤 로컬 장치에도 액세스가 허용되지 않았고 이 InputDeviceInfo가 고유 식별 정보와 관련하여 필터링된 경우(위의 enumerateDevices() 결과 설명 참조), 이 메서드는 빈 딕셔너리를 반환합니다.

constructor()

eventInitDict.devices에서 고정 배열을 생성한 결과로 this.devices를 초기화합니다.

devices 유형: FrozenArray<MediaDeviceInfo>, 읽기 전용

devices 속성은 현재 사용 가능한 장치 목록을 나타내는 MediaDeviceInfo 객체의 배열을 반환합니다.

userInsertedDevices 유형: FrozenArray<MediaDeviceInfo>, 읽기 전용

userInsertedDevices 속성은 devices의 MediaDeviceInfo 객체 중 사용자가 최근 물리적으로 삽입하거나 활성화했고 그 결과 이 이벤트를 통해 새로 노출된 객체만 포함하는 배열을 반환합니다. 그렇지 않으면 빈 목록을 반환합니다.

사용자 에이전트는 getUserMedia()가 호출되기 전에 사용자가 삽입하거나 활성화한 장치도, 이 이벤트가 해당 장치의 첫 번째 노출을 표시하고 사용자가 getUserMedia()에서 장치를 선택하지 않았다면 포함할 수 있습니다.

MediaDeviceInfo 객체가 존재한다면 devices에도 반드시 존재해야 합니다.

참고

사용자가 호출 중(또는 호출 직전)에 장치를 삽입하는 것은 해당 장치를 즉시 사용하고자 한다는 강한 신호일 수 있습니다.

애플리케이션은 이 속성을 활용하여 이러한 신호를 장치 정보 노출의 변경으로 인해 발생할 수 있는 devices의 차이와 구분할 것을 권장합니다.

참고

이 속성이 없으면 이 UA가 이 버전의 명세를 구현하도록 아직 업그레이드되지 않았음을 의미합니다.

devices 유형: sequence<MediaDeviceInfo>, 기본값: []

devices 멤버는 사용 가능한 장치를 나타내는 MediaDeviceInfo 객체의 배열입니다.

getSupportedConstraints

사용자 에이전트가 알고 있는 제약 가능한 속성을 멤버로 갖는 딕셔너리를 반환합니다. 지원되는 제약 가능한 속성은 반드시 표현되어야 하며, 사용자 에이전트가 지원하지 않는 제약 가능한 속성은 반환되는 딕셔너리에 포함되어서는 안 됩니다. 반환되는 값은 사용자 에이전트가 구현하는 항목을 나타내며 브라우징 세션 중에는 변경되지 않습니다.

getUserMedia

사용자에게 웹캠 또는 기타 비디오나 오디오 입력을 사용할 권한을 요청합니다.

constraints 인수는 MediaStreamConstraints 유형의 딕셔너리입니다.

이 메서드는 프로미스를 반환합니다. 사용자가 아래에 설명된 유효한 트랙을 승인하면 프로미스는 적절한 MediaStream 객체로 이행됩니다.

아래에 설명된 대로 유효한 트랙을 찾지 못하거나 사용자가 권한을 거부하면 프로미스는 거부됩니다.

getUserMedia() 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 합니다:

1. constraints를 메서드의 첫 번째 인수로 합니다.

2. requestedMediaTypes를 constraints에서 딕셔너리 값 또는 true 값을 가진 미디어 유형의 집합으로 합니다.

3. requestedMediaTypes가 빈 집합이면 TypeError로 거부된 프로미스를 반환합니다. WebIDL 규칙 때문에 WebIDL에는 "optional"이라는 단어가 나타나지만, 호출이 성공하려면 인수를 반드시 제공해야 합니다.

4. document를 관련 전역 객체의 연결된 Document로 합니다.

5. document가 완전히 활성 상태가 아니면, name 속성 값이 "InvalidStateError"인 DOMException 객체로 거부된 프로미스를 반환합니다.

6. requestedMediaTypes에 "audio"가 포함되어 있고 document가 "microphone" 권한 이름으로 식별되는 기능을 사용하도록 허용되지 않은 경우, 아래의 권한 실패라고 표시된 단계로 이동합니다.

7. requestedMediaTypes에 "video"가 포함되어 있고 document가 "camera" 권한 이름으로 식별되는 기능을 사용하도록 허용되지 않은 경우, 아래의 권한 실패라고 표시된 단계로 이동합니다.

8. mediaDevices를 this로 합니다.

9. isInView를 보이는 상태임 알고리즘의 결과로 합니다.

10. p를 새 프로미스로 합니다.

11. 다음 단계를 병렬로 실행합니다:

    1. isInView가 false인 동안, 사용자 에이전트는 보이는 상태임 알고리즘의 결과로 isInView를 설정하도록 대기열에 넣은 태스크가 isInView를 true로 설정할 때까지 다음 단계로 진행하기 위해 반드시 기다려야 합니다.

    2. finalSet을 (초기에는) 빈 집합으로 합니다.

    3. requestedMediaTypes의 각 미디어 유형 kind에 대해 다음 단계를 실행합니다:

       1. kind 유형 미디어의 가능한 각 소스 장치의 가능한 각 구성에 대해, 소스 장치를 보유하고 특정 설정으로 구성된 설정 딕셔너리를 가진 최종 MediaStreamTrack을 대신하는 자리표시자로 후보를 구상합니다.

          이 후보 집합을 candidateSet이라고 합니다.

          candidateSet이 빈 집합이면 아래의 NotFound 실패라고 표시된 단계로 이동합니다.

       2. constraints의 kind 항목 값이 true이면 CS를 빈 제약 조건 집합(제약 조건 없음)으로 설정합니다. 그렇지 않으면 CS를 constraints의 kind 항목 값으로 설정한 상태로 계속합니다.
       3. CS 내부에서 kind 유형의 MediaStreamTrack 객체에 대해 정의되지 않은 모든 제약 가능한 속성을 제거합니다. 즉 "video" 내부의 오디오 전용 제약 조건과 "audio" 내부의 비디오 전용 제약 조건은 OverconstrainedError를 발생시키는 대신 단순히 무시됩니다.

       4. CS에 필수 제약 조건인 멤버가 포함되어 있고, 그 이름이 장치 선택에 허용되는 필수 제약 조건 목록에 없다면, p를 TypeError로 거부하고 이 단계를 중단합니다.

       5. candidateSet의 각 후보에 대해 CS를 제약 조건 집합으로 하여 SelectSettings 알고리즘을 실행합니다. 알고리즘이 undefined를 반환하면 해당 후보를 candidateSet에서 제거합니다. 이는 제약 조건을 충족하는 설정 딕셔너리가 적어도 하나 존재하는지 확인하여 제약 조건을 충족할 수 없는 장치를 제거합니다.

          candidateSet이 빈 집합이면 failedConstraint를 SelectSettings 알고리즘을 실행하는 동안 검사한 모든 설정 딕셔너리에서 적합도 거리가 무한대였던 임의의 필수 제약 조건으로 하거나, 그러한 것이 없다면 ""로 하고, 아래의 제약 조건 실패라고 표시된 단계로 이동합니다.

          이 오류는 사용자가 어떤 장치에도 권한을 부여하기 전에 기반 장치가 무엇을 생성할 수 없는지에 관한 정보를 제공하므로 핑거프린팅 표면으로 사용될 수 있습니다.

       6. 현재 Document에서 라이브 MediaStreamTrack에 연결되어 있지 않은 candidateSet의 모든 후보 장치에 대해 현재 권한 상태를 읽습니다. 장치의 권한 상태가 "denied"인 모든 후보를 candidateSet에서 제거합니다.

          candidateSet이 이제 비어 있다면, 이는 이 유형의 모든 장치가 "denied" 상태임을 나타내므로 아래의 PermissionFailure라고 표시된 단계로 이동합니다.

       7. 선택적으로, 예를 들어 이전에 설정된 사용자 기본 설정, 보안상의 이유 또는 플랫폼 제한에 따라 아래의 권한 실패라고 표시된 단계로 이동합니다.

       8. candidateSet의 모든 후보를 finalSet에 추가합니다.

    4. stream을 새롭고 비어 있는 MediaStream 객체로 합니다.

    5. requestedMediaTypes의 각 미디어 유형 kind에 대해, 가급적 동시에 다음 하위 단계를 실행합니다:

       참고

       사용자 에이전트는 서로 다른 종류의 미디어에 대한 동시 요청을 하나의 사용자 대상 권한 프롬프트로 묶을 것을 권장합니다.

       1. PermissionDescriptor의 name 멤버를 kind와 연결된 권한 이름으로 설정하여 사용 권한을 요청합니다 (예: "video"의 경우 "camera", "audio"의 경우 "microphone"). 이때 현재 Document의 라이브 및 동일 권한 MediaStreamTrack에 연결된 모든 장치는 권한 상태가 "granted"인 것으로 간주하여, 제공된 미디어 집합을 얻습니다. 이 문맥에서 동일 권한은 현재 요청되는 것과 동일한 수준의 권한을 획득하는 데 필요했던 MediaStreamTrack을 의미합니다(예: 격리된 것이 아님).

          사용자의 권한을 요청할 때 사용자 에이전트는 권한이 선택된 장치에만 부여되는지 아니면 해당 kind의 모든 장치에 부여되는지를 반드시 공개해야 합니다.

          참고

          사용자가 응답하지 않으면 이 알고리즘은 이 단계에서 멈춥니다.

       2. 요청 결과가 "denied"이면, 아래의 권한 실패라고 표시된 단계로 이동합니다.

    6. hasSystemFocus를 false로 합니다.

    7. hasSystemFocus가 false인 동안, 사용자 에이전트는 시스템 포커스를 가짐 알고리즘의 결과로 hasSystemFocus를 설정하도록 대기열에 넣은 태스크가 hasSystemFocus를 true로 설정할 때까지 다음 단계로 진행하기 위해 반드시 기다려야 합니다.

    8. requestedMediaTypes 및 true를 사용하여 mediaDevices에서 장치 정보 노출을 설정합니다.

    9. requestedMediaTypes의 각 미디어 유형 kind에 대해 다음 하위 단계를 실행합니다:

       1. finalCandidate를 제공된 미디어로 합니다. 이는 finalSet에서 kind 유형의 정확히 하나의 후보여야 합니다. finalSet에서 어떤 후보를 선택할지는 전적으로 사용자 에이전트에 달려 있으며 사용자에게 물어 결정할 수도 있습니다.

          사용자 에이전트는 SelectSettings 알고리즘에서 계산한 적합도 거리 값을 선택 알고리즘의 입력으로 사용해야 합니다. 하지만 사용자 기본 설정과 같이 장치에 관한 내부적으로 이용 가능한 다른 정보를 사용할 수도 있습니다.

          참고

          이는 필수 제약 조건이 아닌 값은 보장되지 않음을 의미합니다.

          사용자 에이전트는 가능한 경우 kind에 대해 사용자의 기본 장치 또는 시스템 기본 장치를 기본값으로 사용할 것을 권장합니다. 사용자 에이전트는 미리 녹화된 미디어 파일을 포함한 모든 미디어 소스를 사용자가 사용하도록 허용할 수 있습니다.

       2. 요청 결과는 "granted"입니다. OS/프로그램/웹페이지 잠금과 같은 하드웨어 오류로 액세스할 수 없으면 해당 후보를 finalSet에서 제거합니다. finalSet에 kind 유형의 후보가 없으면 name 속성 값이 "NotReadableError"인 새 DOMException 객체로 p를 거부하고 이 단계를 중단합니다. 그렇지 않으면 업데이트된 finalSet으로 이 하위 단계를 다시 시작합니다.

          위에 나열된 이유 이외의 이유로 장치 액세스에 실패하면 해당 후보를 finalSet에서 제거합니다. finalSet에 kind 유형의 후보가 없으면 name 속성 값이 "AbortError"인 새 DOMException 객체로 p를 거부하고 이 단계를 중단합니다. 그렇지 않으면 업데이트된 finalSet으로 이 하위 단계를 다시 시작합니다.

       3. grantedDevice를 finalCandidate의 소스 장치로 합니다.

       4. grantedDevice의 deviceId인 deviceId를 사용하여, mediaDevices.[[devicesLiveMap]][deviceId]가 아직 true가 아니라면 true로 설정하고, mediaDevices.[[devicesAccessibleMap]][deviceId]가 아직 true가 아니라면 true로 설정합니다.

       5. track을 grantedDevice와 mediaDevices로 MediaStreamTrack을 생성한 결과로 합니다. MediaStreamTrack의 소스는 변경되어서는 안 됩니다.

       6. track을 stream의 트랙 집합에 추가합니다.

    10. stream의 모든 트랙에 적절한 제약 조건을 사용하여 ApplyConstraints 알고리즘을 실행합니다. 그중 하나라도 undefined 이외의 값을 반환하면 failedConstraint를 그 결과로 하고 아래의 제약 조건 실패라고 표시된 단계로 이동합니다.

    11. stream의 각 track에 대해, track.[[Source]] 및 mediaDevices를 사용하여 트랙 소스를 MediaDevices에 연결합니다.

    12. p를 stream으로 이행하고 이 단계를 중단합니다.

    13. NotFound 실패:

        1. requestedMediaTypes가 주어졌을 때 getUserMedia 특정 실패가 허용됨이 false를 반환하면, 아래의 권한 실패라고 표시된 단계로 이동합니다.

        2. name 속성 값이 "NotFoundError"인 새 DOMException 객체로 p를 거부합니다.

    14. 제약 조건 실패:

        1. requestedMediaTypes가 주어졌을 때 getUserMedia 특정 실패가 허용됨이 false를 반환하면, 아래의 권한 실패라고 표시된 단계로 이동합니다.

        2. message를 undefined 또는 유용한 사람이 읽을 수 있는 메시지로 하고, 장치 정보를 노출할 수 있음이 true이면 constraint를 failedConstraint로 하고, 그렇지 않으면 ""로 합니다.

        3. OverconstrainedError(constraint, message)를 호출하여 생성한 새 OverconstrainedError로 p를 거부합니다.

    15. 권한 실패: name 속성 값이 "NotAllowedError"인 새 DOMException 객체로 p를 거부합니다.

12. p를 반환합니다.

video 유형: (boolean or MediaTrackConstraints), 기본값: false

true이면 반환되는 MediaStream에 비디오 트랙이 포함되도록 요청합니다. Constraints 구조가 제공되면 비디오 트랙의 특성과 설정을 추가로 지정합니다. false이면 MediaStream은 비디오 트랙을 포함해서는 안 됩니다.

audio 유형: (boolean or MediaTrackConstraints), 기본값: false

true이면 반환되는 MediaStream에 오디오 트랙이 포함되도록 요청합니다. Constraints 구조가 제공되면 오디오 트랙의 특성과 설정을 추가로 지정합니다. false이면 MediaStream은 오디오 트랙을 포함해서는 안 됩니다.

getCapabilities

getCapabilities() 메서드는 객체가 지원하는 제약 가능한 속성 이름의 딕셔너리를 반환합니다. 호출되면 사용자 에이전트는 [[Capabilities]] 내부 슬롯의 값을 반드시 반환해야 합니다.

참고

기반 하드웨어가 제약 가능 속성에 정의된 범위와 정확히 일치하지 않을 수 있습니다. 이런 경우가 가능하다면 해당 항목은 하드웨어의 설정을 해당 속성에 정의된 값으로 변환하고 스케일링하는 방법을 정의해야 합니다. 예를 들어 가상의 fluxCapacitance 속성 범위가 -10(min)에서 10(max)이지만 일반적인 하드웨어 장치가 "off", "medium", "full" 값만 지원한다고 가정하겠습니다. 제약 가능 속성 정의는 이러한 하드웨어에 대해 사용자 에이전트가 범위 값 -10을 "off"에, 10을 "full"에, 0을 "medium"에 매핑해야 한다고 지정할 수 있습니다. 또한 엄격한 값 3을 부과하는 ConstraintSet이 주어지면 사용자 에이전트가 하드웨어에서 "medium" 값을 설정하려고 시도해야 하며, getSettings()는 "medium"에 대응하도록 정의된 값이 0이므로 fluxCapacitance를 0으로 반환해야 한다고 나타낼 수도 있습니다.

getConstraints

getConstraints() 메서드는 객체에서 가장 최근에 성공적으로 호출된 ApplyConstraints 알고리즘의 인수였던 Constraints를 지정된 순서를 유지하여 반환합니다. 반환된 일부 고급 ConstraintSet은 현재 충족되지 않을 수도 있다는 점에 유의하십시오. 현재 어떤 ConstraintSet이 적용 중인지 확인하려면 애플리케이션은 getSettings를 사용해야 합니다. 위에서 설명한 정확한 제약 조건을 반환하는 대신 UA는 적용된 제약 조건과 모든 상황에서 동일한 효과를 갖는 제약 조건 집합을 반환할 수 있습니다. 호출되면 사용자 에이전트는 [[Constraints]] 내부 슬롯의 값을 반드시 반환해야 합니다.

getSettings

getSettings() 메서드는 플랫폼 기본값인지 ApplyConstraints 알고리즘에 의해 설정되었는지와 관계없이 객체의 모든 제약 가능한 속성의 현재 설정을 반환합니다. 설정은 제약 조건을 준수하는 목표 값이므로 때때로 측정된 성능과 다를 수 있다는 점에 유의하십시오. 호출되면 사용자 에이전트는 [[Settings]] 내부 슬롯의 값을 반드시 반환해야 합니다.

applyConstraints

applyConstraints 템플릿 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 합니다:

1. object를 이 메서드가 호출된 객체로 합니다.

2. newConstraints를 이 메서드의 인수로 합니다.

3. p를 새 프로미스로 합니다.

4. 이 메서드가 여러 번 호출된 경우 호출 순서를 유지하면서 다음 단계를 병렬로 실행합니다:

   1. failedConstraint를 newConstraints를 인수로 하여 ApplyConstraints 알고리즘을 실행한 결과로 합니다.

   2. successfulSettings를 위 단계의 알고리즘이 완료된 후 object의 현재 설정으로 합니다.

   3. 다음 단계를 실행하는 태스크를 대기열에 넣습니다:

      1. failedConstraint가 undefined가 아니면 message를 undefined 또는 유용한 사람이 읽을 수 있는 메시지로 하고, OverconstrainedError(failedConstraint, message)를 호출하여 생성한 새 OverconstrainedError로 p를 거부한 다음 이 단계를 중단합니다. 이 경우 기존 제약 조건은 계속 적용됩니다.

      2. object의 [[Constraints]] 내부 슬롯을 newConstraints 또는 모든 상황에서 newConstraints와 동일한 효과를 갖는 Constraints 딕셔너리로 설정합니다.

      3. object의 [[Settings]] 내부 슬롯을 successfulSettings로 설정합니다.

      4. p를 undefined로 이행합니다.

5. p를 반환합니다.

제약 조건 적용을 위한 ApplyConstraints 알고리즘은 아래에 기술되어 있습니다. 다음은 알고리즘 기술에 사용되는 몇 가지 예비 정의입니다:

객체에 설정으로 적용될 수 있는 값의 집합을 설정 딕셔너리라고 합니다.

문자열 값 제약 조건의 경우, 아래에서 "=="는 시퀀스의 값 중 하나가 비교 대상 값과 정확히 동일하면 true로 정의합니다.

설정 딕셔너리와 제약 조건 집합 CS 사이의 적합도 거리를 CS에 존재하는 각 멤버(constraintName 및 constraintValue 쌍으로 표현)에 대해 다음 값의 합으로 정의합니다:

1. constraintName을 사용자 에이전트가 지원하지 않으면 적합도 거리는 0입니다.

2. 제약 조건이 필수이고 (constraintValue가 'min', 'max' 또는 'exact'라는 이름의 멤버를 하나 이상 포함하거나, 고급 ConstraintSet 자체의 단일 값인 경우), 설정 딕셔너리의 constraintName 멤버 값이 제약 조건을 충족하지 않거나 존재하지 않으면 적합도 거리는 양의 무한대입니다.

3. 이 유형의 객체에 제약 조건이 적용되지 않으면 적합도 거리는 0입니다(즉, 제약 조건이 적합도 거리에 영향을 주지 않습니다).

4. constraintValue는 불리언이지만 제약 가능 속성이 불리언이 아니라면, 적합도 거리는 설정 딕셔너리의 constraintName 멤버가 존재하는지 여부를 다음 공식에 따라 계산합니다.

   (constraintValue == exists) ? 0 : 1

5. 설정 딕셔너리의 constraintName 멤버가 존재하지 않으면 적합도 거리는 1입니다.

6. 이상적인 값이 지정되지 않은 경우(constraintValue에 'ideal'이라는 이름의 멤버가 없거나, 단일 값을 'ideal'로 취급해야 하는 경우에도 단일 값이 아니라면) 적합도 거리는 0입니다.
7. 모든 양의 숫자 제약 조건(예: height, width, frameRate, aspectRatio, sampleRate 및 sampleSize)의 적합도 거리는 다음 공식의 결과입니다.

   (actual == ideal) ? 0 : |actual - ideal| / max(|actual|, |ideal|)

8. 모든 문자열, 열거형 및 불리언 제약 조건(예: deviceId, groupId, facingMode, resizeMode, echoCancellation)의 적합도 거리는 다음 공식의 결과입니다.

   (actual == ideal) ? 0 : 1

추가 정의:

• ConstraintSet의 각 요소(특수 용어 'advanced' 제외)를 '제약 조건'이라고 합니다. 이는 ConstrainablePattern 객체의 해당 기능에 제공된 전체 목록 또는 범위에서 주어진 속성에 허용되는 설정을 해당 제약 조건이 지정한 범위 또는 값 목록 내의 값으로 제한하려는 것이기 때문입니다.
• 객체 O의 "유효 기능" C는 환경적 제한 및/또는 다른 제약 조건에 의해 부과된 제한을 고려한 C의 가능한 값(getCapabilities가 반환한 값)의 부분집합일 수 있는 집합을 의미합니다. 예를 들어 aspectRatio, height 및 width 속성을 제한하는 ConstraintSet이 주어지면 속성 중 두 개에 할당된 값이 세 번째 속성의 유효 기능을 제한합니다. 유효 기능 집합은 플랫폼에 따라 달라질 수 있습니다. 예를 들어 리소스가 제한된 장치에서는 P1과 P2 속성을 모두 'high'로 설정할 수 없지만 제약이 더 적은 다른 장치에서는 가능할 수 있습니다.
• 객체 O의 제약 가능 속성 값 집합인 설정 딕셔너리가 ConstraintSet CS를 충족한다는 것은 해당 집합과 CS 사이의 적합도 거리가 무한대보다 작다는 의미입니다.
• ConstraintSet 집합 CS1...CSn(n >= 1)은 CS1...CSn을 동시에 충족하는 O의 설정 딕셔너리를 찾을 수 있다면 객체 O가 이를 충족할 수 있습니다.
• ConstraintSet 집합 CS1...CSn을 객체 O에 적용한다는 것은 CS1...CSn을 충족하는 값의 시퀀스를 선택하고 이를 O 속성의 설정으로 할당하는 것입니다.

SelectSettings 알고리즘을 다음과 같이 정의합니다:

1. 각 제약 조건은 해당 속성에 하나 이상의 값(또는 값의 범위)을 지정합니다. 하나의 속성은 'advanced' ConstraintSet 목록에서 두 번 이상 나타날 수 있습니다. 제약 조건의 값으로 빈 목록이 제공된 경우 제약 조건이 지정되지 않은 것처럼 반드시 해석해야 합니다 (즉, 빈 제약 조건 == 제약 조건 없음).

   알 수 없는 속성은 WebIDL에 의해 제거되므로 알 수 없거나 지원되지 않는 필수 제약 조건은 아무런 알림 없이 사라진다는 점에 유의하십시오. 이것이 예상치 못한 결과가 되지 않도록 애플리케이션 작성자는 아래 예제에 표시된 것처럼 먼저 getSupportedConstraints() 메서드를 사용해야 합니다.

2. object를 이 알고리즘이 적용되는 ConstrainablePattern 객체로 합니다. copy를 object의 제약되지 않은 사본으로 합니다(즉, copy는 모든 ConstraintSet이 제거된 object처럼 동작해야 합니다).

3. copy의 가능한 모든 설정 딕셔너리에 대해 속성의 단일 값을 이상적인 값으로 취급하여 적합도 거리를 계산합니다. candidates를 적합도 거리가 유한한 설정 딕셔너리의 집합으로 합니다.

4. candidates가 비어 있으면 SelectSettings 알고리즘의 결과로 undefined를 반환합니다.

5. newConstraints의 'advanced' ConstraintSet을 지정된 순서대로 반복 처리합니다. 각 ConstraintSet에 대해:

   1. 속성의 단일 값을 exact로 취급하여 해당 ConstraintSet과 candidates의 각 설정 딕셔너리 사이의 적합도 거리를 계산합니다.

   2. candidates에 있는 하나 이상의 설정 딕셔너리에 대해 적합도 거리가 유한하면 해당 설정 딕셔너리만 candidates에 유지하고 나머지는 버립니다.

      candidates의 모든 설정 딕셔너리에 대해 적합도 거리가 무한대이면 이 ConstraintSet을 무시합니다.

6. candidates에서 설정 딕셔너리 하나를 선택하여 SelectSettings 알고리즘의 결과로 반환합니다. 사용자 에이전트는 3단계에서 계산한 적합도 거리가 가장 작은 것을 반드시 사용해야 합니다. 가장 작은 적합도 거리를 가진 설정 딕셔너리가 둘 이상이면 사용자 에이전트가 시스템 기본 속성 값 및 사용자 에이전트 기본 속성 값을 기반으로 그중 하나를 선택합니다.

선택된 장치에 대해 시스템 기본값이 있는 모든 속성은 위 알고리즘과 호환되는 경우 시스템 기본값을 사용해야 합니다. 이는 일반적으로 sampleRate 또는 sampleSize 같은 속성에 해당합니다. echoCancellation이나 resizeMode 같은 다른 속성에는 일반적으로 시스템 기본값이 없습니다. 사용자 에이전트는 이러한 속성에 대한 자체 기본값을 정의합니다. 구현자는 기본값이 미디어 콘텐츠 생성 방식에 자주 영향을 미치므로 적절한 기본값을 선택하도록 주의해야 합니다.

참고

의미 있는 기본값을 선택하기 위해 기존 구현을 살펴볼 것을 권장합니다. 기본값은 시스템에 따라, 예를 들어 데스크톱과 모바일에서 다를 수 있다는 점에 유의하십시오. 작성 시점에 사용자 에이전트 구현은 다음 기본값을 사용하는 경향이 있으며, 이는 RTCPeerConnection을 싱크로 사용하는 데 적합하도록 선택되었습니다:

1. width를 640으로 설정합니다.

2. height를 480으로 설정합니다.

3. frameRate를 30으로 설정합니다.

4. echoCancellation을 true로 설정합니다.

newConstraints가 인수로 주어졌을 때 object에 ApplyConstraints 알고리즘을 적용하려면 사용자 에이전트는 다음 단계를 반드시 실행해야 합니다:

1. successfulSettings를 newConstraints를 제약 조건 집합으로 하여 SelectSettings 알고리즘을 실행한 결과로 합니다.

2. successfulSettings가 undefined이면 failedConstraint를 SelectSettings 알고리즘 실행 중 검사한 모든 설정 딕셔너리에서 적합도 거리가 무한대였던 임의의 필수 제약 조건으로 하거나, 그러한 것이 없다면 ""로 한 다음 failedConstraint를 반환하고 이 단계를 중단합니다.

3. 하나의 연산으로 object에서 기존 제약 조건을 제거하고, newConstraints를 적용한 다음 successfulSettings를 현재 설정으로 적용합니다.
4. undefined를 반환합니다.

참고

예를 들어 트랙이 음소거되어 UA가 장치를 해제했다면, 설정을 적용한다고 해서 장치 구성을 변경한다는 의미는 아닙니다. 대신 UA는 장치를 다시 획득할 때, 예를 들어 트랙이 음소거 해제될 때 트랙 설정과 일치하도록 장치를 구성합니다.

참고

위 알고리즘과 동일한 결과를 내는 모든 구현은 허용되는 구현입니다. 예를 들어 구현은 설정의 가능한 모든 값을 추적하는 대신 고려된 제약 조건에서 허용되는 설정의 최댓값과 최솟값을 추적하도록 선택할 수 있습니다.

참고

설정 딕셔너리를 선택할 때 UA는 자신이 이용할 수 있는 모든 정보를 사용할 수 있습니다. 이러한 정보의 예로는 getUserMedia의 장치 선택 과정에서 선택이 이루어지는지, 카메라의 에너지 사용량이 설정 딕셔너리마다 달라지는지 또는 설정 딕셔너리를 사용하면 장치 드라이버가 리샘플링을 적용하게 되는지 등이 있습니다.

사용자 에이전트는 언제든지 객체의 제약 가능한 속성에 새로운 설정을 선택할 수 있습니다. 그렇게 하는 경우 위 알고리즘에 설명된 방식으로 현재 모든 Constraints를 충족하려고 반드시 시도해야 하며, successfulSettings를 그 결과의 새 설정으로 하고 다음 단계를 실행하는 태스크를 대기열에 넣어야 합니다:

1. object를 하나 이상의 제약 가능한 속성에 대한 새 설정이 변경된 ConstrainablePattern 객체로 합니다.

2. object의 [[Settings]] 내부 슬롯을 successfulSettings로 설정합니다.

max 유형: double

이 속성의 유효한 최댓값입니다.

min 유형: double

이 속성의 최솟값입니다.

exact 유형: double

이 속성에 필요한 정확한 값입니다.

ideal 유형: double

이 속성의 이상적인(목표) 값입니다.

max 유형: unsigned long

이 속성의 유효한 최댓값입니다.

min 유형: unsigned long

이 속성의 최솟값입니다.

exact 유형: unsigned long

이 속성에 필요한 정확한 값입니다.

ideal 유형: unsigned long

이 속성의 이상적인(목표) 값입니다.

exact 유형: boolean

이 속성에 필요한 정확한 값입니다.

ideal 유형: boolean

이 속성의 이상적인(목표) 값입니다.

exact 유형: (DOMString or sequence<DOMString>)

이 속성에 필요한 정확한 값입니다.

ideal 유형: (DOMString or sequence<DOMString>)

이 속성의 이상적인(목표) 값입니다.

exact 유형: (boolean 또는 DOMString)

이 속성에 필요한 정확한 값입니다.

ideal 유형: (boolean 또는 DOMString)

이 속성의 이상적인(목표) 값입니다.