---
title: HTMLMediaElement.autoplay
slug: Web/API/HTMLMediaElement/autoplay
translation_of: Web/API/HTMLMediaElement/autoplay
---
<p>{{APIRef("HTML DOM")}}</p>

<p><span class="seoSummary"><strong><code>HTMLMediaElement.autoplay</code></strong> 프로퍼티는 {{htmlattrxref("autoplay", "video")}} HTML 어트리뷰트의 값을 반환합니다. 이 프로퍼티는 미디어가 문제 없이 재생 가능한 상황이 되면 자동 재생 여부를 결정합니다.</span></p>

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

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

<p>자동 재생과 자동 재생 제한, 그리고 브라우저의 자동 재생 제한에 대처하는 법에 대해 자세히 알고 싶다면 <a href="/en-US/docs/Web/Media/Autoplay_guide">미디어 자동 재생과 Web Audio API 가이드</a> 문서를 참조하세요.</p>

<h2 id="Syntax" name="Syntax">문법</h2>

<pre class="syntaxbox"><em>HTMLMediaElement</em>.autoplay = true | false;

var <em>autoplay</em> = <em>HTMLMediaElement</em>.autoplay;</pre>

<h3 id="값">값</h3>

<p>미디어가 재생 가능할 정도로 로드되고 문제 없이 재생 가능할 때 자동 재생 여부를 {{domxref("Boolean")}} <code>true</code> 로 반환한다.</p>

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

<h2 id="예제">예제</h2>

<p>...</p>

<pre class="brush: html">&lt;video id="video" controls&gt;
  &lt;source src="https://player.vimeo.com/external/250688977.sd.mp4?s=d14b1f1a971dde13c79d6e436b88a6a928dfe26b&amp;profile_id=165"&gt;
&lt;/video&gt;</pre>

<pre>*** Disable autoplay (recommended) ***
      false is the default value
        document.querySelector('#video').autoplay = false;

</pre>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', "embedded-content.html#dom-media-autoplay", "HTMLMediaElement.autoplay")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>No change from {{SpecName('HTML5 W3C')}}</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', "embedded-content-0.html#htmlmediaelement", "HTMLMediaElement.autoplay")}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="브라우저_호환성">브라우저 호환성</h2>



<p>{{Compat("api.HTMLMediaElement.autoplay")}}</p>

<h2 id="See_Also" name="See_Also">더 보기</h2>

<ul>
 <li>정의된 인터페이스 {{domxref("HTMLMediaElement")}}.</li>
 <li>{{HTMLElement("audio")}}, {{HTMLElement("video")}} 엘리먼트</li>
</ul>