ConvolverNode: hàm tạo ConvolverNode()
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.
Hàm tạo ConvolverNode() của Web Audio API tạo một thực thể đối tượng ConvolverNode mới.
Cú pháp
new ConvolverNode(context, options)
Tham số
context-
Một tham chiếu tới
AudioContext. optionsOptional-
Các tùy chọn như sau:
buffer-
Một
AudioBufferđơn âm, stereo hoặc 4 kênh chứa đáp ứng xung (có thể là đa kênh) màConvolverNodedùng để tạo hiệu ứng reverb. disableNormalization-
Một giá trị boolean điều khiển việc đáp ứng xung từ bộ đệm có được scale bằng phép chuẩn hóa equal-power hay không. Mặc định là
false. channelCount-
Biểu diễn một số nguyên dùng để xác định có bao nhiêu kênh được dùng khi up-mixing và down-mixing các kết nối tới bất kỳ đầu vào nào của nút. (Xem
AudioNode.channelCountđể biết thêm thông tin.) Cách dùng và định nghĩa chính xác của nó phụ thuộc vào giá trị củachannelCountMode. channelCountMode-
Biểu diễn một giá trị liệt kê mô tả cách các kênh phải được khớp giữa đầu vào và đầu ra của nút. (Xem
AudioNode.channelCountModeđể biết thêm thông tin, bao gồm các giá trị mặc định.) channelInterpretation-
Biểu diễn một giá trị liệt kê mô tả ý nghĩa của các kênh. Cách diễn giải này sẽ xác định cách việc up-mixing và down-mixing âm thanh diễn ra. Các giá trị có thể là
"speakers"hoặc"discrete". (XemAudioNode.channelCountModeđể biết thêm thông tin, bao gồm các giá trị mặc định.)
Giá trị trả về
Một thực thể đối tượng ConvolverNode mới.
Ngoại lệ
NotSupportedErrorDOMException-
Được ném ra nếu
AudioBufferđược tham chiếu không có đúng số lượng kênh, hoặc có tốc độ lấy mẫu khác vớiAudioContextliên kết.
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Web Audio API> # dom-convolvernode-convolvernode> |