crunker

Кранкер

Простой способ объединения, объединения, воспроизведения, экспорта и загрузки аудиофайлов с помощью API веб-аудио.

• Нет зависимостей
• Крошечный архив размером 2 КБ
• Написано на машинописном языке

Посмотреть онлайн-демоверсии

Установка

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,otherSongURL)

Получите один или несколько аудиофайлов.
Возвращает: массив аудиобуферов в том порядке, в котором они были выбраны.

crunker.mergeAudio(arrayOfBuffers);

Объедините два или более аудиобуферов.
Возвращает: один объект AudioBuffer .

crunker.concatAudio(arrayOfBuffers);

Объедините два или более аудиобуферов в указанном порядке.
Возвращает: один объект AudioBuffer .

crunker.padAudio(буфер,padStart, секунды);

Дополните звук тишиной в начале, конце или в любых указанных точках звука.
Возвращает: один объект AudioBuffer .

crunker.sliceAudio(буфер, начало, конец, FadeIn, FadeOut);

Нарежьте звук на указанный диапазон, удалив все содержимое за пределами диапазона. При желании добавьте постепенное появление в начале и постепенное затухание в конце, чтобы избежать слышимых щелчков.

• буфер: аудиобуфер, который нужно обрезать.
• start: Начальная секунда, с которой должен начаться звук.
• конец: конечная секунда, в которой звук должен быть обрезан.
• FadeIn: (Необязательно) Количество секунд для эффекта постепенного появления в начале. По умолчанию — 0 .
• FadeOut: (Необязательно) Количество секунд для эффекта затухания в конце. По умолчанию — 0 .

Возвращает: один объект AudioBuffer .

crunker.export(буфер, тип);

Экспортируйте аудиобуферы с опцией типа MIME.
Тип: например 'audio/mp3', 'audio/wav', 'audio/ogg' . ВАЖНО : тип MIME не меняет фактический формат файла. Под капотом всегда будет WAVE файл.
Возвращает: объект, содержащий объект blob, URL-адрес и объект аудиоэлемента.

crunker.download(blob, имя файла);

Автоматически загружать экспортированный аудиофайл с необязательным именем файла.
Имя файла: строка, не содержащая расширения файла .mp3, .wav или .ogg.
Возвращает: элемент HTMLAnchorElement используемый для имитации автоматической загрузки.

crunker.play(буфер);

Начинает воспроизведение экспортированного аудиобуфера в фоновом режиме.
Возвращает: HTMLAudioElement .

crunker.notSupported(обратный вызов);

Выполните собственный код, если API веб-аудио не поддерживается браузером пользователя.
Возвращает: функция обратного вызова.

Характеристики

Более подробную документацию по API см. в разделе Типизация Typescript.

crunker.context

Получите доступ к AudioContext, используемому внутри данного Crunker.
Возвращает: АудиоКонтекст.

Лицензия

Массачусетский технологический институт