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

js
new ConvolverNode(context, options)

Tham số

context

Một tham chiếu tới AudioContext.

options Optional

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à ConvolverNode dù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ủa channelCountMode.

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". (Xem AudioNode.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ệ

NotSupportedError DOMException

Đượ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ới AudioContext liên kết.

Thông số kỹ thuật

Thông số kỹ thuật
Web Audio API
# dom-convolvernode-convolvernode

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