AudioWorkletGlobalScope.registerProcessor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

AudioWorkletGlobalScope 인터페이스의 registerProcessor 메서드는 명시된 name 아래에서 AudioWorkletProcessor 인터페이스로부터 파생된 클래스 생성자를 등록합니다.

구문

js
AudioWorkletGlobalScope.registerProcessor(name, processorCtor);

매개변수

name

프로세서가 등록될 이름을 나타내는 문자열.

processorCtor

AudioWorkletProcessor로부터 파생된 클래스의 생성자.

참고: 프로세서가 한 번 등록되고 나면 AudioWorkletGlobalScope에서 키-값 쌍 { name: constructor } 가 내부적으로 저장됩니다. name 은 등록된 프로세서를 기반으로 한 AudioWorkletNode를 생성할 때 참조됩니다. 주어진 이름의 새로운 프로세서는 내부적으로 생성되고 새로운 노드와 연관됩니다.

반환 값

undefined

예외

NotSupportedError DOMException

다음의 조건 아래서 발생됩니다:

  • name 이 빈 문자열입니다.
  • 주어진 name 아래의 생성자가 이미 등록되었습니다. 같은 이름을 두 번 등록하는 것은 허용되지 않습니다.
TypeError DOMException

다음의 조건 아래서 발생됩니다:

예제

이 예제에서 우리는 아무 소리도 출력하지 않는 사용자 정의 AudioWorkletNode 를 생성할 것입니다.

우선, 우리는 사용자 정의 AudioWorkletProcessor를 정의하고 등록할 필요가 있습니다. 이 작업은 별도의 파일에서 이루어져야 함에 주의하세요.

js
// test-processor.js
class TestProcessor extends AudioWorkletProcessor {
  process(inputs, outputs, parameters) {
    return true;
  }
}

registerProcessor("test-processor", TestProcessor);

다음으로, 메인 스크립트 파일에서 우리는 프로세서를 로드하고, AudioWorkletNode 에 우리가 registerProcessor 를 호출할 때 사용했던 프로세서 이름을 전달하며 AudioWorkletNode 의 인스턴스를 생성하고, 이것을 오디오 그래프에 연결할 것입니다.

js
const audioContext = new AudioContext();
await audioContext.audioWorklet.addModule("test-processor.js");
const node = new AudioWorkletNode(audioContext, "test-processor");
node.connect(audioContext.destination);

명세서

Specification
Web Audio API
# dom-audioworkletglobalscope-registerprocessor

브라우저 호환성

BCD tables only load in the browser

같이 보기