抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
AudioBuffer 接口表示存在内存里的一段短小的音频资源,利用AudioContext.decodeAudioData
方法从一个音频文件构建,或者利用 AudioContext.createBuffer
从原始数据构建。把音频放入 AudioBuffer 后,可以传入到一个 AudioBufferSourceNode 进行播放。

属性

属性名
类型
读写特性
默认值
说明
最低支持版本
numberOfChannels
number
只读
2048
返回存储在缓存区的 PCM 数据的通道数
1.34.0
length
number
只读
-30
返回存储在缓存区的 PCM 数据的采样帧率
1.34.0
duration
number
只读
-100
返回存储在缓存区的 PCM 数据的时长(单位为秒)
1.34.0
sampleRate
number
只读
fftSize/2
存储在缓存区的 PCM 数据的采样率,单位为 sample/s
1.34.0
buffer
ArrayBuffer
只读
​
AudioBuffer 所对应的缓存区(buffer)
1.34.0

方法

getChannelData(number channel)

返回一个 Float32Array,包含了带有频道的 PCM 数据,由频道参数定义(0 代表第一个频道)。

语法

AudioBuffer.getChannelData(channel)

参数说明

属性名称
数据类型
必填
描述
channel
number
是
要获取数据的频道号

返回值

一个 Float32Array

AudioBuffer.copyFromChannel(Float32Array destination, number channelNumber, number startInChannel)

​
基础库 3.72.0 开始支持。从指定声道复制 PCM 采样数据到 destination。
​
参数
类型
必填
默认值
说明
destination
Float32Array
是
—
接收复制数据的数组
channelNumber
number
是
—
源声道索引,从 0 开始
startInChannel
number
否
0
源声道中的起始采样帧偏移
​
返回值:无。
​

AudioBuffer.copyToChannel(Float32Array source, number channelNumber, number startInChannel)

​
基础库 3.72.0 开始支持。将 source 中的 PCM 采样数据复制到指定声道。
​
参数
类型
必填
默认值
说明
source
Float32Array
是
—
待写入的采样数据
channelNumber
number
是
—
目标声道索引,从 0 开始
startInChannel
number
否
0
目标声道中的起始采样帧偏移
​
返回值:无。偏移单位为采样帧,不是秒或字节。

代码示例

​