AudioNode
收藏我的收藏
AudioNode 是一个处理音频的通用模块, 比如一个音频源(如 MediaElementAudioSourceNode), 一个音频地址或者一个中间处理模块 (如 均衡器 EqualizerNode), 或一个音量控制器如 GainNode。多个 AudioNode 可以以模块化的方式动态连接在一起。
属性
属性名 | 类型 | 读写特性 | 默认值 | 说明 | 最低支持版本 |
context | AudioContext | 只读 | | 所属的 AudioContext | 1.34.0 |
channelCount | number | 只读 | 2 | 表示该输出必须包含的通道数,不支持自定义设置 | 1.34.0 |
channelCountMode | string | 只读 | | 表示当前节点的通道模式,不支持设置 | 1.34.0 |
isSampleSource | boolean | 读写 | false | 是否为采样节点,参考 AudioContext.createMediaStreamSource | 1.34.0 |
方法
AudioNode.connect(AudioNode destination, number outputIndex, number inputIndex)
将此节点的一个输出连接到另一个节点的一个输入,返回目标节点。
语法
AudioNode.connect(destination, outputIndex, inputIndex)
参数说明
属性名称 | 数据类型 | 描述 |
destination | AudioNode | 要连接的目标节点 |
outputIndex | number | 可选,默认 0。当前节点的输出端口索引,从 0 开始。 |
inputIndex | number | 可选,默认 0。目标节点的输入端口索引,从 0 开始。 |
返回值
AudioNode
AudioNode.disconnect()
将这个节点从另一个节点断开连接。
语法
AudioNode.disconnect()
参数说明
无
返回值
AudioNode
代码示例
const audioCtx = tt.getAudioContext(); const oscillator = audioCtx.createOscillator(); const gainNode = audioCtx.createGain(); oscillator.connect(gainNode); gainNode.connect(audioCtx.destination);
声道连接示例
const ctx = tt.getAudioContext(); const splitter = ctx.createChannelSplitter(2); const merger = ctx.createChannelMerger(2); // 将拆分后的左、右声道交换后合并。 splitter.connect(merger, 0, 1); splitter.connect(merger, 1, 0); merger.connect(ctx.destination);
Bug & Tip
outputIndex、inputIndex 自基础库 3.72.0 起支持,表示节点输入/输出端口的索引。声道拆分和合并请配合 ChannelSplitterNode、ChannelMergerNode 使用。
