克魯克

使用 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 和音訊元素物件的物件。