@mcut/media
extractAudioToWav
Generated TypeScript API reference for the public mcut SDK.
mcut SDK / media/src / extractAudioToWav
Function: extractAudioToWav()
function extractAudioToWav(src, options?): Promise<Blob | null>;Defined in: packages/media/src/extract-audio.ts:76
Extract a file's audio track to a PCM WAV blob, fully client-side.
Returns null when the file has no audio track. The default
16 kHz/mono output keeps uploads to transcription APIs small.
Resilience: when the resampled conversion fails (Mediabunny's resampler / channel mixer can throw "Assertion failed." on unusual source layouts), retry once WITHOUT resampling — the WAV is bigger but transcription APIs accept any PCM rate. Undecodable codecs fail fast with a clear error.
Parameters
src
options?
ExtractAudioOptions = {}
Returns
Promise<Blob | null>