{"id":15195,"date":"2026-10-01T03:37:28","date_gmt":"2026-10-01T03:37:28","guid":{"rendered":"https:\/\/playgama.com\/blog\/?p=15195"},"modified":"2026-10-01T03:37:28","modified_gmt":"2026-10-01T03:37:28","slug":"how-to-implement-audio-format-fallback-for-webm-opus-and-mp3","status":"publish","type":"post","link":"https:\/\/playgama.com\/blog\/business-faqs\/how-to-implement-audio-format-fallback-for-webm-opus-and-mp3\/","title":{"rendered":"How to implement audio format fallback for WebM Opus and MP3?"},"content":{"rendered":"

Provide both files and let the browser pick: use

At a glance<\/h2>\n\n\n\n\n\n\n\n
Fact<\/th>\nValue<\/th>\nSource<\/th>\n<\/tr>\n<\/thead>\n
WebM audio codec support<\/td>\nVorbis and Opus<\/td>\ndeveloper.mozilla.org<\/a><\/td>\n<\/tr>\n
Single-format alternate choice<\/td>\nMP3 (broadest support)<\/td>\ndeveloper.mozilla.org<\/a><\/td>\n<\/tr>\n
Feature test method<\/td>\ncanPlayType()<\/td>\ndeveloper.mozilla.org<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Give the browser two files and let it choose. With the HTML <audio><\/code> element, list a WebM\/Opus <source><\/code> first and an MP3 <source><\/code> second – the browser plays the first one it supports and ignores the rest:<\/p>\n

<audio controls>\n <source src=\"music.webm\" type=\"audio\/webm; codecs=opus\">\n <source src=\"music.mp3\" type=\"audio\/mpeg\">\n alternate text for unsupported browsers\n<\/audio><\/code><\/pre>\n
If you load audio in JavaScript instead of markup, test first with audio.canPlayType('audio\/webm; codecs=opus')<\/code>, which returns probably<\/code>, maybe<\/code> or an empty string, then pick the URL to fetch (MDN cross-browser audio basics<\/a>). MDN also notes that if you can only ship one format, MP3 covers the broadest range of devices and browsers, so keep an MP3 copy of every asset even if WebM\/Opus is your primary format.<\/p>\n
For Web Audio (used by most game engines and Phaser’s WebAudioSoundManager<\/code>), fetch the file as an ArrayBuffer and call decodeAudioData()<\/code>; catch a decode failure and retry with the MP3 URL, since decodeAudioData<\/code> rejects on unsupported audio. Phaser’s loader already does this kind of capability check, falling back to an HTML5AudioFile<\/code> when Web Audio isn’t available.<\/p>\n
With Playgama MCP, an AI agent can upload the build and publish a sandbox link to test playback across browsers.<\/p>\n
Test on real mobile Safari and older Android WebViews before shipping – codec support there is the part most likely to break silently.<\/p>\n
Sources<\/h2>\n