抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
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 使用。
​