Repository navigation
v1.2.0
1.2.0 (2026-10-23)
Short sounds, cars and watches, a sleep timer, and a CLI that sets up the optional parts. Everything is additive except one rule for catalog ids (see Upgrading).
Added
- Sound API (
react-native-anything-player/sound): short sounds for UI clicks and games, preloaded into memory and played with low latency. Several voices at once (the oldest is stolen when all are busy), per-play volume, rate, pan and loop, a handle per voice, andstopAll(). It mixes with other audio and has no media session. iOS on AVAudioEngine, Android on one shared SoundPool (32 voices), the web on Web Audio. Opt-in on iOS and Android with the Expo plugin'ssoundoption (rnapSound=true/RNAP_SOUND=1without Expo); always available on the web. New error codeSOUND_UNAVAILABLE. See Sound. - Cars and watches. Catalog items take a
group("Jazz","Podcasts/Daily"), and the catalog becomes a browse tree in CarPlay, Android Auto, Android Automotive OS and Wear OS, with "Recently played" and favorites (setCatalog(items, { browse }),setFavorites(ids)). A pick plays through the same path as a voice request and is reported assearchPlaywithrequest.origin: 'browse'. Long folders are split for car screens, andsearchCatalog/playFromSearchfilter by group. CarPlay and Android Auto are opt-in with the plugin'scaroption (rnapCar/RNAP_CARwithout Expo); Wear OS needs nothing. See Cars & watches. - Sleep timer and fades.
player.sleep({ after, fadeOut })pauses after a delay, fading out first;sleep(null)cancels it,status.sleepAtand asleepevent report it, anduseSleepTimer()counts down. Opt-in fades on play, pause and stop (new Player({ fade: { in, out } }),setFade()), andfadeTo(volume, seconds). The native engine runs them, so they keep working while JavaScript is frozen in the background. 25 new conformance scenarios, passed by all three engines. See Playback. - CLI: modules, size, info, migrate.
npx rnapis the documented name.rnap modules,rnap addandrnap removeturn the optional parts on and off (HLS, Cast, Siri, Assistant, the iOS background mode, the Sound API, cars) by writinggradle.properties,Podfile.properties.jsonor the Expo plugin's options, after showing the diff.rnap sizeshows what each costs in a release APK and a web page.rnap infoprints a report to paste into a bug report.rnap migraterewrites react-native-track-player, expo-audio and expo-av code to RNAP where the mapping is mechanical, and marks the rest. A write is atomic and refused if the file changed after its diff was shown.doctorreports module settings that disagree. See CLI.
Changed
- Web: less JavaScript on page load. The hls.js glue loads when hls.js is registered (
configureHls), and Google Cast's driver and Firefox's MP4 repackaging only when they are used: about 8 KB a page without them never loads. The Sound API is its own entry, so a page that only streams does not load it. - The API reference has a
playerand asoundsection; links to its old paths redirect.
Upgrading
- Catalog ids starting with
rnap:are rejected withINVALID_ARGUMENT, because the browse tree names its folders with that prefix. Rename such ids before upgrading. No other change is needed.