Document Object Model APIs

settings_applicationsEventTarget  >   settings_applicationsNode  >   settings_applicationsElement  >   settings_applicationsHTMLElement  >   settings_applicationsHTMLMediaElement  >   settings_applications[[Prototype]]

Document Object Model APIs

Editing
  • settings_backup_restore
  • bug_report

PromisepromisesetSinkId(stringsinkId)

오디오를 출력할 장치의 ID를 지정하고 Promise 객체를 반환한다.

구문

형식
htmlMediaElement.setSinkId(sinkId)

매개 변수

stringsinkId필수

오디오 출력 장치의 MediaDeviceInfo.prototype.deviceId 프로퍼티의 값으로 확인되는 식별값을 지정한다.

반환

Promisepromise

undefined로 이행되는 Promise 객체를 반환한다.

다음의 예외가 발생할 수 있다.

NotAllowedError
스피커 선택 권한 정책이 오디오 출력 사용을 차단하는 데 사용되는 경우 발생한다.
NotFoundError
설정된 장치의 ID가 오디오 출력 장치와 일치하지 않으면 발생한다.
AbortError
오디오 출력 장치를 새로운 오디오 장치로 전환하는 데 실패한 경우 발생한다.

Exception

DOMException

DOM API의 메소드를 호출하거나 프로퍼티에 접근한 결과 발생하는 비정상적인 이벤트(예외)를 나타낸다.

AbortError

작업이 중단되었음을 나타낸다.

NotAllowedError

현재 컨텍스트의 유저 에이전트 또는 플랫폼에서 요청을 허용하지 않음을 나타낸다.

NotFoundError

대상을 찾을 수 없다.

버전 명세

Audio Output Devices API
#dom-htmlmediaelement-setsinkid

지원 웹브라우저