AudioBuffer
收藏我的收藏
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 | 目标声道中的起始采样帧偏移 |
返回值:无。偏移单位为采样帧,不是秒或字节。
代码示例
