WebToAppMaker

JavaScript Bridge

Background Audio and Notification Controls

Keep configured web audio playing in the background and expose native play/pause and stop notification actions.

Before you start

  • Background Audio or Audio Notification Controls enabled
  • HTML audio or video elements in the page
  • Notification permission on Android 13+ when controls are used

Configure and verify

  1. Enable media settings

    In App Settings, enable background audio and/or notification controls and choose autoplay behavior.

  2. Build and grant permission

    Create a new APK and grant notification permission on Android 13+ when prompted.

  3. Use standard media elements

    The injected WebToAppAudio helper discovers audio and video elements and watches play, pause, and ended events.

  4. Test native actions

    Play media, background the app, then use notification play/pause and stop. Verify the website element responds.

Manual state update

webtoapp.audioStateChanged("playing", document.title);

Current control scope

Native actions call WebToAppAudio.toggle() and WebToAppAudio.stop() inside the active WebView. Pages with custom players should expose compatible audio/video elements or integrate their state explicitly.

Test before release

  • Background playback follows policy
  • Notification appears only while relevant
  • Play/pause and stop work
  • Notification permission denial is handled