HTML DOM Audio 객체

Audio 객체

Audio 객체는 HTML5에서 새로운 객체입니다.

Audio 객체는 HTML <audio> 요소를 나타냅니다.

Audio 객체 접근

getElementById()를 사용하여 <audio> 요소에 접근할 수 있습니다:

var x = document.getElementById("myAudio");

직접 테스트해 보세요

Audio 객체 생성

document.createElement() 메서드를 사용하여 <audio> 요소를 생성할 수 있습니다:

var x = document.createElement("AUDIO");

직접 테스트해 보세요

Audio 객체 속성

속성 설명
audioTracks 사용 가능한 오디오 트랙을 나타내는 AudioTrackList 객체를 반환합니다.
autoplay 오디오가 로드되면 바로 재생되어야 하는지 설정하거나 반환합니다.
buffered 오디오가 버퍼링된 부분을 나타내는 TimeRanges 객체를 반환합니다.
controller 오디오의 현재 미디어 컨트롤러 객체를 반환합니다.
controls 오디오에 컨트롤(재생/일시 중지 등)을 표시해야 하는지 설정하거나 반환합니다.
crossOrigin 오디오의 CORS 설정을 설정하거나 반환합니다.
currentSrc 현재 오디오의 URL을 반환합니다.
currentTime 오디오에서 현재 재생 위치(초로 계산)를 설정하거나 반환합니다.
defaultMuted 오디오의 기본으로 무소리인지 설정하거나 반환합니다.
defaultPlaybackRate 오디오의 기본 재생 속도를 설정하거나 반환합니다.
duration 오디오의 길이(초로 계산)를 반환합니다.
ended 오디오의 재생이 끝났는지 반환합니다.
error 오디오 오류 상태를 나타내는 MediaError 객체를 반환합니다.
loop 오디오가 끝나면 다시 재생되어야 하는지 설정하거나 반환합니다.
mediaGroup 오디오가 속한 미디어 그룹의 이름을 설정하거나 반환합니다.
muted 오디오의 소리를 끄거나 안 끄는지 설정하거나 반환합니다.
networkState 오디오의 현재 네트워크 상태를 반환합니다.
paused 오디오가 일시 중지되었는지 설정하거나 반환합니다.
playbackRate 오디오 재생 속도를 설정하거나 반환합니다.
played 오디오가 재생된 부분을 나타내는 TimeRanges 객체를 반환합니다.
preload 오디오의 preload 속성 값을 설정하거나 반환합니다.
readyState 오디오의 현재 준비 상태를 반환합니다.
seekable 오디오의 검색 가능한 부분을 나타내는 TimeRanges 객체를 반환합니다.
seeking 사용자가 오디오에서 현재 찾고 있는지 여부를 반환합니다.
src 오디오의 src 속성 값을 설정하거나 반환합니다.
textTracks 사용자가 오디오에서 현재 찾고 있는지 여부를 나타내는 TextTrackList 객체를 반환합니다.
volume 오디오의 볼륨을 설정하거나 반환합니다.

Audio 객체 메서드

메서드 설명
addTextTrack() 오디오에 새로운 텍스트 트랙을 추가합니다.
canPlayType() 브라우저가 지정된 오디오 타입을 재생할 수 있는지 확인합니다.
fastSeek() 오디오 플레이어에서 재생 시간을 지정합니다.
getStartDate() 현재 시간선 이동량을 나타내는 새로운 Date 객체를 반환합니다.
load() 오디오 요소를 다시 로드합니다.
play() 오디오 재생을 시작합니다.
pause() 현재 재생을 일시 중지합니다.

표준 속성과 이벤트

Audio 객체가 지원하는 표준속성와이벤트。

관련 페이지

HTML 강의:HTML5 오디오

HTML 참조 설명서:HTML <audio> 태그