克鲁克

使用 Web Audio API 合并、连接、播放、导出和下载音频文件的简单方法。

无依赖关系
gzip 压缩后的小 2kB
用打字稿写成

查看在线演示

安装

yarn add crunker

npm install crunker

例子

 let crunker = new Crunker ( ) ;

crunker
  . fetchAudio ( '/song.mp3' , '/another-song.mp3' )
  . then ( ( buffers ) => {
    // => [AudioBuffer, AudioBuffer]
    return crunker . mergeAudio ( buffers ) ;
  } )
  . then ( ( merged ) => {
    // => AudioBuffer
    return crunker . export ( merged , 'audio/mp3' ) ;
  } )
  . then ( ( output ) => {
    // => {blob, element, url}
    crunker . download ( output . blob ) ;
    document . body . append ( output . element ) ;
    console . log ( output . url ) ;
  } )
  . catch ( ( error ) => {
    // => Error Message
  } ) ;

crunker . notSupported ( ( ) => {
  // Handle no browser support
} ) ;

精简示例

 let crunker = new Crunker ( ) ;

crunker
  . fetchAudio ( '/voice.mp3' , '/background.mp3' )
  . then ( ( buffers ) => crunker . mergeAudio ( buffers ) )
  . then ( ( merged ) => crunker . export ( merged , 'audio/mp3' ) )
  . then ( ( output ) => crunker . download ( output . blob ) )
  . catch ( ( error ) => {
    throw new Error ( error ) ;
  } ) ;

输入文件示例

;">

 let crunker = new Crunker ( ) ;

const onFileInputChange = async ( target ) => {
  const buffers = await crunker . fetchAudio ( ... target . files , '/voice.mp3' , '/background.mp3' ) ;
} ;

< input onChange = { onFileInputChange ( this ) } type = "file" accept = "audio/*" / > ;

其他例子

节拍生成器机器

方法的图形表示

合并

康卡特

方法

有关更详细的 API 文档，请查看 Typescript 类型。

新克鲁克()

创建 Crunker 的新实例。您可以选择提供带有sampleRate键的对象，但它将默认采用与内部音频上下文相同的采样率，这适合您的设备。

crunker.fetchAudio(songURL, anotherSongURL)

获取一个或多个音频文件。
返回：按获取顺序排列的音频缓冲区数组。

crunker.mergeAudio(arrayOfBuffers);

合并两个或多个音频缓冲区。
返回：单个AudioBuffer对象。

crunker.concatAudio(arrayOfBuffers);

按指定的顺序连接两个或多个音频缓冲区。
返回：单个AudioBuffer对象。

crunker.padAudio（缓冲区，padStart，秒）；

在音频的开始、结束或任何指定点处用静音填充音频。
返回：单个AudioBuffer对象。

crunker.sliceAudio(缓冲区、开始、结束、淡入、淡出);

将音频切片到指定范围，删除范围之外的任何内容。可以选择在开始时添加淡入，在结束时添加淡出，以避免听到咔嗒声。

buffer：要修剪的音频缓冲区。
start：音频开始的起始秒数。
end：应修剪音频的结尾秒。
fadeIn：（可选）开始时淡入效果的秒数。默认值为0 。
fadeOut：（可选）结束时淡出效果的秒数。默认值为0 。

返回：单个AudioBuffer对象。

crunker.export（缓冲区，类型）；

使用 MIME 类型选项导出音频缓冲区。
类型：例如'audio/mp3', 'audio/wav', 'audio/ogg' 。重要提示：MIME 类型不会更改实际的文件格式。它的本质始终是一个WAVE文件。
返回：一个包含 blob 对象、url 和音频元素对象的对象。