오디오 출력 장치 API

sinkId, 타입은 DOMString, 읽기 전용

이 속성은 오디오 출력이 전달되고 있는 오디오 장치의 ID를 포함하거나, 출력이 사용자 에이전트 기본 장치를 통해 전달되는 경우 빈 문자열을 포함합니다. 비어 있지 않으면 이 ID는 enumerateDevices()에서 반환된 MediaDeviceInfo 값 중 하나의 deviceId 속성과 같아야 합니다.

가져올 때, 이 속성은 [[SinkId]] 슬롯의 값을 반환해야 MUST 합니다.

setSinkId

애플리케이션이 주어진 장치로 재생할 수 있도록 허용된 경우, 오디오 출력이 렌더링되어야 하는 오디오 장치의 ID를 설정합니다.

이 메서드가 호출될 때, 사용자 에이전트는 다음 단계를 실행해야 합니다:

1. globalObject를 현재 설정 객체의 관련 전역 객체로 둡니다.

2. document를 globalObject의 연결된 Document로 둡니다.

3. document가 사용할 수 있는 기능 중 "speaker-selection"으로 식별되는 기능을 사용할 수 없는 경우, 이름이 NotAllowedError인 새 DOMException으로 거부된 promise를 반환합니다.

4. globalObject에 일시적 활성화가 없는 경우, 사용자 에이전트는 name 속성 값이 InvalidStateError인 DOMException 객체로 거부된 promise를 반환할 수 MAY 있습니다.

5. element를 이 메서드가 호출된 HTMLMediaElement 객체로 둡니다.

6. sinkId를 메서드의 첫 번째 인수로 둡니다.

7. sinkId가 element의 [[SinkId]]와 같으면, undefined로 해결된 promise를 반환합니다.

8. p를 새 promise로 둡니다.

9. 다음 하위 단계를 병렬로 실행합니다:

   1. sinkId가 빈 문자열이 아니고 enumerateDevices()가 제공할 결과에 의해 식별되는 어떤 오디오 출력 장치와도 일치하지 않으면, 이름이 NotFoundError인 새 DOMException으로 p를 거부하고 이 하위 단계를 중단합니다.

   2. sinkId가 빈 문자열이 아니고, sinkId로 식별되는 장치가 현재 사용자 에이전트 기본 장치가 아니었다면 애플리케이션이 해당 장치를 통해 오디오를 재생하도록 허용되지 않았을 경우, 이름이 NotAllowedError인 새 DOMException으로 p를 거부하고 이 하위 단계를 중단합니다.

   3. element의 기반 오디오 출력 장치를 sinkId로 식별되는 오디오 장치로 전환합니다.

      참고

      이 하위 단계가 성공하고 미디어 요소의 paused 속성이 false인 경우, 오디오는 요소의 sinkId 속성이 나타내는 장치에서 재생되는 것을 중지해야 MUST 하며, sinkId로 식별되는 장치에서 재생되기 시작합니다.

   4. 앞의 하위 단계가 실패한 경우, 이름이 AbortError인 새 DOMException으로 p를 거부하고 이 하위 단계를 중단합니다.

   5. 다음 단계를 실행하는 태스크를 큐에 넣습니다:

      1. element의 [[SinkId]]를 sinkId로 설정합니다.

      2. p를 해결합니다.

10. p를 반환합니다.

selectAudioOutput

사용자에게 특정 오디오 출력 장치를 선택하도록 요청합니다.

selectAudioOutput 메서드가 호출될 때, 사용자 에이전트는 다음 단계를 실행해야 MUST 합니다:

1. this의 관련 전역 객체에 일시적 활성화가 없는 경우, name 속성 값이 InvalidStateError인 DOMException 객체로 거부된 promise를 반환합니다.

2. options를 메서드의 첫 번째 인수로 둡니다.

3. deviceId를 options.deviceId로 둡니다.

4. mediaDevices를 this로 둡니다.

5. p를 새 promise로 둡니다.

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

   1. descriptor를 PermissionDescriptor로 두고, 그 name을 "speaker-selection"으로 설정합니다.

   2. descriptor의 권한 상태가 "denied"이면, name 속성 값이 NotAllowedError인 새 DOMException으로 p를 거부하고 이 단계를 중단합니다.

   3. 사용 가능한 오디오 출력 장치에 대해 사용자 에이전트를 탐색합니다.

   4. 오디오 출력 장치가 없으면, name 속성 값이 NotFoundError인 새 DOMException으로 p를 거부하고 이 단계를 중단합니다.

   5. deviceId가 ""가 아니면 다음 하위 단계를 실행합니다:

      1. deviceId가 이 탐색 세션 또는 이전 탐색 세션에서 selectAudioOutput에 의해 이전에 노출된 장치 ID와 일치하거나, 이 탐색 세션 또는 이전 탐색 세션에서 getUserMedia()에 의해 이전에 노출된 오디오 입력 장치와 동일한 groupId를 가진 오디오 출력 장치의 장치 ID와 일치하는 경우, 사용자 에이전트는 이 출처 집합에 대해 이 ID를 지속할지 여부에 대한 이전 결정에 기반하여 다음 하위 단계를 실행하기로 결정할 수 MAY 있습니다:

         1. device를 사용 가능한 경우 deviceId로 식별되는 장치로 둡니다.

         2. device를 사용할 수 있으면, p를 deviceId 또는 device에 대해 새로 회전된 장치 ID로 해결하고, 병렬 단계를 중단합니다.

   6. descriptor와 함께 오디오 출력 장치를 사용자가 선택하도록 요청합니다.

   7. 요청의 결과가 "denied"이면, name 속성 값이 NotAllowedError인 새 DOMException으로 p를 거부하고 이 단계를 중단합니다.

   8. selectedDevice를 사용자가 선택한 오디오 출력 장치로 둡니다.

   9. deviceInfo를 selectedDevice를 나타내도록 장치 정보 객체를 생성한 결과로 두며, mediaDevices를 사용합니다.

   10. deviceInfo.deviceId를 [[explicitlyGrantedAudioOutputDevices]]에 추가합니다.

   11. p를 deviceInfo로 해결합니다.

7. p를 반환합니다.

selectAudioOutput 호출 후 장치가 한 번 노출되면, 해당 장치는 현재 탐색 컨텍스트에서 enumerateDevices()에 의해 나열되어야 MUST 합니다.

selectAudioOutput가 반환한 promise가 해결되면, 사용자 에이전트는 문서가 추가적인 사용자 제스처 없이도 HTMLMediaElement에서 미디어를 즉시 재생할 수 있도록 허용되고, 또한 AudioContext를 즉시 시작할 수 있도록 허용되도록 보장해야 MUST 합니다.

참고

이는 현재 브라우저의 자동 재생에 대한 표준화가 부족하기 때문에 부정확합니다.

이 딕셔너리는 오디오 출력 장치에 대한 접근 권한을 얻는 데 사용할 수 있는 옵션을 설명합니다.

WebIDLdictionary AudioOutputOptions {
  DOMString deviceId = "";
};