1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
---
title: AudioWorkletNode
slug: Web/API/AudioWorkletNode
translation_of: Web/API/AudioWorkletNode
---
<p>{{APIRef("Web Audio API")}} {{SeeCompatTable}}</p>
<div class="blockIndicator secureContexts">虽然这个接口可以在 <a href="/en-US/docs/Web/Security/Secure_Contexts">secure contexts</a> 之外调用, 但是 {{domxref("BaseAudioContext.audioWorklet")}} 属性不行, 从而 {{domxref("AudioWorkletProcessor")}}s 不能在外部定义.</div>
<p><a href="/en-US/docs/Web/API/Web_Audio_API">Web Audio API</a> 中的 <strong><code>AudioWorkletNode</code></strong> 接口代表了用户定义的{{domxref("AudioNode")}}的基类, 该基类可以与其他节点一起连接到音频路由图. 其具有关联的{{domxref("AudioWorkletProcessor")}}, 它在 Web Audio 执行实际的音频处理.</p>
<h2 id="构造函数">构造函数</h2>
<dl>
<dt>{{domxref("AudioWorkletNode.AudioWorkletNode", "AudioWorkletNode()")}}</dt>
<dd>为 <code>AudioWorkletNode</code> 创建一个新的实例对象.</dd>
</dl>
<h2 id="属性">属性</h2>
<p><em>也继承父类的属性, {{domxref("AudioNode")}}</em>.</p>
<dl>
<dt>{{domxref("AudioWorkletNode.port")}} {{readonlyinline}}</dt>
<dd>返回一个 {{domxref("MessagePort")}} 用于节点与其关联的 {{domxref("AudioWorkletProcessor")}} 间的双向通讯. 另一端在处理器属性{{domxref("AudioWorkletProcessor.port", "port")}} 下可用.</dd>
<dt>{{domxref("AudioWorkletNode.parameters")}} {{readonlyinline}}</dt>
<dd>返回一个 {{domxref("AudioParamMap")}} — {{domxref("AudioParam")}} 对象的集合. 它们在创建 <code>AudioWorkletProcessor</code>的过程中被实例化. 如果 <code>AudioWorkletProcessor</code> 有一个静态的 {{domxref("AudioWorkletProcessor.parameterDescriptors", "parameterDescriptors")}} getter, 从其返回的 {{domxref("AudioParamDescriptor")}} 数组用于在 <code>AudioWorkletNode</code> 创建 <code>AudioParam</code> 对象. 通过这种机制，使得 <code>AudioParam</code> 对象可以从 <code>AudioWorkletNode</code> 中访问. 你可以在与其关联的 <code>AudioWorkletProcessor</code> 中使用它的值.</dd>
</dl>
<h3 id="Event_handlers">Event handlers</h3>
<dl>
<dt>{{domxref("AudioWorkletNode.onprocessorerror")}}</dt>
<dd>在关联的 {{domxref("AudioWorkletProcessor")}} 对象发生异常时触发. 一旦触发，处理器及其节点将在其整个生命周期内处于输出静默状态.</dd>
</dl>
<h2 id="方法">方法</h2>
<p><em>同样继承了其父类的方法, </em><em>{{domxref("AudioNode")}}</em>.</p>
<p><em>AudioWorkletNode 接口未定义其自己的任何方法.</em></p>
<h2 id="示例">示例</h2>
<p>在本示例中我们创建了 <code>AudioWorkletNode</code> 对象, 它会输出白噪声.</p>
<p>首先, 我们需要定义一个自定义的 {{domxref("AudioWorkletProcessor")}}, 它将输出白噪声并进行注册. 注意, 这需要在一个单独的文件中完成.</p>
<pre class="brush: js">// white-noise-processor.js
class WhiteNoiseProcessor 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('white-noise-processor', WhiteNoiseProcessor)
</pre>
<p>接下来, 在脚本主文件中一个 <code>AudioWorkletNode</code> 实例, 并传递处理器的名称, 然后将该实例连接到一个audio graph.</p>
<pre class="brush: js">const audioContext = new AudioContext()
await audioContext.audioWorklet.addModule('white-noise-processor.js')
const whiteNoiseNode = new AudioWorkletNode(audioContext, 'white-noise-processor')
whiteNoiseNode.connect(audioContext.destination)
</pre>
<h2 id="规范">规范</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Specification</th>
<th scope="col">Status</th>
<th scope="col">Comment</th>
</tr>
<tr>
<td>{{SpecName('Web Audio API', '#audioworkletnode', 'AudioWorkletNode')}}</td>
<td>{{Spec2('Web Audio API')}}</td>
<td></td>
</tr>
</tbody>
</table>
<h2 id="浏览器兼容性">浏览器兼容性</h2>
<div>
<p>{{Compat("api.AudioWorkletNode")}}</p>
</div>
<h2 id="See_also">See also</h2>
<ul>
<li><a href="/en-US/docs/Web/API/Web_Audio_API">Web Audio API</a></li>
<li><a href="/en-US/docs/Web/API/Web_Audio_API/Using_Web_Audio_API">Using the Web Audio API</a></li>
</ul>
|
