doublesymmetry/react-native-track-player v5.3.0

on GitHub

Android background handlers now receive BackgroundEvent objects (event.type + fields), matching the documented TypeScript API. Docs and a one-time iOS dev warning clarify how event delivery differs by platform.

Full notes: rntp.dev/changelog#5.3.0

Fixed

• registerBackgroundEventHandler (Android) — Headless JS now normalizes native { event, payload } into BackgroundEvent before calling your handler, so event.type and payload fields match TypeScript. Breaking if you relied on the raw Headless shape — switch to BackgroundEvent. (#2644)

Changed

• registerBackgroundEventHandler (iOS) — logs a one-time __DEV__ warning when called (still a no-op). Use addEventListener for all events on iOS, including while audio plays in the background with UIBackgroundModes audio.

Upgrade

npm install @rntp/player@5.3.0
# iOS
cd ios && pod install