AudioContext

AudioContext 인터페이스는 AudioNode에 의해 각각 표현되는, 함께 연결된 오디오 모듈로부터 만들어진 오디오 프로세싱 그래프를 표현합니다. 오디오 컨텍스트는 이것이 포함하는 노드의 생성과 오디오 프로세싱 혹은 디코딩의 실행 둘 다를 제어합니다. 여러분은 다른 무언가를 하기 전에 AudioContext를 생성할 필요가 있습니다. 왜냐하면 모든 것은 컨텍스트 내에서 발생하기 때문입니다. 매번 새로운 컨텍스트를 초기화하는 대신 하나의 AudioContext를 생성하고 재사용하는 것이 추천되며, 몇 개의 다른 오디오 소스에 대해 하나의 AudioContext를 사용하고 동시에 연결하는 것은 문제없습니다.

EventTarget BaseAudioContext AudioContext

생성자

AudioContext() (en-US)

새로운 AudioContext 객체를 생성하고 반환합니다.

속성

또한 부모 인터페이스인 BaseAudioContext로부터 속성을 상속받습니다.

AudioContext.baseLatency (en-US) 읽기 전용 Experimental

AudioDestinationNode에서 오디오 서브시스템으로 오디오를 전달하는 AudioContext에 의해 초래된 프로세싱 레이턴시의 초를 반환합니다.

AudioContext.outputLatency (en-US) 읽기 전용 Experimental

현재 오디오 컨텍스트의 출력 레이턴시의 평가치를 반환합니다.

메서드

또한 부모 인터페이스인 BaseAudioContext로부터 메서드를 상속받습니다.

AudioContext.close() (en-US)

오디오 컨텍스트가 사용하는 모든 시스템 오디오 자원을 해제하며, 오디오 컨텍스트를 닫습니다.

AudioContext.createMediaElementSource() (en-US)

HTMLMediaElement와 연관된 MediaElementAudioSourceNode (en-US)를 생성합니다. 이것은 <video> 혹은 <audio> (en-US) 요소로부터 오디오를 재생하거나 조작하기 위해 사용될 수 있습니다.

AudioContext.createMediaStreamSource() (en-US)

로컬 컴퓨터 마이크나 다른 소스로부터 올 지도 모르는 오디오 스트림을 나타내는 MediaStream (en-US)과 연관된 MediaStreamAudioSourceNode (en-US)를 생성합니다.

AudioContext.createMediaStreamDestination() (en-US)

로컬 파일에 저장되거나 다른 컴퓨터로 전송될지도 모르는 오디오 스트림을 나타내는 MediaStream (en-US)과 연관된 MediaStreamAudioDestinationNode (en-US)를 생성합니다.

AudioContext.createMediaStreamTrackSource() (en-US)

미디어 스트림 트랙을 나타내는 MediaStream (en-US)과 연관된 MediaStreamTrackAudioSourceNode (en-US)를 생성합니다.

AudioContext.getOutputTimestamp() (en-US)

현재 오디오 컨텍스트에 관련된 두 개의 오디오 타임스탬프 값을 포함하는 새로운 AudioTimestamp 객체를 반환합니다.

AudioContext.resume() (en-US)

이전에 연기되거나/정지된 오디오 컨텍스트의 시간 진행을 다시 시작합니다.

AudioContext.suspend() (en-US)

일시적으로 오디오 하드웨어 접근을 멈추고 프로세스에서의 CPU/배터리 사용을 줄이며, 오디오 컨텍스트에서의 시간 진행을 연기합니다.

예제

기본적인 오디오 컨텍스트 선언:

js
var audioCtx = new AudioContext();

크로스 브라우저를 위한 다른 형태:

js
var AudioContext = window.AudioContext || window.webkitAudioContext;
var audioCtx = new AudioContext();

var oscillatorNode = audioCtx.createOscillator();
var gainNode = audioCtx.createGain();
var finish = audioCtx.destination;
// etc.

명세

Specification
Web Audio API
# AudioContext

브라우저 호환성

BCD tables only load in the browser

같이 보기