blob: 2f18da209730b3317c5ce7bdb7d9ae7569bd5611 (
plain)
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
|
---
title: GainNode
slug: Web/API/GainNode
tags:
- GainNode
- HTML5 音频
- Web Audio API
- de-zippering
translation_of: Web/API/GainNode
---
<p>{{ APIRef("Web Audio API") }}</p>
<div>
<p><strong><code>GainNode</code></strong><strong> </strong>接口表示音量的变化。它是一个{{domxref("AudioNode")}}音频处理模块，在输出前使用给定<em>增益</em>应用到输入。一个 <code>GainNode</code><strong> </strong>总是只有一个输入和一个输出，两者拥有同样数量的声道。</p>
<p>增益是一个无单位的值，会对所有输入声道的音频进行相应的增加。如果进行了修改，则会立即应用新增益，从而在结果音频中产生奇怪的“咔嗒”声。<font><font>为了防止这种情况发生，请不要直接更改值，而应在</font></font>{{domxref("AudioParam")}}接口<font><font>上使用指数插值方法</font><font>。</font></font></p>
</div>
<p><img alt="The GainNode is increasing the gain of the output." src="https://mdn.mozillademos.org/files/5085/WebAudioGainNode.png" style="height: 116px; width: 774px;"></p>
<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>"max"</code></td>
</tr>
<tr>
<th scope="row">Channel count</th>
<td><code>2</code> (not used in the default count mode)</td>
</tr>
<tr>
<th scope="row">Channel interpretation</th>
<td><code>"speakers"</code></td>
</tr>
</tbody>
</table>
<h2 id="构造函数">构造函数</h2>
<dl>
<dt>{{domxref("GainNode.GainNode", "GainNode()")}}</dt>
<dd><font><font>创建</font></font><code>GainNode</code><font><font>对象</font><font>的新实例</font><font>。</font><font>不应手动创建增益节点；而应该</font><font>使用</font></font>{{domxref("AudioContext.createGain()")}}方法。</dd>
</dl>
<h2 id="属性">属性</h2>
<p><em><font><font>从其父类继承属性</font></font>{{domxref("AudioNode")}}。</em></p>
<dl>
<dt>{{domxref("GainNode.gain")}} {{readonlyinline}}</dt>
</dl>
<p><font><font>是一个</font></font><font><font><a href="https://developer.mozilla.org/zh-CN/docs/Web/API/AudioParam#a-rate">a-rate</a></font></font>{{domxref("AudioParam")}}表示应用的增益量。<font><font>必须设置</font></font>{{domxref("AudioParam.value")}}或者使用<code>AudioParam</code>的方法<font><font>改变增益效果。</font></font></p>
<h2 id="方法">方法</h2>
<p><em>无指定方法；所有方法继承自父类{{domxref("AudioNode")}}</em>.</p>
<h2 id="示例">示例</h2>
<p>{{page("/zh-CN/docs/Web/API/AudioContext.createGain","Example")}}</p>
<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', '#the-gainnode-interface', 'GainNode')}}</td>
<td>{{Spec2('Web Audio API')}}</td>
<td></td>
</tr>
</tbody>
</table>
<h2 id="浏览器兼容">浏览器兼容</h2>
<p>{{Compat("api.GainNode")}}</p>
<h2 id="参见">参见</h2>
<ul>
<li><a href="/zh-CN/docs/Web_Audio_API/Using_Web_Audio_API">使用Web音频API</a></li>
</ul>
|
