path: root/files/ko/web/api/htmlmediaelement/index.html

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

<p><span class="seoSummary"><strong><code>HTMLMediaElement</code></strong>는 오디오와 비디오에 통용되는 미디어 관련 확장성을 제공하기 위해 {{domxref("HTMLElement")}}에 메소드와 프로퍼티를 추가한 인터페이스입니다.</span> {{domxref("HTMLVideoElement")}} 와 {{domxref("HTMLAudioElement")}} 는 이 인터페이스를 상속합니다.</p>

<p>{{InheritanceDiagram(600, 120)}}</p>

<h2 id="속성(Properties)">속성(Properties)</h2>

<p><em>이 인터페이스는 {{domxref("HTMLElement")}}, {{domxref("Element")}}, {{domxref("Node")}}, and {{domxref("EventTarget")}}의 프로퍼티들도 모두 상속합니다.</em></p>

<dl>
 <dt>{{domxref("HTMLMediaElement.audioTracks")}}</dt>
 <dd>{{domxref("AudioTrackList")}}는 엘레먼트의 {{domxref("AudioTrack")}} 객체의 목록입니다.</dd>
 <dt>{{domxref("HTMLMediaElement.autoplay")}}</dt>
 <dd>미디어가 준비된 즉시 재생할 것인지 결정하는 {{htmlattrxref("autoplay", "video")}} 속성에 연결된 {{jsxref("Boolean")}}값입니다..
 <div class="note"><strong>Note</strong>: 오디오(또는 오디오가 있는 비디오)를 자동으로 재생하는 사이트는 사용자에게 그리 탐탁치 않은 경험일 수 있습니다, 그러므로 가능한 한 지양해야합니다. 자동 재생 기능을 제공하려면, 사전 동의(사용자에게 기능을 켜도록 함)를 받아야 합니다. 의외로 이 점은 사용자의 조작에 의해 미디어 엘레먼츠를 늦게 생성하는 경우 유용할 수 있습니다.</div>
 </dd>
 <dt>{{domxref("HTMLMediaElement.buffered")}} {{readonlyinline}}</dt>
 <dd><code>buffered</code> 프로퍼티에 접근한 시점에 브라우저가 버퍼에 담고 있는 미디어 소스의 구간 데이터를 나타내는 {{domxref("TimeRanges")}} 객체를 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.controller")}}</dt>
 <dd>미디어 엘레먼트에 할당된 {{domxref("MediaController")}} 객체를 반환하거나 없다면 null을 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.controls")}}</dt>
 <dd>미디어 엘레먼트에 컨트롤를 표시할지 결정하는 {{htmlattrxref("controls", "video")}} HTML 속성 값을 {{jsxref('Boolean')}}으로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.controlsList")}} {{readonlyinline}}</dt>
 <dd>브라우저가 미디어 엘레먼트에 자체 컨트롤을 표시할 때 어떤 컨트롤을 보여주거나 숨길 지 결정하는 {{domxref("DOMTokenList")}}를 반환합니다. . <code>DOMTokenList<font face="Arial, x-locale-body, sans-serif"><span style="background-color: #ffffff;">는 </span></font></code><code>nodownload</code>, <code>nofullscreen</code>, <code>noremoteplayback</code> 값을 가질 수 있습니다.</dd>
 <dt>{{domxref("HTMLMediaElement.crossOrigin")}}</dt>
 <dd>{{domxref("DOMString")}}미디어 엘레먼트의 <a href="/en-US/docs/Web/HTML/CORS_settings_attributes">CORS 설정</a>값을 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.currentSrc")}} {{readonlyinline}}</dt>
 <dd>현재 선택된 미디어 소스 URL의 절대 경로를 {{domxref("DOMString")}}로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.currentTime")}}</dt>
 <dd>현재 재생 시점을 초 단위로 표현한 <code>double</code>값입니다. 이 값을 세팅하여 재생 시점을 변경할 수 있습니다.</dd>
 <dt>{{domxref("HTMLMediaElement.defaultMuted")}}</dt>
 <dd>{{jsxref('Boolean')}} 기본적으로 음소거 상태인지 표시하는 {{htmlattrxref("muted", "video")}} HTML 속성 값을 {{jsxref('Boolean')}}으로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.defaultPlaybackRate")}}</dt>
 <dd>미디어 기본 재생 배속을 <code>double</code> 값으로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.disableRemotePlayback")}}</dt>
 <dd>Is a {{jsxref('Boolean')}} that sets or returns the remote playback state, indicating whether the media element is allowed to have a remote playback UI.</dd>
 <dt>{{domxref("HTMLMediaElement.duration")}} {{readonlyinline}}</dt>
 <dd>미디어의 전체 길이를 초 단위로 <code>double</code> 값으로 반환합니다. 재생 가능한 미디어가 없을 경우 0을 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.ended")}} {{readonlyinline}}</dt>
 <dd>미디어 재생 완료 여부를 {{jsxref('Boolean')}} 값으로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.error")}} {{readonlyinline}}</dt>
 <dd>마지막으로 발생한 {{domxref("MediaError")}} 객체를 반환합니다. 발생한 에러가 없을 경우 <code>null</code>을 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.loop")}}</dt>
 <dd>미디어의 반복 재생을 결정하는 HTML 속성 {{htmlattrxref("loop", "video")}} 값을{{jsxref('Boolean')}}으로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.mediaGroup")}}</dt>
 <dd>미디어가 속한 그룹을 나타내는 {{ htmlattrxref("mediagroup", "video")}} 속성을 {{domxref("DOMString")}} 값으로 반환합니다. 같은 그룹에 속한 미디어들은 동일한  {{domxref('MediaController')}}에 의해 제어됩니다.</dd>
 <dt>{{domxref("HTMLMediaElement.mediaKeys")}} {{readonlyinline}} {{experimental_inline}}</dt>
 <dd>{{domxref("MediaKeys")}} 객체 또는 <code>null</code>을 반환합니다. MediaKeys는 재생할 미디어 데이터를 복호화 하는데 사용합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.mozAudioCaptured")}} {{readonlyinline}} {{non-standard_inline}}</dt>
 <dd>오디오 스트림 캡쳐 여부를 {{jsxref('Boolean')}} 값으로 반환합니다. (Mozilla 전용 비표준 속성.)</dd>
 <dt>{{domxref("HTMLMediaElement.mozFragmentEnd")}} {{non-standard_inline}}</dt>
 <dd>MediaElement의 <code>currentSrc</code>에 fragment URI가 존재하는 경우 fragment end time을 <code>double</code> 값으로 반환합니다. 없을 경우 미디어 길이를 반환합니다. (Mozilla 전용 비표준 속성)</dd>
 <dt>{{domxref("HTMLMediaElement.mozFrameBufferLength")}} {{non-standard_inline}} {{deprecated_inline}}</dt>
 <dd>
 <p><code>MozAudioAvailable</code> 이벤트 발생시마다 반환된 framebuffer의 샘플 숫자를 <code>unsigned long</code> 로 반환한다. 이 숫자는 모든 오디오 채널의 총합이며, 기본값은 채널 수 * 1024(예, 2 채널 * 1024 샘플 = 2048)이다.</p>

 <p>레이턴시가 낮은 경우 <code>mozFrameBufferLength</code> 를 더 큰 값으로 지정할 수도 있습니다. 범위는 512에서 16384 사이입니다. 범위를 넘어서는 값은 Error를 발생시킵니다. <a href="/en-US/docs/Web/Events/loadedmetadata">loadedmetadata</a> 이벤트가 발생할 때 새 값을 지정하는 것이 적절합니다. 오디오 정보는 알고 있지만 재생 시작 전 또는 <code>MozAudioAvailable</code> 이벤트가 발생하기 전 시점이죠.</p>
 </dd>
 <dt>{{domxref("HTMLMediaElement.mozSampleRate")}} {{readonlyinline}} {{non-standard_inline}} {{deprecated_inline}}</dt>
 <dd>디지털 샘플링 주파수 값을 <code>double</code>로 반환합니다. 예를 들어 CD 오디오의 경우 초당 44100 샘플을 가집니다.</dd>
 <dt>{{domxref("HTMLMediaElement.muted")}}</dt>
 <dd>오디오 음소거 여부를 {{jsxref('Boolean')}} 값으로 반환합니다. 음소거라면 <code>true</code> 반대는 <code>false</code> 를 반환합니다..</dd>
 <dt>{{domxref("HTMLMediaElement.networkState")}} {{readonlyinline}}</dt>
 <dd>네트워크를 통한 미디어 데이터 전송 상태를 <code>unsigned short</code> (enumeration)으로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.paused")}} {{readonlyinline}}</dt>
 <dd>미디어 일시 정지 여부를 {{jsxref('Boolean')}} 값으로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.playbackRate")}}</dt>
 <dd>재생 속도를 <code>double</code> 값으로 반환합니다. </dd>
 <dt>{{domxref("HTMLMediaElement.played")}} {{readonlyinline}}</dt>
 <dd>브라우저에서 재생된 미디어 소스 범위를 포함한 {{domxref('TimeRanges')}} 객체를 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.preload")}}</dt>
 <dd>프리로드 할 데이터 타입을 명시하는  {{htmlattrxref("preload", "video")}} attribute를 {{domxref("DOMString")}} 값으로 반환한다. 가능한 값들 : <code>none</code>, <code>metadata</code>, <code>auto</code>.</dd>
 <dt>{{domxref("HTMLMediaElement.preservesPitch")}} {{non-standard_inline}}</dt>
 <dd>사운드 피치 유지 여부를 {{jsxref('Boolean')}} 값으로 반환합니다. <code>false</code> 일 경우, 오디오 재생 속도에 따라 변하게 됩니다. Firefox의 (<code>mozPreservesPitch</code>)와 WebKit의 (<code>webkitPreservesPitch</code>)로 구현되어 있습니다.</dd>
 <dt>{{domxref("HTMLMediaElement.readyState")}} {{readonlyinline}}</dt>
 <dd>미디어 대기 상태를 <code>unsigned short</code> (enumeration)으로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.seekable")}} {{readonlyinline}}</dt>
 <dd>탐색(seeking) 가능한 범위를 포함한 {{domxref('TimeRanges')}} 객체를 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.seeking")}} {{readonlyinline}}</dt>
 <dd>탐색(seeking) 중 여부를 {{jsxref('Boolean')}} 값으로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.sinkId")}} {{readonlyinline}} {{experimental_inline}}</dt>
 <dd>별도의 오디오 재생 장치로 출력중이라면 장치의 unique ID를 {{domxref("DOMString")}} 으로 반환합니다. 브라우저로 재생 중이라면 빈 문자열입니다. 이 ID는 {{domxref("MediaDevices.enumerateDevices()")}}에서 반환된 <code>MediaDeviceInfo.deviceid</code>, <code>id-multimedia</code>, <code>id-communications</code> 중 하나입니다.</dd>
 <dt>{{domxref("HTMLMediaElement.src")}}</dt>
 <dd>미디어 리소스 URL이 포함된 {{htmlattrxref("src", "video")}} attribute를 {{domxref("DOMString")}} 값으로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.srcObject")}}</dt>
 <dd>현재 <code>HTMLMediaElement</code> 객체에서 재생 중이거나 재생 되었던 미디어를 표현하는 {{domxref('MediaStream')}} 객체를 반환합니다. 없는 경우, <code>null</code> 을 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.textTracks")}} {{readonlyinline}}</dt>
 <dd>{{domxref("TextTrack")}} 리스트를 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.videoTracks")}} {{readonlyinline}}</dt>
 <dd>{{domxref("VideoTrack")}} 리스트를 반환합니다..
 <div class="note">
 <p>Gecko는 싱글 트랙 재생만을 지원합니다. 또한 트랙 메타데이터 파싱은 Ogg 컨테이너 포맷에서만 가능합니다..</p>
 </div>
 </dd>
 <dt>{{domxref("HTMLMediaElement.volume")}}</dt>
 <dd>오디오 볼륨을 <code>double</code> 값으로 반환합니다. 0.0 (무음)에서 1.0 (최대크기) 사이 값을 가집니다..</dd>
</dl>

<h3 id="이벤트_핸들러(Event_handlers)">이벤트 핸들러(Event handlers)</h3>

<dl>
 <dt></dt>
 <dt>{{domxref("HTMLMediaElement.onencrypted")}}</dt>
 <dd>미디어 암호화 시 호출되는 {{domxref('EventHandler')}}를 설정합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.onwaitingforkey")}}</dt>
 <dd>재생하기 위해 복호화 키가 필요한 경우 호출되는 {{domxref('EventHandler')}}를 설정합니다..</dd>
</dl>

<h2 id="폐기된_속성(Obsolete_attributes)">폐기된 속성(Obsolete attributes)</h2>

<p>아래 속성들은 폐기되었으며 브라우저가 지원하더라도 사용되지 않아야 합니다.</p>

<dl>
 <dt>{{domxref("HTMLMediaElement.initialTime")}} {{readonlyinline}} {{non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>최초 재생 지점을 초 단위로 <code>double</code> 값으로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.mozChannels")}} {{readonlyinline}} {{non-standard_inline}} {{deprecated_inline}}</dt>
 <dd>오디오 채널 수를 <code>double</code> 값으로 반환합니다. (예, 스테레오인 경우 <code>2</code>).</dd>
</dl>

<h3 id="폐기된_이벤트_핸들러(Obsolete_event_handlers)">폐기된 이벤트 핸들러(Obsolete event handlers)</h3>

<dl>
 <dt>{{domxref("HTMLMediaElement.onmozinterruptbegin")}} {{non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>Audio Channel manager에 의해 재생이 인터럽트 된 경우 호출되는 {{domxref("EventHandler")}} 를 설정합니다. Firefox 전용 기능으로 Firefox OS에서 추가되었으며 Firefox 55 버전에서 제거되었습니다.</dd>
 <dt>{{domxref("HTMLMediaElement.onmozinterruptend")}} {{non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>재생 인터럽트가 해결된 경우 호출되는 {{domxref('EventHandler')}}를 설정합니다. Firefox 전용 기능으로 Firefox OS에서 추가되었으며 Firefox 55 버전에서 제거되었습니다.</dd>
</dl>

<h2 id="메소드">메소드</h2>

<p><em>This interface also inherits methods from its ancestors {{domxref("HTMLElement")}}, {{domxref('Element')}}, {{domxref('Node')}}, and {{domxref('EventTarget')}}.</em></p>

<dl>
 <dt>{{domxref("HTMLMediaElement.addTextTrack()")}}</dt>
 <dd>미디어 엘리먼트에 본문 트랙(자막 등)을 추가합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.captureStream()")}} {{experimental_inline}}</dt>
 <dd>미디어 콘텐트의 스트림을 캡쳐하여 {{domxref("MediaStream")}} 객체로 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.canPlayType()")}}</dt>
 <dd>현재 지정된 미디어 타입을 재생할 수 있는지 확인합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.fastSeek()")}}</dt>
 <dd>입력된 시간으로 바로 이동합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.load()")}}</dt>
 <dd>미디어를 처음으로 리셋하고 {{htmlattrxref("src", "video")}} 어트리뷰트 또는 {{HTMLElement("source")}} 엘리먼트로 전달된 소스 중 최적의 소스를 선택합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.mozCaptureStream()")}} {{non-standard_inline}}</dt>
 <dd>[enter description]</dd>
 <dt>{{domxref("HTMLMediaElement.mozCaptureStreamUntilEnded()")}} {{non-standard_inline}}</dt>
 <dd>[enter description]</dd>
 <dt>{{domxref("HTMLMediaElement.mozGetMetadata()")}} {{non-standard_inline}}</dt>
 <dd>Returns {{jsxref('Object')}}, which contains properties that represent metadata from the playing media resource as <code>{key: value}</code> pairs. A separate copy of the data is returned each time the method is called. This method must be called after the <a href="/en-US/docs/Web/Events/loadedmetadata">loadedmetadata</a> event fires.</dd>
 <dt>{{domxref("HTMLMediaElement.pause()")}}</dt>
 <dd>미디어 재생을 일시 정지합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.play()")}}</dt>
 <dd>미디어를 재생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.seekToNextFrame()")}} {{non-standard_inline}} {{experimental_inline}}</dt>
 <dd>미디어의 다음 프레임으로 이동합니다. 비표준이며 실험적인 이 기능은 미디어를 읽고 렌더링 하는 속도를 조절할 수 있게 하거나 프레임별로 필터링 등 추가적인 기능을 수행할 수 있게 합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.setMediaKeys()")}} {{experimental_inline}}</dt>
 <dd>미디어 복호화에 필요한 키를 지정합니다. {{jsxref("Promise")}} 객체를 반환합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.setSinkId()")}} {{experimental_inline}}</dt>
 <dd>오디오를 출력할 장치의 ID를 지정합니다. {{jsxref("Promise")}} 객체를 반환합니다. 어플리케이션이 특정 장치를 사용할 수 있는 경우에만 동작합니다.</dd>
</dl>

<h2 id="폐기된_메소드">폐기된 메소드</h2>

<p>아래 메소드들은 폐기되었습니다. 브라우저가 지원하더라도 사용하면 안됩니다.</p>

<dl>
 <dt>{{domxref("HTMLMediaElement.mozLoadFrom()")}} {{non-standard_inline}} {{deprecated_inline}}</dt>
 <dd>Mozilla 구현체에서만 동작하는 이 메소드는 다른 미디어 엘리먼트에서 데이터를 로드합니다. <code>load()</code> 메소드와 유사하게 동작하지만 리소스 선택 알고리즘만 다릅니다. 엘리먼트의 소스를 다른 엘리먼트의 <code>currentSrc</code>를 바라보게 합니다. 지정된 엘리먼트의 캐시 및 버퍼에 담긴 데이터에도 모두 접근할 수 있으며 이 말은 즉 다운로드 된 모든 데이터를 공유한다는 의미입니다.</dd>
</dl>

<h2 id="이벤트">이벤트</h2>

<p><em>부모 엘리먼트 {{domxref("HTMLElement")}}에서 상속받은 이벤트와</em> {{domxref('GlobalEventHandlers')}}에 정의된 이벤트를 믹스인합니다. <code><a href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener">addEventListener()</a></code>를 통해 이벤트를 수신하거나 <code>on<em>eventname</em></code> 프로퍼티에 리스터를 할당하여 수신합니다.</p>

<dl>
 <dt>{{domxref("HTMLMediaElement.abort_event", 'abort')}}</dt>
 <dd>에러 외의 원인으로 전체 리소스가 로드 되지 못했을 때 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.canplay_event", 'canplay')}}</dt>
 <dd>User agent가 미디어를 재생 가능한 시점에 발생합니다. 다만 전체 미디어를 재생하기 위해서는 콘텐츠의 버퍼링이 더 필요할 수 있습니다.</dd>
 <dt>{{domxref("HTMLMediaElement.canplaythrough_event", 'canplaythrough')}}</dt>
 <dd>추가 버퍼링 없이 전체 미디어를 재생할 수 있는 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.durationchange_event", 'durationchange')}}</dt>
 <dd>duration 속성이 변경된 시점에 발생합니다..</dd>
 <dt>{{domxref("HTMLMediaElement.emptied_event", 'emptied')}}</dt>
 <dd>미디어가 제거된 시점에 발생합니다. 예를 들어 미디어가 이미 (부분적으로라도) 로드 되었는데. {{domxref("HTMLMediaElement.load()")}} 메소드 호출로 재 로드할 경우 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.ended_event", 'ended')}}</dt>
 <dd>(&lt;audio&gt; or &lt;video&gt;) 미디어가 끝까지 재생 완료 된 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.error_event", 'error')}}</dt>
 <dd>에러가 발생하여 리소스를 로드할 수 없는 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.loadeddata_event", 'loadeddata')}}</dt>
 <dd>미디어의 첫번째 프레임이 로딩 완료된 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.loadedmetadata_event", 'loadedmetadata')}}</dt>
 <dd>메타데이터가 로드 된 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.loadstart_event", 'loadstart')}}</dt>
 <dd>브라우저가 리소스를 로드하기 시작하는 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.pause_event", 'pause')}}</dt>
 <dd>미디어 일시 정지를 요청하고 paused 상태로 진입하는 시점에 발생합니다. 일반적으로 {{domxref("HTMLMediaElement.pause()")}} 메소드가 호출되는 시점입니다.</dd>
 <dt>{{domxref("HTMLMediaElement.play_event", 'play')}}</dt>
 <dd>{{domxref("HTMLMediaElement.play()")}} 메소드 호출이나 <code>autoplay</code> 속성에 의해 <code>paused</code> 프로퍼티가 <code>true</code> 에서 <code>false</code>로 전환되는 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.playing_event", "playing")}}</dt>
 <dd>일시 정지 되거나 버퍼 부족으로 재생 정지 된 이후 재생 가능한 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.progress_event", "progress")}}</dt>
 <dd>브라우저가 리소르를 로딩 중일 때 주기적으로 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.ratechange_event", 'ratechange')}}</dt>
 <dd>재생 속도가 변경될 때 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.seeked_event", 'seeked ')}}</dt>
 <dd>미디어 시킹이 완료되는 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.seeking_event", 'seeking')}}</dt>
 <dd>미디어 시킹이 시작되는 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.stalled_event", 'stalled')}}</dt>
 <dd>User agent가 미디어 데이터를 fetch 하였지만 전송되지 않은 경우 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.suspend_event", 'suspend')}}</dt>
 <dd>미디어 로딩이 중지된 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.timeupdate_event", 'timeupdate')}}</dt>
 <dd>currentTime 속성이 변경되는 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.volumechange_event", 'volumechange')}}</dt>
 <dd>볼륨이 변경되는 시점에 발생합니다.</dd>
 <dt>{{domxref("HTMLMediaElement.waiting_event", 'waiting')}}</dt>
 <dd>일시적인 버퍼 부족으로 재생이 정지된 시점에 발생합니다.</dd>
</dl>

<h2 id="명세">명세</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('Media Capture','#htmlmediaelement-extensions','HTMLMediaElement')}}</td>
   <td>{{Spec2('Media Capture')}}</td>
   <td>sinkId, setSinkId(), captureStream() 추가 됨</td>
  </tr>
  <tr>
   <td>{{SpecName('EME', '#introduction', 'Encrypted Media Extensions')}}</td>
   <td>{{Spec2('EME')}}</td>
   <td>{{domxref("MediaKeys")}}, {{domxref("MediaEncryptedEvent")}}, {{domxref("setMediaKeys")}}, {{domxref("onencrypted")}}, and {{domxref("onwaitingforkey")}} 추가 됨.</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', "the-video-element.html#htmlmediaelement", "HTMLMediaElement")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>{{SpecName('HTML5 W3C')}}와 동일</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', "embedded-content-0.html#htmlmediaelement", "HTMLMediaElement")}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td>최초 정의</td>
  </tr>
 </tbody>
</table>

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



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

<h2 id="같이_보기">같이 보기</h2>

<ul>
 <li>참고 자료
  <ul>
   <li>{{HTMLElement("video")}} and {{HTMLElement("audio")}} HTML elements.</li>
   <li>{{domxref("HTMLVideoElement")}} and {{domxref("HTMLAudioElement")}} interfaces, derived from <code>HTMLMediaElement</code>.</li>
  </ul>
 </li>
 <li>문서
  <ul>
   <li><a class="internal" href="/en-US/docs/Using_HTML5_audio_and_video">Using HTML5 audio and video</a></li>
   <li><a class="internal" href="/en-US/docs/Media_formats_supported_by_the_audio_and_video_elements">Media formats supported by the audio and video elements</a></li>
   <li><a href="/en-US/docs/Web_Audio_API">Web Audio API</a></li>
  </ul>
 </li>
</ul>