AudioWorkletProcessor.process

在此页

句法
范例
规范
浏览器兼容性
另请参阅
相关话题

process() 方法对于 AudioWorkletProcessor -derived class implements the audio processing algorithm for the audio processor worklet. Although the method is not a part of the AudioWorkletProcessor interface, any implementation of AudioWorkletProcessor must provide a process() 方法。

The method is called synchronously from the audio rendering thread, once for each block of audio (also known as a rendering quantum) being directed through the processor's corresponding AudioWorkletNode . In other words, every time a new block of audio is ready for your processor to manipulate, your process() function is invoked to do so.

重要： Currently, audio data blocks are always 128 frames long—that is, they contain 128 32-bit floating-point samples for each of the inputs' channels. However, plans are already in place to revise the specification to allow the size of the audio blocks to be changed depending on circumstances (for example, if the audio hardware or CPU utilization is more efficient with larger block sizes). Therefore, you must always check the size of the sample array rather than assuming a particular size.

This size may even be allowed to change over time, so you mustn't look at just the first block and assume the sample buffers will always be the same size.

句法

var isActivelyProcessing = audioWorkletProcessor.process(inputs, outputs, parameters);

参数

inputs
outputs: An array of outputs that is similar to the inputs parameter in structure. It is intended to be filled during the execution of the process() method. Each of the output channels is filled with zeros by default — the processor will output silence unless the output arrays are modified.
参数

返回值

A Boolean value indicating whether or not to force the AudioWorkletNode to remain active even if the user agent's internal logic would otherwise decide that it's safe to shut down the node.

The returned value lets your processor have influence over the lifetime policy of the AudioWorkletProcessor and the node that owns it. If the combination of the return value and the state of the node causes the browser to decide to stop the node, process() will not be called again.

Returning true forces the Web Audio API to keep the node alive, while returning false allows the browser to terminate the node if it is neither generating new audio data nor receiving data through its inputs that it is processing.

The 3 most common types of audio node are:

A source of output. An AudioWorkletProcessor implementing such a node should return true 从 process method as long as it produces an output. The method should return false as soon as it's known that it will no longer produce an output. For example, take the AudioBufferSourceNode — the processor behind such a node should return true 从 process method while the buffer is playing, and start returning false when the buffer playing has ended (there's no way to call play on the same AudioBufferSourceNode again).
A node that transforms its input. A processor implementing such a node should return false 从 process method to allow the presence of active input nodes and references to the node to determine whether it can be garbage-collected. An example of a node with this behaviour is the GainNode . As soon as there are no inputs connected and references retained, gain can no longer be applied to anything, so it can be safely garbage-collected.
A node that transforms its input, but has a so-called tail-time — this means that it will produce an output for some time even after its inputs are disconnected or are inactive (producing zero-channels). A processor implementing such a node should return true 从 process method for the period of the tail-time , beginning as soon as inputs are found that contain zero-channels. An example of such a node is the DelayNode — it has a tail-time equal to its delayTime 特性。

注意 : An absence of the return statement means that the method returns undefined , and as this is a falsy value, it is like returning false . Omitting an explicit return statement may cause hard-to-detect problems for your nodes.

异常

As the process() method is implemented by the user, it can throw anything. If an uncaught error is thrown, the node will emit an onprocessorerror event and will output silence for the rest of its lifetime.

范例

In this example we create an AudioWorkletProcessor that outputs white noise to its first output. The gain can be controlled by the customGain 参数。

class WhiteNoiseProcessor extends AudioWorkletProcessor {
  process (inputs, outputs, parameters) {
    // take the first output
    const output = outputs[0]
    // fill each channel with random values multiplied by gain
    output.forEach(channel => {
      for (let i = 0; i < channel.length; i++) {
        // generate random value for each sample
        // Math.random range is [0; 1); we need [-1; 1]
        // this won't include exact 1 but is fine for now for simplicity
        channel[i] = (Math.random() * 2 - 1) *
          // the array can contain 1 or 128 values
          // depending on if the automation is present
          // and if the automation rate is k-rate or a-rate
          (parameters['customGain'].length > 1
            ? parameters['customGain'][i]
            : parameters['customGain'][0])
      }
    })
    // as this is a source node which generates its own output,
    // we return true so it won't accidentally get garbage-collected
    // if we don't have any references to it in the main thread
    return true
  }
  // define the customGain parameter used in process method
  static get parameterDescriptors () {
    return [{
      name: 'customGain',
      defaultValue: 1,
      minValue: 0,
      maxValue: 1,
      automationRate: 'a-rate'
    }]
  }
}

规范

规范	状态	注释
Web 音频 API The definition of 'process()' in that specification.	工作草案

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

No compatibility data found. Please contribute data for "api.AudioWorkletProcessor.process" (depth: 1) to the MDN 兼容性数据存储库 .

另请参阅

使用 Web 音频 API

元数据

最后修改： May 1, 2020

Web 音频 API
AudioWorkletProcessor
构造函数
1. AudioWorkletProcessor()
特性
1. parameterDescriptors (static getter)
2. port
方法
1. process
Related pages for Web Audio API

在此页

句法

参数

返回值

异常

范例

规范

浏览器兼容性

另请参阅

相关话题