Docs

Background audio & lock screen

Keep playback alive in the background and show Now Playing metadata on iOS/Android.

Background audio & lock screen

Pass backgroundPlayback: true to useMoviiePlayer so VideoPlayer.staysActiveInBackground stays enabled.

lockScreenNowPlaying maps to VideoPlayer.showNowPlayingNotification. Omit both flags for false; set each explicitly when you want background audio and/or lock-screen UI.

Use the @moviie/player-expo config plugin with backgroundPlayback: true so iOS receives UIBackgroundModesaudio after prebuild.

Details: Native playback features: Background audio & lock screen.

const { player, playback, videoPresentation } = useMoviiePlayer({
  embedId,
  backgroundPlayback: true,
})

return (
  <MoviieVideo
    player={player}
    playback={playback}
    {...videoPresentation}
  />
)

On this page