crunker

Crunker

Einfache Möglichkeit, Audiodateien mit der Web-Audio-API zusammenzuführen, zu verketten, abzuspielen, zu exportieren und herunterzuladen.

• Keine Abhängigkeiten
• Winzige 2 KB gezippt
• In Maschinenschrift geschrieben

Online-Demos ansehen

Installation

yarn add crunker

npm install crunker

Beispiel

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

Verdichtetes Beispiel

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

Beispiel für eine Eingabedatei

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

Andere Beispiele

• Beat Builder Machine

Grafische Darstellung von Methoden

Verschmelzen

Konkat

Methoden

Eine detailliertere API-Dokumentation finden Sie in den Typescript-Typisierungen.

neuer Crunker()

Erstellen Sie eine neue Instanz von Crunker. Optional können Sie ein Objekt mit einem sampleRate -Schlüssel versehen, es verwendet jedoch standardmäßig dieselbe Abtastrate wie der interne Audiokontext, was für Ihr Gerät geeignet ist.

crunker.fetchAudio(songURL, anotherSongURL)

Rufen Sie eine oder mehrere Audiodateien ab.
Gibt zurück: ein Array von Audiopuffern in der Reihenfolge, in der sie abgerufen wurden.

crunker.mergeAudio(arrayOfBuffers);

Führen Sie zwei oder mehr Audiopuffer zusammen.
Gibt zurück: ein einzelnes AudioBuffer Objekt.

crunker.concatAudio(arrayOfBuffers);

Verketten Sie zwei oder mehr Audiopuffer in der angegebenen Reihenfolge.
Gibt zurück: ein einzelnes AudioBuffer Objekt.

crunker.padAudio(buffer, padStart, seconds);

Füllen Sie den Ton am Anfang, am Ende oder an bestimmten Stellen im Ton mit Stille auf.
Gibt zurück: ein einzelnes AudioBuffer Objekt.

crunker.sliceAudio(buffer, start, end, fadeIn, fadeOut);

Schneiden Sie das Audio auf den angegebenen Bereich auf und entfernen Sie alle Inhalte außerhalb des Bereichs. Fügen Sie optional eine Einblendung am Anfang und eine Ausblendung am Ende hinzu, um hörbare Klickgeräusche zu vermeiden.

• buffer: Der Audiopuffer, der gekürzt werden soll.
• start: Die Startsekunde, ab der das Audio beginnen soll.
• end: Die letzte Sekunde, an der das Audio gekürzt werden soll.
• fadeIn: (Optional) Anzahl der Sekunden für den Einblendeffekt am Anfang. Der Standardwert ist 0 .
• fadeOut: (Optional) Anzahl der Sekunden für den Ausblendeffekt am Ende. Der Standardwert ist 0 .

Gibt zurück: ein einzelnes AudioBuffer Objekt.

crunker.export(buffer, type);

Exportieren Sie einen Audiopuffer mit der MIME-Typ-Option.
Typ: zB 'audio/mp3', 'audio/wav', 'audio/ogg' . WICHTIG : Der MIME-Typ ändert nicht das tatsächliche Dateiformat. Unter der Haube wird es immer eine WAVE Datei geben.
Gibt zurück: ein Objekt, das das Blob-Objekt, die URL und ein Audioelementobjekt enthält.

crunker.download(blob, Dateiname);

Laden Sie automatisch einen exportierten Audio-Blob mit optionalem Dateinamen herunter.
Dateiname: Zeichenfolge, die nicht die Dateierweiterung .mp3, .wav oder .ogg enthält.
Rückgabe: das HTMLAnchorElement Element, das zum Simulieren des automatischen Downloads verwendet wird.

crunker.play(buffer);

Beginnt die Wiedergabe des exportierten Audiopuffers im Hintergrund.
Gibt zurück: das HTMLAudioElement .

crunker.notSupported(callback);

Führen Sie benutzerdefinierten Code aus, wenn die Web-Audio-API vom Browser des Benutzers nicht unterstützt wird.
Rückgabe: Die Callback-Funktion.

Eigenschaften

Eine detailliertere API-Dokumentation finden Sie in den Typescript-Typisierungen.

crunker.context

Greifen Sie auf den AudioContext zu, der intern von einem bestimmten Crunker verwendet wird.
Gibt zurück: AudioContext.

Lizenz

MIT