HTMLMediaElement.autoplay

HTMLMediaElement.autoplay 프로퍼티는 autoplay HTML 어트리뷰트의 값을 반환합니다. 이 프로퍼티는 미디어가 문제 없이 재생 가능한 상황이 되면 자동 재생 여부를 결정합니다.

미디어 엘리먼트의 소스가 MediaStream이며 autoplay 프로퍼티가 true 일 경우 액티브 상태가 되면 재생합니다 (즉, MediaStream.active가 true가 될 때).

Note: 오디오(또는 오디오가 있는 비디오)를 자동으로 재생하는 사이트는 사용자에게 그리 탐탁치 않은 경험일 수 있습니다, 그러므로 가능한 한 지양해야합니다. 자동 재생 기능을 제공하려면, 사전 동의(사용자에게 기능을 켜도록 함)를 받아야 합니다. 의외로 이 점은 사용자의 조작에 의해 미디어 엘레먼츠를 늦게 생성하는 경우 유용할 수 있습니다.

자동 재생과 자동 재생 제한, 그리고 브라우저의 자동 재생 제한에 대처하는 법에 대해 자세히 알고 싶다면 미디어 자동 재생과 Web Audio API 가이드 문서를 참조하세요.

문법

HTMLMediaElement.autoplay = true | false;

var autoplay = HTMLMediaElement.autoplay;

미디어가 재생 가능할 정도로 로드되고 문제 없이 재생 가능할 때 자동 재생 여부를 Boolean true 로 반환한다.

Note: 특정 브라우저는 사용자 설정을 통해 autoplay 프로퍼티를 무시하고 비디오/오디오 자동 재생을 막는 기능을 제공합니다. 자동 재생을 위해 autoplay 프로퍼티를 맹신하지 마세요.

예제

...

<video id="video" controls> 
  <source src="https://player.vimeo.com/external/250688977.sd.mp4?s=d14b1f1a971dde13c79d6e436b88a6a928dfe26b&profile_id=165">
</video>
*** Disable autoplay (recommended) ***
      false is the default value
        document.querySelector('#video').autoplay = false;

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'HTMLMediaElement.autoplay' in that specification.
Living Standard No change from HTML5
HTML5
The definition of 'HTMLMediaElement.autoplay' in that specification.
Recommendation Initial definition.

브라우저 호환성

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
autoplayChrome Full support 43Edge Full support 12Firefox Full support 3.5IE Full support 9Opera Full support 30Safari Full support 6WebView Android Full support 43Chrome Android Full support 43Firefox Android Full support YesOpera Android Full support 30Safari iOS Full support YesSamsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown

더 보기