AudioParamDescriptor

Từ điển AudioParamDescriptor của Web Audio API chỉ định các thuộc tính cho các đối tượng AudioParam.

Nó được dùng để tạo các AudioParam tùy chỉnh trên một AudioWorkletNode. Nếu AudioWorkletProcessor nền tảng có một getter tĩnh parameterDescriptors, thì mảng đối tượng được trả về dựa trên từ điển này sẽ được hàm dựng AudioWorkletNode sử dụng nội bộ để điền thuộc tính parameters của nó cho phù hợp.

Instance properties

name

Chuỗi biểu diễn tên của AudioParam. AudioParam sẽ khả dụng dưới tên này trong thuộc tính parameters của node, và dưới tên này, phương thức AudioWorkletProcessor.process sẽ nhận các giá trị đã được tính toán của AudioParam này.

automationRate Optional

Chuỗi "a-rate" hoặc "k-rate", biểu diễn tốc độ tự động hóa của AudioParam này. Mặc định là "a-rate".

minValue Optional

Một float biểu diễn giá trị nhỏ nhất của AudioParam. Mặc định là -3.4028235e38.

maxValue Optional

Một float biểu diễn giá trị lớn nhất của AudioParam. Mặc định là 3.4028235e38.

defaultValue Optional

Một float biểu diễn giá trị khởi tạo của AudioParam. Mặc định là 0.

Examples

Đoạn mã dưới đây cho thấy một descriptor kiểu này được trả về bởi phương thức tĩnh parameterDescriptors được định nghĩa trong một AudioWorkletProcessor tùy chỉnh (đây là một phần của ví dụ đầy đủ hơn trong AudioWorkletNode.parameters).

js
// white-noise-processor.js
class WhiteNoiseProcessor extends AudioWorkletProcessor {
  static get parameterDescriptors() {
    return [
      {
        name: "customGain",
        defaultValue: 1,
        minValue: 0,
        maxValue: 1,
        automationRate: "a-rate",
      },
    ];
  }

  // …
}

Specifications

Specification
Web Audio API
# AudioParamDescriptor

See also