crunker

Crunker

Maneira simples de mesclar, concatenar, reproduzir, exportar e baixar arquivos de áudio com a API Web Audio.

• Sem dependências
• Minúsculos 2kB compactados
• Escrito em texto datilografado

Veja demonstrações on-line

Instalação

yarn add crunker

npm install crunker

Exemplo

 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
} ) ;

Exemplo condensado

 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 ) ;
  } ) ;

Exemplo de arquivo de entrada

 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/*" / > ; 

Outros exemplos

• Máquina de construção de batidas

Representação Gráfica de Métodos

Mesclar

Concat

Métodos

Para obter documentação mais detalhada da API, consulte as tipificações Typescript.

novo Crunker()

Crie uma nova instância do Crunker. Opcionalmente, você pode fornecer a um objeto uma chave sampleRate , mas o padrão será a mesma taxa de amostragem do contexto de áudio interno, que é apropriado para o seu dispositivo.

crunker.fetchAudio (songURL, outroSongURL)

Busque um ou mais arquivos de áudio.
Retorna: uma matriz de buffers de áudio na ordem em que foram buscados.

crunker.mergeAudio(arrayOfBuffers);

Mesclar dois ou mais buffers de áudio.
Retorna: um único objeto AudioBuffer .

crunker.concatAudio(arrayOfBuffers);

Concatene dois ou mais buffers de áudio na ordem especificada.
Retorna: um único objeto AudioBuffer .

crunker.padAudio(buffer, padStart, segundos);

Preencha o áudio com silêncio, no início, no final ou em qualquer ponto específico do áudio.
Retorna: um único objeto AudioBuffer .

crunker.sliceAudio(buffer, início, fim, fadeIn, fadeOut);

Fatie o áudio no intervalo especificado, removendo qualquer conteúdo fora do intervalo. Opcionalmente, adicione um fade-in no início e um fade-out no final para evitar cliques audíveis.

• buffer: O buffer de áudio a ser cortado.
• start: O segundo inicial de onde o áudio deve começar.
• end: O segundo final onde o áudio deve ser cortado.
• fadeIn: (Opcional) Número de segundos para o efeito fade-in no início. O padrão é 0 .
• fadeOut: (Opcional) Número de segundos para o efeito de fade-out no final. O padrão é 0 .

Retorna: um único objeto AudioBuffer .

crunker.export(buffer, tipo);

Exporte buffers de áudio com opção de tipo MIME.
Tipo: por exemplo 'audio/mp3', 'audio/wav', 'audio/ogg' . IMPORTANTE : o tipo MIME não altera o formato real do arquivo. Sempre será um arquivo WAVE nos bastidores.
Retorna: um objeto contendo o objeto blob, url e um objeto de elemento de áudio.

crunker.download(blob, nome do arquivo);

Baixe automaticamente um blob de áudio exportado com nome de arquivo opcional.
Nome do arquivo: String que não contém a extensão de arquivo .mp3, .wav ou .ogg.
Retorna: o elemento HTMLAnchorElement utilizado para simular o download automático.

crunker.play (buffer);

Começa a reproduzir o buffer de áudio exportado em segundo plano.
Retorna: o HTMLAudioElement .

crunker.notSupported(retorno de chamada);

Execute o código personalizado se a API de áudio da Web não for compatível com o navegador do usuário.
Retorna: A função de retorno de chamada.

Propriedades

Para obter documentação mais detalhada da API, consulte as tipificações do Typescript.

crunker.context

Acesse o AudioContext usado internamente por um determinado Crunker.
Retorna: AudioContext.

Licença

MIT