ครันเกอร์

วิธีง่ายๆ ในการผสาน เชื่อมต่อ เล่น ส่งออก และดาวน์โหลดไฟล์เสียงด้วย Web Audio API

ไม่มีการพึ่งพา
gzip ขนาด 2kB จิ๋ว
เขียนด้วยภาษา Typescript

ดูการสาธิตออนไลน์

การติดตั้ง

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()

สร้างอินสแตนซ์ใหม่ของ Crunker คุณสามารถเลือกระบุออบเจ็กต์ที่มีคีย์ sampleRate ได้ แต่จะตั้งค่าเริ่มต้นไว้ที่อัตราตัวอย่างเดียวกันกับบริบทเสียงภายใน ซึ่งเหมาะสมกับอุปกรณ์ของคุณ

crunker.fetchAudio (songURL, anotherSongURL)

ดึงไฟล์เสียงหนึ่งไฟล์ขึ้นไป
ส่งคืน: อาร์เรย์ของบัฟเฟอร์เสียงตามลำดับที่ดึงข้อมูล

crunker.mergeAudio (อาร์เรย์บัฟเฟอร์);

รวมบัฟเฟอร์เสียงตั้งแต่สองตัวขึ้นไป
ส่งคืน: วัตถุ AudioBuffer เดียว

crunker.concatAudio (อาร์เรย์ของบัฟเฟอร์);

เชื่อมต่อบัฟเฟอร์เสียงตั้งแต่สองตัวขึ้นไปตามลำดับที่ระบุ
ส่งคืน: วัตถุ AudioBuffer เดียว

crunker.padAudio (บัฟเฟอร์, padStart, วินาที);

แพดเสียงแบบเงียบที่จุดเริ่มต้น จุดสิ้นสุด หรือจุดใดๆ ที่ระบุผ่านเสียง
ส่งคืน: วัตถุ AudioBuffer เดียว

crunker.sliceAudio (บัฟเฟอร์, เริ่มต้น, สิ้นสุด, fadeIn, fadeOut);

แบ่งเสียงตามช่วงที่ระบุ โดยลบเนื้อหาที่อยู่นอกช่วงออก คุณสามารถเลือกเพิ่มเฟดเข้าที่จุดเริ่มต้นและเฟดเอาท์ในตอนท้ายเพื่อหลีกเลี่ยงการคลิกด้วยเสียง

buffer: บัฟเฟอร์เสียงที่จะตัด
start: วินาทีเริ่มต้นจากจุดที่เสียงควรเริ่มต้น
end: วินาทีสิ้นสุดที่ควรตัดเสียง
fadeIn: (ไม่บังคับ) จำนวนวินาทีสำหรับเอฟเฟกต์เฟดอินที่จุดเริ่มต้น ค่าเริ่มต้นคือ 0
fadeOut: (ไม่บังคับ) จำนวนวินาทีสำหรับเอฟเฟกต์เฟดเอาท์ในตอนท้าย ค่าเริ่มต้นคือ 0

ส่งคืน: วัตถุ AudioBuffer เดียว

crunker.export (บัฟเฟอร์, ประเภท);

ส่งออกบัฟเฟอร์เสียงด้วยตัวเลือกประเภท MIME
ประเภท: เช่น 'audio/mp3', 'audio/wav', 'audio/ogg' สิ่งสำคัญ : ประเภท MIME จะ ไม่ เปลี่ยนรูปแบบไฟล์จริง มันจะเป็นไฟล์ WAVE ที่ซ่อนอยู่เสมอ
ส่งคืน: วัตถุที่มีวัตถุหยด url และวัตถุองค์ประกอบเสียง

crunker.download (หยดชื่อไฟล์);

ดาวน์โหลด Blob เสียงที่ส่งออกโดยอัตโนมัติพร้อมชื่อไฟล์เสริม
ชื่อไฟล์: สตริงที่ ไม่มี นามสกุลไฟล์ .mp3, .wav หรือ .ogg
ส่งคืน: องค์ประกอบ HTMLAnchorElement ที่ใช้ในการจำลองการดาวน์โหลดอัตโนมัติ