Lifecycle

setupPlayer(options: PlayerOptions)

Initializes the player with the specified options. These options do not apply to all platforms, see chart below.

These options are different than the ones set using updateOptions(). Options other than those listed below will not be applied.

You should always call this function (even without any options set) before using the player to make sure everything is initialized.

If the player is already initialized, the promise will resolve instantly.

Returns: Promise

Param	Type	Description	Default	Android	iOS	Windows
options	PlayerOptions	The options
options.minBuffer	number	Minimum time in seconds that needs to be buffered	15 (android), automatic (ios)	✅	✅	❌
options.maxBuffer	number	Maximum time in seconds that needs to be buffered	50	✅	❌	❌
options.playBuffer	number	Minimum time in seconds that needs to be buffered to start playing	2.5	✅	❌	❌
options.backBuffer	number	Time in seconds that should be kept in the buffer behind the current playhead time.	0	✅	❌	❌
options.maxCacheSize	number	Maximum cache size in kilobytes	0	✅	❌	❌
options.iosCategory	IOSCategory	AVAudioSession.Category for iOS. Sets on play()	playback	❌	✅	❌
options.iosCategoryOptions	IOSCategoryOptions[]	AVAudioSession.CategoryOptions for iOS. Sets on play()	[]	❌	✅	❌
options.iosCategoryMode	IOSCategoryMode	AVAudioSession.Mode for iOS. Sets on play()	default	❌	✅	❌
options.waitForBuffer	boolean	Indicates whether the player should automatically delay playback in order to minimize stalling. If you notice that network media immediately pauses after it buffers, setting this to true may help.	false	❌	✅	❌
options.autoUpdateMetadata	boolean	Indicates whether the player should automatically update now playing metadata data in control center / notification.	true	✅	❌	❌

destroy()

Destroys the player, cleaning up its resources. After executing this function, you won't be able to use the player anymore, unless you call setupPlayer() again.

registerPlaybackService(serviceProvider)

Register the playback service. The service will run as long as the player runs.

This function should only be called once, and should be registered right after registering your React application with AppRegistry.

You should use the playback service to register the event handlers that must be directly tied to the player, as the playback service might keep running when the app is in background.

Param	Type	Description
serviceProvider	function	The function that must return an async service function.

useTrackPlayerEvents(events: Event[], handler: Handler)

Hook that fires on the specified events.

You can find a list of events in the events section.