AudioContext

AudioContext

정의

• 각각이 AudioNode로 표현이 되는 서로 연결된 오디오 모듈에서 빌드 된 오디오 처리 그래프.
• 하나의 AudioContext 내에 여러 개의 AudioNode가 포함된다.
• 노드 생성, 오디오 처리, 디코딩을 한다.
• 매번 새로운 오디오 콘텍스트를 만드는 것보다 하나를 만들어 재사용하는 것이 더 추천된다.
• 여러 다른 오디오 소스와 파이프라인에 대해 하나의 AudioContext를 쓰는 것도 가능하다.

Methods

AudioContext.close()

• AudioContext를 닫고 사용하는 모든 시스템 오디오 자원을 해제한다.
• close가 되면 새로운 노드를 만들 수는 없지만, audio data를 decode 하는 것과 buffer 생성은 가능하다.
• close를 했다고 모든 AudioContext 생성 객체를 자동으로 해제해주지는 않는다. 하지만 AudioContext의 생성 및 사용을 방해할 수 있는 시스템 오디오 리소스를 강제로 해제하고, 오디오 컨텍스트에서 오디오 시간의 진행을 중단하며 오디오 데이터 처리를 중지한다.
• return된 Promise는 모든 AudioContext 생성 차단 리소스가 해제되면 resolve 된다.
• OfflineAudioContext에서 호출 시, INVALID_STATE_ERR 예외를 발생시킨다.
• return
  • promise resolves with void

AudioContext.resume()

• 이전에 일시 중지 / 일시 중지 된 오디오 컨텍스트에서 시간의 진행을 다시 시작한다.
• OfflineAudioContext에서 불릴 시 INVALID_STATE_ERR를 야기한다.
• return
  • promise. 이미 close가 되어있었다면 거부된다.

susresBtn.onclick = function() {
  if(audioCtx.state === 'running') {
    audioCtx.suspend().then(function() {
      susresBtn.textContent = 'Resume context';
    });
  } else if(audioCtx.state === 'suspended') {
    audioCtx.resume().then(function() {
      susresBtn.textContent = 'Suspend context';
    });  
  }
}

AudioContext.suspend()

• 오디오 컨텍스트에서 시간의 진행을 일시 중단하여 오디오 하드웨어 액세스를 일시적으로 중지하고 프로세스에서 CPU / 배터리 사용량을 줄인다.
• OfflineAudioContext에서 불릴 시 INVALID_STATE_ERR를 야기한다.
• return
  • promise. 이미 close가 되어있었다면 거부된다.

AudioContext.decodeAudioData()

• 메소드는 ArrayBuffer를 받아서 AudioBuffer로 변환하는 메소드이다.

• FileReader.readAsArrayBuffer() 메소드가 반환하는 ArrayBuffer는 한번에 모든 바이너리 데이터를 불러오는 것이 아니라 청크 단위로 불러오기 때문에 decodeAudioData도 변환을 동기적으로 해주지는 않는다. 그래서 이 메소드를 사용할 때는 콜백함수를 사용하거나 Promise를 사용해야 한다.

• AudioBuffer

  AudioBuffer {
    length: 12225071,
    duration: 277.2124943310658,
    sampleRate: 44100,
    numberOfChannels: 2
  }
  

  • sampleRate: 당연히 샘플 레이트를 의미하고 이 곡의 샘플 레이트는 44,100hz이다.
  • numberOfChannels: 이 오디오가 몇개의 채널을 가지고 있는지를 나타내는데 이 파일은 두 개의 채널이 있는 스테레오 채널 오디오 파일이다.
  • length: 피크(Peak)들의 개수를 의미한다. 피크는 컴퓨터가 샘플링을 진행할 때 전압을 측정한 값을 의미한다.
    • duration * sampleRate의 값과 같다
  • duration: 이 오디오 파일의 재생 길이를 초단위로 표시해준다. 그대 돌아오면은 약 277초동안 재생되나보다.

BaseAudioContext

• AudioContext의 부모 인터페이스

Properties

BaseAudioContext.currentTime

• 오디오 재생 예약, 타임라인 시각화 등에 사용할 수 있는 지속적으로 증가하는 하드웨어 타임 스탬프(초)를 나타내는 double를 반환한다. 0에서 시작한다.

var curTime = baseAudioContext.currentTime;

• ready only
• audioContext를 만들었을 때 count 시작된다.
• audioContext.suspend() 시 멈춘다.
• audioContext.resume() 시에 재 실행된다.
• 현재 오디오의 재생 시간 정보를 알려주는 게 아니다.

Methods

BaseAudioContext.createBuffer()

• 비어있는 새 AudioBuffer 개체를 만든다.
• 다음 데이터로 채우고 AudioBufferSourceNode를 통해 재생할 수 있다.

BaseAudioContext.createBufferSource()

• AudioBuffer 개체에 포함 된 오디오 데이터를 재생하고 조작하는 데 사용할 수있는 AudioBufferSourceNode를 만든다.
• AudioBuffer는 AudioContext.createBuffer를 사용하여 생성되거나 오디오 트랙을 성공적으로 디코딩 할 때 AudioContext.decodeAudioData에 의해 반환된다.