react-native-nitro-player 1.7.0-alpha.3 → 1.7.0-alpha.4

package/src/specs/TrackPlayer.nitro.ts

@@ -8,6 +8,7 @@ import type {
   PlayerConfig,
   Playlist,
   TimedMetadata,
+  ShufflePlaylistOptions,
 } from '../types/PlayerQueue'
 
 export interface PlayerQueue extends HybridObject<{
@@ -47,6 +48,16 @@ export interface PlayerQueue extends HybridObject<{
     trackId: string,
     newIndex: number
   ): Promise<void>
+  /** One native pass. Unknown ids are skipped; rejects only if the playlist does not exist. */
+  removeTracksFromPlaylist(
+    playlistId: string,
+    trackIds: string[]
+  ): Promise<void>
+  /** Fisher-Yates shuffle of the stored playlist, persisted. Never interrupts the playing item. */
+  shufflePlaylist(
+    playlistId: string,
+    options?: ShufflePlaylistOptions
+  ): Promise<void>
 
   // Playback control
   loadPlaylist(playlistId: string, index?: number): Promise<void>

package/src/types/PlayerQueue.ts

@@ -26,6 +26,11 @@ export interface Playlist {
 
 export type QueueOperation = 'add' | 'remove' | 'clear' | 'update'
 
+export interface ShufflePlaylistOptions {
+  /** Move the playing track to index 0 and shuffle the rest behind it (default: true). */
+  keepCurrentTrackFirst?: boolean
+}
+
 export type TrackPlayerState = 'playing' | 'paused' | 'stopped' | 'buffering'
 
 export type Reason = 'user_action' | 'skip' | 'end' | 'error' | 'repeat'
@@ -56,6 +61,15 @@ export interface TimedMetadata {
   artworkUrl?: string
 }
 
+/**
+ * How Android reacts when another app takes audio focus.
+ * - 'pause': pause for any interruption and resume after it (default, today's behaviour)
+ * - 'duck': keep playing at a reduced volume through transient interruptions
+ * - 'ignore': never react to audio focus at all
+ * iOS ignores this option.
+ */
+export type AndroidAudioFocusMode = 'pause' | 'duck' | 'ignore'
+
 export interface PlayerConfig {
   androidAutoEnabled?: boolean
   carPlayEnabled?: boolean
@@ -75,4 +89,7 @@ export interface PlayerConfig {
   lookaheadCount?: number
 
   androidNotificationIcon?: string
+
+  /** How Android reacts when another app takes audio focus (default: 'pause'). */
+  androidAudioFocus?: AndroidAudioFocusMode
 }