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

Promisepromiseplay()

미디어의 재생을 시도한다.

설명

미디어의 재생을 시도하며 Promise 객체를 반환한다. 반환된 Promise 객체를 통해서 재생이 시작되었는지 또는 재생이 거부된 상태를 확인할 수 있다.

구문

형식
htmlMediaElement.play()

로드 시 자동 재생이 허용되지 않는 유저 에이전트의 경우 자동 재생 시도시 반환된 Promise 객체가 'NotAllowedError' 예외와 함께 거부된다.

반환

Promisepromise

미디어의 재생 시도 결과에 대한 정보를 가진 Promise 객체를 반환한다.

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

NotAllowedError
유저 에이전트 또는 운영 체제가 현재 컨텍스트 또는 상황에서 미디어 재생을 허용하지 않는 경우에 발생한다. 
NotSupportedError
미디어 소스가 지원되는 미디어 형식이 아닐 경우 발생한다.

Exception

DOMException

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

NotAllowedError

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

NotSupportedError

대상에 대해 지원되지 않는 작업을 나타낸다.

버전 명세

HTML Standard API
#dom-media-play-dev

지원 웹브라우저