Docs

Background audio & lock screen

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

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} />