Background Audio Playback

1What is Background Audio?#

When enabled, audio/music playing in your WebView will continue playing even when the user switches to another app or turns off the screen.

Perfect for:

• Music streaming websites (SoundCloud, Bandcamp)
• Podcast platforms
• Radio stations
• Audio meditation / prayer apps
• YouTube music channels

2Enable in Generator#

In Step 2 (Display Settings):

1. Scroll to 'Display Options'
2. Toggle ON 'Background Audio Playback'
3. Generate your APK

No code changes needed on your website.

3How It Works#

Normally, when an Android app goes to the background, its WebView pauses all media playback. With Background Audio enabled:

• WebView is NOT paused when app goes to background
• Audio continues playing via the device speaker or headphones
• Video playback also continues (audio portion)

💡 Tip: Combine with PiP for video sites so users can watch in a floating window AND keep audio when the window is dismissed.

4Battery Considerations#

⚠️ Background audio keeps the WebView process alive, which uses more battery.

✅ Recommended: Only enable for apps that genuinely need background audio

✅ Users can still stop playback by pausing on your website or force-stopping the app

✅ Android's battery optimization may eventually pause background apps - this is normal system behavior.

5Website Best Practices#

For the best background audio experience, ensure your website:

✅ Uses the HTML5 <audio> or <video> elements
✅ Has play/pause controls easily accessible
✅ Handles the 'visibilitychange' event gracefully
✅ Does not auto-pause media when the page loses focus

// Prevent auto-pause on visibility change:
document.addEventListener('visibilitychange', function() {
  // Don't pause audio when tab/app is hidden
  if (document.hidden) {
    // Keep playing - do nothing
  }
});