AudioWorkletNode

Hàm tạo

AudioWorkletNode()

Tạo một thể hiện mới của đối tượng AudioWorkletNode.

Thuộc tính thể hiện

Cũng kế thừa các thuộc tính từ giao diện cha của nó, AudioNode.

AudioWorkletNode.port Read only

Trả về một MessagePort dùng cho giao tiếp hai chiều giữa nút và AudioWorkletProcessor liên kết của nó. Đầu còn lại có sẵn qua thuộc tính port của processor.

AudioWorkletNode.parameters Read only

Trả về một AudioParamMap — một tập hợp các đối tượng AudioParam. Chúng được khởi tạo trong quá trình tạo AudioWorkletProcessor cơ sở. Nếu AudioWorkletProcessor có getter tĩnh parameterDescriptors, mảng AudioParamDescriptor trả về từ getter đó sẽ được dùng để tạo các đối tượng AudioParam trên AudioWorkletNode. Cơ chế này cho phép bạn đưa các đối tượng AudioParam tùy chỉnh của riêng mình ra để truy cập từ AudioWorkletNode. Sau đó, bạn có thể dùng các giá trị của chúng trong AudioWorkletProcessor liên kết.

Sự kiện

processorerror

Kích hoạt khi có lỗi được ném ra trong AudioWorkletProcessor liên kết. Sau khi sự kiện này xảy ra, processor và do đó cả nút sẽ xuất ra sự im lặng trong suốt vòng đời của nó.

Phương thức thể hiện

Cũng kế thừa các phương thức từ giao diện cha của nó, AudioNode.

Giao diện AudioWorkletNode không tự định nghĩa phương thức nào.

Ví dụ

Trong ví dụ này, chúng ta tạo một AudioWorkletNode tùy chỉnh tạo ra nhiễu ngẫu nhiên.

Trước tiên, chúng ta cần định nghĩa một AudioWorkletProcessor tùy chỉnh có nhiệm vụ xuất ra nhiễu ngẫu nhiên và đăng ký nó. Lưu ý rằng việc này nên được thực hiện trong một tệp riêng.

// random-noise-processor.js
class RandomNoiseProcessor extends AudioWorkletProcessor {
  process(inputs, outputs, parameters) {
    const output = outputs[0];
    output.forEach((channel) => {
      for (let i = 0; i < channel.length; i++) {
        channel[i] = Math.random() * 2 - 1;
      }
    });
    return true;
  }
}

registerProcessor("random-noise-processor", RandomNoiseProcessor);

Tiếp theo, trong tệp kịch bản chính, chúng ta sẽ tải processor, tạo một thể hiện AudioWorkletNode bằng cách truyền vào tên của processor, rồi kết nối nút này vào một đồ thị âm thanh.

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

Thông số kỹ thuật

Khả năng tương thích với trình duyệt

Xem thêm

• Web Audio API
• Sử dụng Web Audio API
• Sử dụng AudioWorklet