crunker

クランカー

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)

1 つ以上のオーディオ ファイルをフェッチします。
戻り値:フェッチされた順序でのオーディオ バッファーの配列。

crunker.mergeAudio(arrayOfBuffers);

2 つ以上のオーディオ バッファを結合します。
戻り値:単一のAudioBufferオブジェクト。

crunker.concatAudio(arrayOfBuffers);

2 つ以上のオーディオ バッファを指定された順序で連結します。
戻り値:単一のAudioBufferオブジェクト。

crunker.padAudio(バッファー、パッドスタート、秒);

オーディオの先頭、末尾、またはオーディオ内の指定したポイントに無音を埋め込みます。
戻り値:単一のAudioBufferオブジェクト。

crunker.sliceAudio(バッファ、開始、終了、フェードイン、フェードアウト);

オーディオを指定された範囲にスライスし、範囲外のコンテンツを削除します。必要に応じて、クリック音を避けるために、最初にフェードインを追加し、最後にフェードアウトを追加します。

• バッファ:トリミングされるオーディオ バッファ。
• start:オーディオが開始される開始秒数。
• end:オーディオをトリミングする終了秒。
• fadeIn: (オプション) 開始時のフェードイン効果の秒数。デフォルトは0です。
• fadeOut: (オプション) 最後のフェードアウト効果の秒数。デフォルトは0です。

戻り値:単一のAudioBufferオブジェクト。

crunker.export(バッファ, タイプ);

MIME タイプ オプションを使用してオーディオ バッファをエクスポートします。
タイプ: 'audio/mp3', 'audio/wav', 'audio/ogg'など。重要: MIME タイプによって実際のファイル形式は変更されません。内部では常にWAVEファイルになります。
戻り値: BLOB オブジェクト、URL、およびオーディオ要素オブジェクトを含むオブジェクト。

crunker.download(blob, ファイル名);

エクスポートされたオーディオ BLOB をオプションのファイル名で自動的にダウンロードします。
ファイル名: .mp3、.wav、または .ogg ファイル拡張子を含まない文字列。
戻り値:自動ダウンロードをシミュレートするために使用されるHTMLAnchorElement要素。

crunker.play(バッファ);

エクスポートされたオーディオ バッファーのバックグラウンドでの再生を開始します。
戻り値: HTMLAudioElement 。

crunker.notSupported(コールバック);

Web Audio API がユーザーのブラウザでサポートされていない場合は、カスタム コードを実行します。
戻り値:コールバック関数。

プロパティ

API ドキュメントの詳細については、Typescript の型付けを参照してください。

クランカー.コンテキスト

特定の Crunker によって内部的に使用される AudioContext にアクセスします。
戻り値: AudioContext。

ライセンス

マサチューセッツ工科大学