diff options
Diffstat (limited to 'files/zh-cn/web/api/convolvernode/index.html')
-rw-r--r-- | files/zh-cn/web/api/convolvernode/index.html | 123 |
1 files changed, 123 insertions, 0 deletions
diff --git a/files/zh-cn/web/api/convolvernode/index.html b/files/zh-cn/web/api/convolvernode/index.html new file mode 100644 index 0000000000..de43ddc6b3 --- /dev/null +++ b/files/zh-cn/web/api/convolvernode/index.html @@ -0,0 +1,123 @@ +--- +title: ConvolverNode +slug: Web/API/ConvolverNode +tags: + - 音效 + - 音频 +translation_of: Web/API/ConvolverNode +--- +<p>{{APIRef("Web Audio API")}}</p> + +<p><code>ConvolverNode</code> 接口是一个对给定 {{domxref("AudioBuffer")}} 上执行线性卷积的 {{domxref("AudioNode")}},一般用来做音频混响效果。每一个 <code>ConvolverNode</code> 都会有一个输入值和输出值。</p> + +<div class="note"> +<p><strong>注意</strong>: 更多线性卷积理论的相关信息,请参阅<a href="https://en.wikipedia.org/wiki/Convolution">Convolution article on Wikipedia</a>.</p> +</div> + +<table class="properties"> + <tbody> + <tr> + <th scope="row">Number of inputs</th> + <td><code>1</code></td> + </tr> + <tr> + <th scope="row">Number of outputs</th> + <td><code>1</code></td> + </tr> + <tr> + <th scope="row">Channel count mode</th> + <td><code>"clamped-max"</code></td> + </tr> + <tr> + <th scope="row">Channel count</th> + <td><code>1</code>, <code>2</code>, or <code>4</code></td> + </tr> + <tr> + <th scope="row">Channel interpretation</th> + <td><code>"speakers"</code></td> + </tr> + </tbody> +</table> + +<h2 id="构造函数">构造函数</h2> + +<dl> + <dt>{{domxref("ConvolverNode.ConvolverNode()", "ConvolverNode()")}}</dt> + <dd>创建一个新的 <span><code>ConvolverNode</code></span> 对象实例。</dd> +</dl> + +<h2 id="属性">属性</h2> + +<p>继承其父级的属性<em>, {{domxref("AudioNode")}}</em>.</p> + +<dl> + <dt>{{domxref("ConvolverNode.buffer")}}</dt> + <dd>一个被 <span><code>ConvolverNode</code></span> 用来产生混响效果的单声道、立体声或四声道的音频缓冲器,包含了(可能是多声道)脉冲反应(IR)。</dd> + <dt>{{domxref("ConvolverNode.normalize")}}</dt> + <dd><span>布尔值,在设置缓冲区属性时,可绝定是否对来自 <code>buffer</code> 的脉冲反应按等功率归一化进行缩放。</span></dd> +</dl> + +<h2 id="方法">方法</h2> + +<p>没有具体的方法,从其父继承方法,<em>{{domxref("AudioNode")}}</em>.</p> + +<h2 id="ConvolverNode_例子">ConvolverNode 例子</h2> + +<p>下面的示例展示了 AudioContext 创建卷积节点的基础用法。</p> + +<div class="note"> +<p><strong>注意</strong>: 你需要找到一个脉冲反应来完成下面的示例。可查看 <a href="https://codepen.io/DonKarlssonSan/pen/doVKRE">此处</a> 的实例.</p> +</div> + +<pre class="brush: js notranslate">let audioCtx = new window.AudioContext(); + +async function createReverb() { + let convolver = audioCtx.createConvolver(); + + // 从文件加载脉冲反应 + let response = await fetch("path/to/impulse-response.wav"); + let arraybuffer = await response.arrayBuffer(); + convolver.buffer = await audioCtx.decodeAudioData(arraybuffer); + + return convolver; +} + +... + +let reverb = await createReverb(); + +// someOtherAudioNode -> reverb -> destination +someOtherAudioNode.connect(reverb); +reverb.connect(audioCtx.destination); +</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">规范</th> + <th scope="col">状态</th> + <th scope="col">注释</th> + </tr> + <tr> + <td>{{SpecName('Web Audio API', '#ConvolverNode', 'ConvolverNode')}}</td> + <td>{{Spec2('Web Audio API')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<div> + + +<p>{{Compat("api.ConvolverNode")}}</p> +</div> + +<h2 id="相关链接">相关链接</h2> + +<ul> + <li><a href="/en-US/docs/Web_Audio_API/Using_Web_Audio_API">Using the Web Audio API</a></li> +</ul> |