react-native-audio-browser 0.2.0-next.8 → 0.2.0-next.80

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1246) hide show
  1. package/README.md +66 -39
  2. package/android/build.gradle +53 -14
  3. package/android/gradle.properties +3 -3
  4. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +588 -441
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  9. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  10. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  11. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  12. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +163 -0
  13. package/android/src/main/java/com/audiobrowser/Service.kt +84 -104
  14. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  15. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  16. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  17. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +358 -541
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +36 -66
  19. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  20. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  21. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  22. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  23. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -28
  24. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  25. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  26. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +10 -18
  27. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  28. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  29. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  30. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  32. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  33. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +28 -42
  34. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  35. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  36. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  37. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  38. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  39. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  40. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  41. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  42. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +67 -0
  43. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  44. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +93 -52
  45. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  46. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  47. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +50 -33
  48. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  49. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  50. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +110 -116
  51. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +62 -38
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +121 -132
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  55. package/android/src/main/java/com/audiobrowser/player/Player.kt +490 -581
  56. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  57. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -23
  58. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +107 -129
  59. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +97 -0
  60. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +49 -128
  61. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  62. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  63. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  64. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  65. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  66. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +53 -68
  67. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  68. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  70. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  71. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  72. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +736 -0
  73. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  89. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  90. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  91. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  92. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  93. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  94. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  95. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  96. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  97. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  98. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  99. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  100. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  101. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  102. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  103. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  104. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  105. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  106. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  107. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  108. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  109. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  110. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  111. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  112. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  113. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  114. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  115. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  116. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  117. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -83
  118. package/android/src/main/res/values/strings.xml +25 -5
  119. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  120. package/android/src/test/java/androidx/media3/session/SessionViews.kt +10 -0
  121. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  122. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  123. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  124. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  125. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  126. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  127. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  128. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +322 -0
  129. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -42
  130. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  131. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  132. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  133. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  134. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +87 -25
  135. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -8
  136. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  137. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  138. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +1 -3
  139. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  140. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -53
  141. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  142. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  143. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +43 -0
  144. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  145. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  146. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +70 -16
  147. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  148. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  149. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  150. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  151. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  152. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  153. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  154. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  155. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  156. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +372 -0
  157. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  158. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  159. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  160. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +251 -21
  161. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  162. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  163. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +90 -38
  164. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  165. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  166. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  167. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  168. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  169. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  170. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  171. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +478 -0
  172. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +221 -0
  173. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  174. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  176. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +379 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +199 -0
  178. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  179. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +34 -79
  180. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +236 -0
  181. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  182. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +188 -0
  183. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  184. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  185. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  186. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +61 -23
  187. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +308 -0
  188. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  189. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  190. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  191. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1000 -0
  192. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  193. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  194. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  195. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  196. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  197. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  198. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  199. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  200. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  201. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  202. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  203. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  204. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  205. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  206. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  207. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  208. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  209. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  210. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  211. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  212. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  213. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  214. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  215. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  216. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  217. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  218. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  219. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  220. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  221. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  222. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  223. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  224. package/android/src/test/resources/sonos/device_description.xml +78 -0
  225. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  226. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  227. package/ios/AVPlayerEngine.swift +363 -0
  228. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  229. package/ios/Browser/BrowseGate.swift +57 -0
  230. package/ios/Browser/BrowserConfig.swift +123 -104
  231. package/ios/Browser/BrowserError.swift +15 -0
  232. package/ios/Browser/BrowserManager.swift +153 -675
  233. package/ios/Browser/BrowserPathHelper.swift +54 -117
  234. package/ios/Browser/FavoriteSet.swift +43 -0
  235. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  236. package/ios/Browser/JsonModels.swift +244 -335
  237. package/ios/Browser/NavigationErrorState.swift +42 -0
  238. package/ios/Browser/PageResolver.swift +132 -0
  239. package/ios/Browser/RequestLayer.swift +181 -0
  240. package/ios/Browser/RequestPipeline.swift +295 -0
  241. package/ios/Browser/SearchDrillIn.swift +10 -16
  242. package/ios/Browser/SectionScope.swift +73 -26
  243. package/ios/Browser/SimpleRouter.swift +76 -154
  244. package/ios/Browser/StyleResolver.swift +41 -0
  245. package/ios/Browser/TabBarEntries.swift +8 -7
  246. package/ios/Browser/TrackIdTemplate.swift +29 -0
  247. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  248. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  249. package/ios/CarPlay/CarPlayController.swift +37 -1297
  250. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  251. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  252. package/ios/CarPlay/CarPlayNowPlayingManager.swift +130 -205
  253. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  254. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  255. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  256. package/ios/CarPlay/CarPlaySession+TabBar.swift +187 -0
  257. package/ios/CarPlay/CarPlaySession.swift +203 -0
  258. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  259. package/ios/CarPlay/IntentHandlers.swift +94 -0
  260. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  261. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +9 -16
  262. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  263. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  264. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  265. package/ios/CarPlay/SectionPresentation.swift +67 -0
  266. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  267. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  268. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  269. package/ios/Extension/CxxVectorConformances.swift +4 -16
  270. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  271. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  272. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  273. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  274. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  275. package/ios/Extension/SearchParams+Query.swift +28 -0
  276. package/ios/Extension/Section+Copying.swift +26 -0
  277. package/ios/Extension/String+IcyCharset.swift +21 -0
  278. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  279. package/ios/Extension/Track+AVPlayer.swift +1 -18
  280. package/ios/Extension/Track+Copying.swift +13 -21
  281. package/ios/Extension/Track+Identity.swift +20 -0
  282. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  283. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  284. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  285. package/ios/Extension/URLError+Connectivity.swift +15 -0
  286. package/ios/Extension/Variant+Artwork.swift +8 -22
  287. package/ios/Http/HttpClient.swift +73 -167
  288. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  289. package/ios/HybridAudioBrowser+Options.swift +116 -0
  290. package/ios/HybridAudioBrowser+Player.swift +347 -0
  291. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  292. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  293. package/ios/HybridAudioBrowser.swift +148 -1689
  294. package/ios/Model/NitroTypeStubs.swift +240 -32
  295. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  296. package/ios/Model/RemoteCommand.swift +6 -78
  297. package/ios/Model/TrackPlayerError.swift +12 -21
  298. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  299. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  300. package/ios/Observer/ItemObserver.swift +92 -0
  301. package/ios/Observer/PlayerObserver.swift +59 -0
  302. package/ios/Option/SessionCategories.swift +41 -92
  303. package/ios/PlaybackEvent.swift +4 -2
  304. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  305. package/ios/Player/AudioSessionController.swift +190 -0
  306. package/ios/Player/DeferredSeek.swift +73 -0
  307. package/ios/Player/ErrorStatus.swift +52 -0
  308. package/ios/Player/MediaLoader.swift +73 -98
  309. package/ios/Player/NowPlayingLines.swift +49 -0
  310. package/ios/Player/NowPlayingUpdater.swift +180 -105
  311. package/ios/Player/PersistedPlaybackState.swift +1 -2
  312. package/ios/Player/PlaybackFailure.swift +121 -0
  313. package/ios/Player/PlaybackPersistence.swift +72 -0
  314. package/ios/Player/PlaybackStateMachine.swift +11 -11
  315. package/ios/Player/PlaybackTimer.swift +11 -8
  316. package/ios/Player/Player.swift +1010 -0
  317. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  318. package/ios/Player/PlayerEngine.swift +109 -0
  319. package/ios/Player/PlayerStatusTypes.swift +1 -6
  320. package/ios/Player/QueueManager.swift +80 -98
  321. package/ios/Player/ReconnectPacer.swift +83 -0
  322. package/ios/Player/RetryLoop.swift +334 -0
  323. package/ios/Player/ShuffleOrder.swift +36 -43
  324. package/ios/Player/SilenceBudget.swift +78 -0
  325. package/ios/Player/SleepTimerManager.swift +25 -42
  326. package/ios/Player/VolumeFader.swift +20 -15
  327. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -20
  328. package/ios/RemoteCommand/RemoteCommandController.swift +99 -337
  329. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  330. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  331. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  332. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  333. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  334. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  335. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  336. package/ios/Tests/DeferredSeekTests.swift +76 -0
  337. package/ios/Tests/EmitterTests.swift +22 -39
  338. package/ios/Tests/ErrorStatusTests.swift +50 -0
  339. package/ios/Tests/FavoriteSetTests.swift +61 -0
  340. package/ios/Tests/GenerationMemoTests.swift +178 -0
  341. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  342. package/ios/Tests/JsonModelsTests.swift +189 -3
  343. package/ios/Tests/LRUCacheTests.swift +106 -0
  344. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  345. package/ios/Tests/MediaLoaderTests.swift +38 -78
  346. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  347. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  348. package/ios/Tests/ObserverTests.swift +88 -0
  349. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  350. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  351. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  352. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  353. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  354. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  355. package/ios/Tests/PlayerPolicyTests.swift +991 -0
  356. package/ios/Tests/PlayerTests.swift +1719 -0
  357. package/ios/Tests/PlayingStateTests.swift +41 -0
  358. package/ios/Tests/QueueManagerTests.swift +205 -174
  359. package/ios/Tests/ReadyValueTests.swift +73 -0
  360. package/ios/Tests/RemoteCommandControllerTests.swift +65 -48
  361. package/ios/Tests/RequestLayerTests.swift +228 -0
  362. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  363. package/ios/Tests/RetryCaseTests.swift +146 -0
  364. package/ios/Tests/RetryLoopTests.swift +307 -0
  365. package/ios/Tests/SearchDrillInTests.swift +16 -17
  366. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  367. package/ios/Tests/SectionPresentationTests.swift +85 -0
  368. package/ios/Tests/SectionScopeTests.swift +136 -54
  369. package/ios/Tests/SimpleRouterTests.swift +39 -8
  370. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  371. package/ios/Tests/StyleResolverTests.swift +123 -0
  372. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  373. package/ios/Tests/Support/TestTypes.swift +152 -100
  374. package/ios/Tests/Support/TimeLimit.swift +43 -0
  375. package/ios/Tests/TabBarEntriesTests.swift +18 -20
  376. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  377. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  378. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  379. package/ios/Tests/TrackIdentityTests.swift +20 -0
  380. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  381. package/ios/Tests/TrackSelectorTests.swift +157 -34
  382. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  383. package/ios/TrackSelector.swift +62 -77
  384. package/ios/Util/ArtworkFreshness.swift +42 -0
  385. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  386. package/ios/Util/AwaitCallback.swift +80 -0
  387. package/ios/Util/ConcurrentMap.swift +19 -0
  388. package/ios/Util/Emitter.swift +45 -22
  389. package/ios/Util/GenerationMemo.swift +43 -0
  390. package/ios/Util/LRUCache.swift +23 -159
  391. package/ios/Util/NetworkMonitor.swift +31 -33
  392. package/ios/Util/OutputPicker.swift +48 -0
  393. package/ios/Util/ReadyValue.swift +57 -0
  394. package/ios/Util/SFSymbolRenderer.swift +64 -49
  395. package/ios/Util/SVGProcessor.swift +9 -16
  396. package/lib/commonjs/AudioBrowser.js +11 -0
  397. package/lib/commonjs/AudioBrowser.js.map +1 -1
  398. package/lib/commonjs/CLAUDE.md +57 -0
  399. package/lib/commonjs/features/battery.js +16 -12
  400. package/lib/commonjs/features/battery.js.map +1 -1
  401. package/lib/commonjs/features/browser-config.js +13 -9
  402. package/lib/commonjs/features/browser-config.js.map +1 -1
  403. package/lib/commonjs/features/browser.js +78 -20
  404. package/lib/commonjs/features/browser.js.map +1 -1
  405. package/lib/commonjs/features/carConnection.js +3 -4
  406. package/lib/commonjs/features/carConnection.js.map +1 -1
  407. package/lib/commonjs/features/equalizer.js +9 -5
  408. package/lib/commonjs/features/equalizer.js.map +1 -1
  409. package/lib/commonjs/features/errors.js +35 -21
  410. package/lib/commonjs/features/errors.js.map +1 -1
  411. package/lib/commonjs/features/favorites.js +28 -23
  412. package/lib/commonjs/features/favorites.js.map +1 -1
  413. package/lib/commonjs/features/gate.js +27 -6
  414. package/lib/commonjs/features/gate.js.map +1 -1
  415. package/lib/commonjs/features/metadata.js +61 -11
  416. package/lib/commonjs/features/metadata.js.map +1 -1
  417. package/lib/commonjs/features/network.js +5 -1
  418. package/lib/commonjs/features/network.js.map +1 -1
  419. package/lib/commonjs/features/nowPlaying.js +28 -14
  420. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  421. package/lib/commonjs/features/output.js +9 -4
  422. package/lib/commonjs/features/output.js.map +1 -1
  423. package/lib/commonjs/features/playback/controls.js +13 -6
  424. package/lib/commonjs/features/playback/controls.js.map +1 -1
  425. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  426. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  427. package/lib/commonjs/features/playback/playing.js +5 -3
  428. package/lib/commonjs/features/playback/playing.js.map +1 -1
  429. package/lib/commonjs/features/playback/progress.js +13 -6
  430. package/lib/commonjs/features/playback/progress.js.map +1 -1
  431. package/lib/commonjs/features/playback/rate.js +8 -1
  432. package/lib/commonjs/features/playback/rate.js.map +1 -1
  433. package/lib/commonjs/features/playback/state.js +5 -6
  434. package/lib/commonjs/features/playback/state.js.map +1 -1
  435. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  436. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  437. package/lib/commonjs/features/playback/volume.js +6 -5
  438. package/lib/commonjs/features/playback/volume.js.map +1 -1
  439. package/lib/commonjs/features/player/options.js +21 -11
  440. package/lib/commonjs/features/player/options.js.map +1 -1
  441. package/lib/commonjs/features/player/setup.js +39 -39
  442. package/lib/commonjs/features/player/setup.js.map +1 -1
  443. package/lib/commonjs/features/player/validateOptions.js +3 -4
  444. package/lib/commonjs/features/player/validateOptions.js.map +1 -1
  445. package/lib/commonjs/features/queue/activeTrack.js +14 -4
  446. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  447. package/lib/commonjs/features/queue/queue.js +56 -21
  448. package/lib/commonjs/features/queue/queue.js.map +1 -1
  449. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  450. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  451. package/lib/commonjs/features/queue/shuffle.js +0 -1
  452. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  453. package/lib/commonjs/features/remoteControls.js +59 -35
  454. package/lib/commonjs/features/remoteControls.js.map +1 -1
  455. package/lib/commonjs/features/sleepTimer.js +23 -6
  456. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  457. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  458. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  459. package/lib/commonjs/utils/LazyNativeEmitter.js +18 -10
  460. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  461. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  462. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  463. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  464. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  465. package/lib/commonjs/utils/useDebug.js +16 -3
  466. package/lib/commonjs/utils/useDebug.js.map +1 -1
  467. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  468. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  469. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  470. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  471. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  472. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  473. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  474. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  475. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  476. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  477. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  478. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  479. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  480. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  481. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  482. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  483. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  484. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  485. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  486. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  487. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  488. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  489. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  490. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  491. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  492. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  493. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  494. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  495. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  496. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  497. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  498. package/lib/commonjs/web/browser/sections.js +89 -0
  499. package/lib/commonjs/web/browser/sections.js.map +1 -0
  500. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  501. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  502. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  503. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  504. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  505. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  506. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  507. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  508. package/lib/module/AudioBrowser.js +2 -4
  509. package/lib/module/AudioBrowser.js.map +1 -1
  510. package/lib/module/CLAUDE.md +57 -0
  511. package/lib/module/features/battery.js +16 -12
  512. package/lib/module/features/battery.js.map +1 -1
  513. package/lib/module/features/browser-config.js +13 -9
  514. package/lib/module/features/browser-config.js.map +1 -1
  515. package/lib/module/features/browser.js +78 -20
  516. package/lib/module/features/browser.js.map +1 -1
  517. package/lib/module/features/carConnection.js +3 -4
  518. package/lib/module/features/carConnection.js.map +1 -1
  519. package/lib/module/features/equalizer.js +9 -5
  520. package/lib/module/features/equalizer.js.map +1 -1
  521. package/lib/module/features/errors.js +35 -21
  522. package/lib/module/features/errors.js.map +1 -1
  523. package/lib/module/features/favorites.js +28 -23
  524. package/lib/module/features/favorites.js.map +1 -1
  525. package/lib/module/features/gate.js +27 -6
  526. package/lib/module/features/gate.js.map +1 -1
  527. package/lib/module/features/metadata.js +59 -11
  528. package/lib/module/features/metadata.js.map +1 -1
  529. package/lib/module/features/network.js +5 -1
  530. package/lib/module/features/network.js.map +1 -1
  531. package/lib/module/features/nowPlaying.js +28 -14
  532. package/lib/module/features/nowPlaying.js.map +1 -1
  533. package/lib/module/features/output.js +9 -4
  534. package/lib/module/features/output.js.map +1 -1
  535. package/lib/module/features/playback/controls.js +13 -6
  536. package/lib/module/features/playback/controls.js.map +1 -1
  537. package/lib/module/features/playback/playWhenReady.js +6 -5
  538. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  539. package/lib/module/features/playback/playing.js +5 -3
  540. package/lib/module/features/playback/playing.js.map +1 -1
  541. package/lib/module/features/playback/progress.js +13 -6
  542. package/lib/module/features/playback/progress.js.map +1 -1
  543. package/lib/module/features/playback/rate.js +8 -1
  544. package/lib/module/features/playback/rate.js.map +1 -1
  545. package/lib/module/features/playback/state.js +5 -6
  546. package/lib/module/features/playback/state.js.map +1 -1
  547. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  548. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  549. package/lib/module/features/playback/volume.js +6 -5
  550. package/lib/module/features/playback/volume.js.map +1 -1
  551. package/lib/module/features/player/options.js +21 -11
  552. package/lib/module/features/player/options.js.map +1 -1
  553. package/lib/module/features/player/setup.js +39 -39
  554. package/lib/module/features/player/setup.js.map +1 -1
  555. package/lib/module/features/player/validateOptions.js +3 -4
  556. package/lib/module/features/player/validateOptions.js.map +1 -1
  557. package/lib/module/features/queue/activeTrack.js +14 -4
  558. package/lib/module/features/queue/activeTrack.js.map +1 -1
  559. package/lib/module/features/queue/queue.js +56 -21
  560. package/lib/module/features/queue/queue.js.map +1 -1
  561. package/lib/module/features/queue/repeatMode.js +2 -1
  562. package/lib/module/features/queue/repeatMode.js.map +1 -1
  563. package/lib/module/features/queue/shuffle.js +0 -1
  564. package/lib/module/features/queue/shuffle.js.map +1 -1
  565. package/lib/module/features/remoteControls.js +59 -35
  566. package/lib/module/features/remoteControls.js.map +1 -1
  567. package/lib/module/features/sleepTimer.js +24 -7
  568. package/lib/module/features/sleepTimer.js.map +1 -1
  569. package/lib/module/test-utils/reactNativeStub.js +58 -0
  570. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  571. package/lib/module/utils/LazyNativeEmitter.js +18 -10
  572. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  573. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  574. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  575. package/lib/module/utils/getTrackIdentity.js +22 -0
  576. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  577. package/lib/module/utils/useDebug.js +16 -3
  578. package/lib/module/utils/useDebug.js.map +1 -1
  579. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  580. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  581. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  582. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  583. package/lib/module/web/NativeAudioBrowser.js +207 -84
  584. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  585. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  586. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  587. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  588. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  589. package/lib/module/web/TrackPlayer/Player.js +256 -40
  590. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  591. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  592. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  593. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  594. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  595. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  596. package/lib/module/web/browser/BrowserManager.js +175 -100
  597. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  598. package/lib/module/web/browser/FavoriteManager.js +31 -21
  599. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  600. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  601. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  602. package/lib/module/web/browser/SearchManager.js +18 -23
  603. package/lib/module/web/browser/SearchManager.js.map +1 -1
  604. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  605. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  606. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  607. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  608. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  609. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  610. package/lib/module/web/browser/sections.js +83 -0
  611. package/lib/module/web/browser/sections.js.map +1 -0
  612. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  613. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  614. package/lib/module/web/http/followMediaRedirect.js +215 -0
  615. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  616. package/lib/module/web/player/NowPlayingManager.js +4 -3
  617. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  618. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  619. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  620. package/lib/typescript/package.json +1 -0
  621. package/lib/typescript/src/AudioBrowser.d.ts +1 -0
  622. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  623. package/lib/typescript/src/features/battery.d.ts +17 -12
  624. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  625. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  626. package/lib/typescript/src/features/browser.d.ts +67 -19
  627. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  628. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  629. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  630. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  631. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  632. package/lib/typescript/src/features/errors.d.ts +37 -22
  633. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  634. package/lib/typescript/src/features/favorites.d.ts +28 -23
  635. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  636. package/lib/typescript/src/features/gate.d.ts +29 -8
  637. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  638. package/lib/typescript/src/features/metadata.d.ts +65 -14
  639. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  640. package/lib/typescript/src/features/network.d.ts +5 -1
  641. package/lib/typescript/src/features/network.d.ts.map +1 -1
  642. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  643. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  644. package/lib/typescript/src/features/output.d.ts +9 -4
  645. package/lib/typescript/src/features/output.d.ts.map +1 -1
  646. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  647. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  648. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  649. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  650. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  651. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  652. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  653. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  654. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  655. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  656. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  657. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  658. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  659. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  660. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  661. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  662. package/lib/typescript/src/features/player/options.d.ts +73 -56
  663. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  664. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  665. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  666. package/lib/typescript/src/features/queue/activeTrack.d.ts +8 -2
  667. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  668. package/lib/typescript/src/features/queue/queue.d.ts +50 -19
  669. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  670. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  671. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  672. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  673. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  674. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  675. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  676. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  677. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  678. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  679. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  680. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  681. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  682. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  683. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  684. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  685. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  686. package/lib/typescript/src/types/browser.d.ts +242 -173
  687. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  688. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +13 -17
  689. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  690. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  691. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  692. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  693. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  694. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  695. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  696. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  697. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  698. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  699. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  700. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  701. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  702. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  703. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  704. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  705. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  706. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  707. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  710. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  711. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  712. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  713. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  717. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  718. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  720. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  721. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  722. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  723. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  724. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  725. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  726. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  727. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  728. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  730. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  731. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  732. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  733. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  734. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  735. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  737. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  738. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  740. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  741. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  742. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  743. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  747. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  748. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  749. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  752. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  753. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  755. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  756. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  757. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  762. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  763. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  765. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  766. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  773. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  774. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  776. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  777. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  782. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  783. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  784. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  785. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  787. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  790. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  793. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  796. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  797. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  799. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  801. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  802. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  803. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  804. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  805. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  807. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  810. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  813. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  815. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  816. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  817. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  818. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  825. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  826. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  829. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  830. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  832. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  833. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  835. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  838. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  839. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  840. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  841. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  842. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  843. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  844. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  845. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  846. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  847. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  848. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  849. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  850. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  851. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  852. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  853. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  854. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  855. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  856. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  857. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  858. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  859. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  860. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  861. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  862. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  863. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  1001. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1002. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  1003. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  1004. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  1005. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  1006. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1007. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1008. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1009. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1010. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1011. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1012. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1013. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  1014. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  1015. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  1016. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1017. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  1018. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  1019. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1020. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1021. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1022. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1023. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1024. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1025. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1026. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1027. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1028. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1029. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1030. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1031. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1032. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1033. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1034. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1035. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1036. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1037. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1038. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1039. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1040. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1041. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1042. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1043. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1044. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1045. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1046. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1047. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1048. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1049. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1050. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1051. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1052. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1053. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1054. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1055. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1056. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1057. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1058. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1059. package/package.json +26 -13
  1060. package/src/AudioBrowser.ts +2 -4
  1061. package/src/CLAUDE.md +57 -0
  1062. package/src/docs-floors.test.ts +71 -0
  1063. package/src/features/battery.test.ts +79 -0
  1064. package/src/features/battery.ts +17 -13
  1065. package/src/features/browser-config.test.ts +21 -6
  1066. package/src/features/browser-config.ts +13 -9
  1067. package/src/features/browser.test.ts +1 -1
  1068. package/src/features/browser.ts +69 -20
  1069. package/src/features/carConnection.ts +3 -4
  1070. package/src/features/equalizer.ts +9 -5
  1071. package/src/features/errors.ts +37 -22
  1072. package/src/features/favorites.ts +28 -23
  1073. package/src/features/gate.ts +29 -8
  1074. package/src/features/hook-wiring.test.ts +302 -0
  1075. package/src/features/metadata.ts +80 -14
  1076. package/src/features/network.ts +5 -1
  1077. package/src/features/nowPlaying.ts +28 -14
  1078. package/src/features/output.ts +9 -4
  1079. package/src/features/playback/controls.ts +13 -6
  1080. package/src/features/playback/playWhenReady.ts +6 -5
  1081. package/src/features/playback/playing.ts +16 -3
  1082. package/src/features/playback/progress.test.ts +169 -0
  1083. package/src/features/playback/progress.ts +13 -6
  1084. package/src/features/playback/rate.ts +8 -1
  1085. package/src/features/playback/state.ts +10 -6
  1086. package/src/features/playback/trackPlaybackTime.test.ts +1 -5
  1087. package/src/features/playback/trackPlaybackTime.ts +9 -2
  1088. package/src/features/playback/volume.ts +6 -5
  1089. package/src/features/player/options.ts +82 -63
  1090. package/src/features/player/setup.test.ts +12 -3
  1091. package/src/features/player/setup.ts +122 -63
  1092. package/src/features/player/validateOptions.ts +3 -4
  1093. package/src/features/queue/activeTrack.ts +14 -4
  1094. package/src/features/queue/queue.ts +56 -21
  1095. package/src/features/queue/repeatMode.ts +1 -1
  1096. package/src/features/queue/shuffle.ts +0 -1
  1097. package/src/features/remoteControls.ts +59 -35
  1098. package/src/features/sleepTimer.test.ts +171 -0
  1099. package/src/features/sleepTimer.ts +24 -8
  1100. package/src/nitro-stub-drift.test.ts +277 -0
  1101. package/src/public-surface.test.ts +56 -25
  1102. package/src/specs/audio-browser.nitro.ts +15 -8
  1103. package/src/style-resolution.test.ts +210 -0
  1104. package/src/test-utils/reactNativeStub.ts +60 -0
  1105. package/src/types/browser-native.ts +7 -3
  1106. package/src/types/browser-nodes.ts +417 -151
  1107. package/src/types/browser.ts +248 -177
  1108. package/src/utils/LazyNativeEmitter.ts +17 -10
  1109. package/src/utils/NativeUpdatedValue.ts +30 -16
  1110. package/src/utils/getTrackIdentity.ts +22 -0
  1111. package/src/utils/useDebug.test.ts +182 -0
  1112. package/src/utils/useDebug.ts +16 -3
  1113. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1114. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1115. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1116. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1117. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1118. package/src/web/NativeAudioBrowser.ts +247 -92
  1119. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1120. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1121. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1122. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1123. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1124. package/src/web/TrackPlayer/Player.ts +286 -38
  1125. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1126. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1127. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1128. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1129. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1130. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1131. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1132. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1133. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1134. package/src/web/__tests__/retry.test.ts +169 -0
  1135. package/src/web/browser/BrowserManager.ts +209 -111
  1136. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1137. package/src/web/browser/FavoriteManager.ts +28 -23
  1138. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1139. package/src/web/browser/SearchManager.test.ts +75 -0
  1140. package/src/web/browser/SearchManager.ts +25 -28
  1141. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1142. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1143. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1144. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1145. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1146. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1147. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1148. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1149. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1150. package/src/web/browser/parseSearchResponse.ts +3 -4
  1151. package/src/web/browser/sections.test.ts +91 -0
  1152. package/src/web/browser/sections.ts +72 -0
  1153. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1154. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1155. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1156. package/src/web/http/followMediaRedirect.ts +253 -0
  1157. package/src/web/player/NowPlayingManager.ts +4 -3
  1158. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1159. package/src/web/util/BrowserPathHelper.ts +68 -13
  1160. package/website/guide/android-auto.md +126 -0
  1161. package/website/guide/android-certificates.md +488 -0
  1162. package/website/guide/artwork.md +300 -0
  1163. package/website/guide/audio-output.md +357 -0
  1164. package/website/guide/automotive.md +91 -0
  1165. package/website/guide/basic-usage.md +154 -0
  1166. package/website/guide/battery.md +142 -0
  1167. package/website/guide/browser.md +674 -0
  1168. package/website/guide/carplay.md +733 -0
  1169. package/website/guide/configuration.md +215 -0
  1170. package/website/guide/equalizer.md +235 -0
  1171. package/website/guide/errors.md +355 -0
  1172. package/website/guide/favorites.md +164 -0
  1173. package/website/guide/gate.md +157 -0
  1174. package/website/guide/getting-started.md +99 -0
  1175. package/website/guide/hooks.md +247 -0
  1176. package/website/guide/live-streams.md +156 -0
  1177. package/website/guide/metadata.md +289 -0
  1178. package/website/guide/migrating-from-track-player.md +289 -0
  1179. package/website/guide/native-callback-fetch.md +137 -0
  1180. package/website/guide/network.md +102 -0
  1181. package/website/guide/now-playing.md +203 -0
  1182. package/website/guide/playback.md +405 -0
  1183. package/website/guide/queue.md +334 -0
  1184. package/website/guide/remote-controls.md +314 -0
  1185. package/website/guide/search.md +270 -0
  1186. package/website/guide/sleep-timer.md +289 -0
  1187. package/website/guide/track.md +271 -0
  1188. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -68
  1189. package/ios/Bridge.h +0 -8
  1190. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1191. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1192. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1193. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1194. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1195. package/ios/Model/MediaURL.swift +0 -67
  1196. package/ios/Model/SourceType.swift +0 -6
  1197. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1198. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1199. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1200. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1201. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1202. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1203. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1204. package/ios/Option/PitchAlgorithms.swift +0 -17
  1205. package/ios/Option/TimeEventFrequency.swift +0 -18
  1206. package/ios/Player/EndOfTrackJudgement.swift +0 -32
  1207. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1208. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1209. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1210. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1211. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1212. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1213. package/ios/Player/PlaybackStateStore.swift +0 -27
  1214. package/ios/Player/PlayingStateManager.swift +0 -33
  1215. package/ios/Player/RetryManager.swift +0 -323
  1216. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1217. package/ios/Player/SleepTimerHandling.swift +0 -15
  1218. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1219. package/ios/Tests/EndOfTrackJudgementTests.swift +0 -35
  1220. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -327
  1221. package/ios/Tests/MediaResolveTests.swift +0 -126
  1222. package/ios/Tests/OnceValueTests.swift +0 -79
  1223. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1224. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1225. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1226. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1227. package/ios/Tests/RemoteCommandTests.swift +0 -67
  1228. package/ios/Tests/RetryManagerTests.swift +0 -89
  1229. package/ios/TrackPlayer.swift +0 -1014
  1230. package/ios/TrackPlayerCallbacks.swift +0 -53
  1231. package/ios/Util/MetadataAdapter.swift +0 -131
  1232. package/ios/Util/OnceValue.swift +0 -104
  1233. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1234. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1235. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1236. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1237. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1238. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1239. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1240. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1241. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1242. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1243. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1244. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1245. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1246. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -6,8 +6,9 @@ import android.os.Handler
6
6
  import android.os.Looper
7
7
  import androidx.core.net.toUri
8
8
  import androidx.media3.common.C
9
- import androidx.media3.common.HeartRating
9
+ import androidx.media3.common.MediaItem
10
10
  import androidx.media3.common.MediaMetadata
11
+ import androidx.media3.common.Player as MediaPlayer
11
12
  import androidx.media3.database.StandaloneDatabaseProvider
12
13
  import androidx.media3.datasource.cache.LeastRecentlyUsedCacheEvictor
13
14
  import androidx.media3.datasource.cache.SimpleCache
@@ -18,15 +19,29 @@ import com.audiobrowser.AudioBrowser
18
19
  import com.audiobrowser.Callbacks
19
20
  import com.audiobrowser.browser.displayArtworkSource
20
21
  import com.audiobrowser.browser.resolveArtworkUrl
22
+ import com.audiobrowser.browser.resolveMediaUrl
21
23
  import com.audiobrowser.browser.unattributedArtworkSource
24
+ import com.audiobrowser.cast.createCastRemote
22
25
  import com.audiobrowser.extension.NumberExt.Companion.toSeconds
26
+ import com.audiobrowser.extension.identity
23
27
  import com.audiobrowser.model.PlayerSetupOptions
24
28
  import com.audiobrowser.model.PlayerUpdateOptions
29
+ import com.audiobrowser.remote.RemoteOutputsController
30
+ import com.audiobrowser.remote.RemotePlayback
31
+ import com.audiobrowser.remote.RemoteUrls
32
+ import com.audiobrowser.sonos.SonosRemote
33
+ import com.audiobrowser.util.ArtworkRoutes
34
+ import com.audiobrowser.util.ArtworkUris
35
+ import com.audiobrowser.util.Automotive
25
36
  import com.audiobrowser.util.CoilBitmapLoader
26
37
  import com.audiobrowser.util.NetworkConnectivityMonitor
27
38
  import com.audiobrowser.util.PlayingStateFactory
28
39
  import com.audiobrowser.util.RepeatModeFactory
40
+ import com.audiobrowser.util.SvgArtworkRenderer
29
41
  import com.audiobrowser.util.TrackFactory
42
+ import com.audiobrowser.util.TrackFactory.setFavorite
43
+ import com.audiobrowser.util.awaitOrTimeout
44
+ import com.audiobrowser.util.isAutomotive
30
45
  import com.margelo.nitro.audiobrowser.AppKilledPlaybackBehavior
31
46
  import com.margelo.nitro.audiobrowser.FavoriteChangedEvent
32
47
  import com.margelo.nitro.audiobrowser.GateEvent
@@ -36,7 +51,6 @@ import com.margelo.nitro.audiobrowser.ImageSource
36
51
  import com.margelo.nitro.audiobrowser.NativeGateRequest
37
52
  import com.margelo.nitro.audiobrowser.NowPlayingMetadata
38
53
  import com.margelo.nitro.audiobrowser.Playback
39
- import com.margelo.nitro.audiobrowser.PlaybackActiveTrackChangedEvent
40
54
  import com.margelo.nitro.audiobrowser.PlaybackError
41
55
  import com.margelo.nitro.audiobrowser.PlaybackPlayWhenReadyChangedEvent
42
56
  import com.margelo.nitro.audiobrowser.PlaybackProgressUpdatedEvent
@@ -51,15 +65,25 @@ import java.io.IOException
51
65
  import java.util.concurrent.TimeUnit
52
66
  import kotlin.time.Duration.Companion.seconds
53
67
  import kotlinx.coroutines.CompletableDeferred
68
+ import kotlinx.coroutines.CoroutineScope
54
69
  import kotlinx.coroutines.Dispatchers
55
70
  import kotlinx.coroutines.MainScope
56
71
  import kotlinx.coroutines.TimeoutCancellationException
72
+ import kotlinx.coroutines.currentCoroutineContext
73
+ import kotlinx.coroutines.ensureActive
57
74
  import kotlinx.coroutines.withContext
58
75
  import kotlinx.coroutines.withTimeout
59
76
  import timber.log.Timber
60
77
 
61
78
  @SuppressLint("RestrictedApi")
62
- class Player(internal val context: Context) {
79
+ class Player
80
+ internal constructor(
81
+ internal val context: Context,
82
+ castRemote: (Context, String?) -> RemotePlayback?,
83
+ sonosRemote: (Context, CoroutineScope) -> RemotePlayback,
84
+ ) {
85
+ constructor(context: Context) : this(context, ::createCastRemote, ::SonosRemote)
86
+
63
87
  val appKilledPlaybackBehavior: AppKilledPlaybackBehavior
64
88
  get() = options.appKilledPlaybackBehavior
65
89
 
@@ -72,7 +96,9 @@ class Player(internal val context: Context) {
72
96
  EqualizerController(onSettingsChanged = { settings -> callbacks?.onEqualizerChanged(settings) })
73
97
  private val mediaSessionCallback = MediaSessionCallback(this)
74
98
  internal val playbackStateStore = PlaybackStateStore(this)
75
- internal val volumeFader = VolumeFader(getVolume = { volume }, setVolume = { volume = it })
99
+ // Fades the local engine only: a remote receiver keeps its own volume.
100
+ internal val volumeFader =
101
+ VolumeFader(getVolume = { exoPlayer.volume }, setVolume = { exoPlayer.volume = it })
76
102
  internal val sleepTimer =
77
103
  SleepTimerManager(
78
104
  volumeFader,
@@ -80,27 +106,43 @@ class Player(internal val context: Context) {
80
106
  onChanged = { callbacks?.onSleepTimerChanged(it) },
81
107
  )
82
108
 
83
- lateinit var exoPlayer: ExoPlayer
84
- lateinit var forwardingPlayer: androidx.media3.common.Player
85
- /** Thread-safe cache of playWhenReady for access from non-main threads (e.g., retry policy) */
86
- @Volatile internal var playWhenReadyCache = false
109
+ /** The local engine. Rebuilt when the engine options change. */
110
+ internal lateinit var exoPlayer: ExoPlayer
111
+ private set
112
+
113
+ /**
114
+ * What plays: [exoPlayer], or while a remote output is on, the remote-switching player around it.
115
+ * Every playback read and command goes here. Local-only work that would disturb a remote (retry,
116
+ * reconnect, stuck recovery, the shuffle order) goes through [localEngine]; the equalizer,
117
+ * skip-silence, buffering and the volume fade act on [exoPlayer] alone.
118
+ */
119
+ lateinit var sessionPlayer: MediaPlayer
120
+ private set
121
+
122
+ /** [sessionPlayer] behind the remote-command seam: what the MediaSession wraps. */
123
+ internal lateinit var forwardingPlayer: InterceptingPlayer
124
+
125
+ private val remoteOutputs =
126
+ RemoteOutputsController(context, ::resolveRemoteUrls, castRemote, sonosRemote)
127
+
128
+ internal val localEngine =
129
+ LocalEngine({ exoPlayer }, isRemote = { remoteOutputs.player?.isRemote == true })
130
+
131
+ private var keepSessionAliveOnError = true
87
132
 
88
133
  /**
89
- * Whether the current load has ever produced audio — selects between the retry policy's
90
- * first-connect and recovery budgets. Volatile: read from ExoPlayer's loader thread. Set when
91
- * playback starts, cleared on media-item transition (a new load starts unproven); retry reloads
92
- * of the same load keep it.
134
+ * Whether the current load has produced audio: picks the retry policy's first-connect or recovery
135
+ * budget. Read on ExoPlayer's loader thread. Cleared on a media-item transition; retry reloads of
136
+ * the same load keep it.
93
137
  */
94
138
  @Volatile internal var hasPlayedCache = false
95
139
 
96
- /** Last playWhenReady value emitted to JS — see [emitPlayWhenReadyChanged]. */
97
140
  private var lastEmittedPlayWhenReady: Boolean? = null
98
141
 
99
142
  /**
100
- * Emits the playWhenReady change to JS exactly once per value. Two producers exist: the
101
- * synchronous clear at ENDED in [setPlaybackState] (ordered before the state / queue-ended
102
- * callbacks, matching iOS) and the async media3 listener (authoritative for changes ExoPlayer
103
- * makes on its own, e.g. audio focus); the guard deduplicates their overlap.
143
+ * Emits a playWhenReady change to JS once per value. Both the synchronous clear at ENDED in
144
+ * [setPlaybackState] and the media3 listener (changes ExoPlayer makes itself, e.g. audio focus)
145
+ * call it; their overlap is dropped.
104
146
  */
105
147
  internal fun emitPlayWhenReadyChanged(value: Boolean) {
106
148
  if (lastEmittedPlayWhenReady == value) return
@@ -112,42 +154,45 @@ class Player(internal val context: Context) {
112
154
  private lateinit var loadControl: DynamicLoadControl
113
155
  private var automaticBufferManager: AutomaticBufferManager? = null
114
156
 
115
- /**
116
- * Tracks whether a network-related retry is pending. When true, network restoration will trigger
117
- * an immediate retry via exoPlayer.prepare().
118
- */
119
- @Volatile private var pendingNetworkRetry = false
120
-
121
- private var browserRegistered = CompletableDeferred<AudioBrowser>()
157
+ @Volatile private var browserRegistered = CompletableDeferred<AudioBrowser>()
122
158
  private var _coilBitmapLoader: CoilBitmapLoader? = null
123
159
 
160
+ /** For SVG pre-rendering of Android Auto browse items. Set by the service. */
161
+ var imageLoader: coil3.ImageLoader? = null
162
+
124
163
  /**
125
- * Coil ImageLoader for SVG pre-rendering in Android Auto browse items. Set by Service after
126
- * creation.
164
+ * Called on the main thread when a resumption meant to start playback fails. Set by the service.
127
165
  */
128
- var imageLoader: coil3.ImageLoader? = null
166
+ var onPlaybackResumptionFailed: () -> Unit = {}
129
167
 
130
- /** Registry that maps content:// tokens to artwork URLs for the browse content provider. */
168
+ /** Maps the browse content provider's content:// tokens to artwork URLs. */
131
169
  val browseArtworkRegistry = com.audiobrowser.browser.BrowseArtworkRegistry()
132
170
 
133
- /**
134
- * Set the CoilBitmapLoader for display-time bitmap loading. Called from Service after creation.
135
- */
171
+ init {
172
+ Automotive.device = context.isAutomotive
173
+ TrackFactory.favoriteEnabled = options.capabilities.favoriteEnabled
174
+ TrackFactory.artworkRoutes =
175
+ ArtworkRoutes(browseArtworkRegistry, ArtworkUris.authorityFor(context.packageName))
176
+ }
177
+
136
178
  var coilBitmapLoader: CoilBitmapLoader?
137
179
  get() = _coilBitmapLoader
138
180
  set(value) {
139
181
  _coilBitmapLoader = value
140
182
  }
141
183
 
142
- // NOTE: setting the browser does NOT complete browserRegistered.
143
- // Configuration (routes/tabs) must be set before Android Auto can browse.
144
- // Call notifyBrowserConfigurationReady() after configuration is set.
145
184
  var browser: AudioBrowser? = null
185
+ set(value) {
186
+ // A completed registration is the previous browser's; an open one keeps its waiters.
187
+ if (browserRegistered.isCompleted) {
188
+ browserRegistered = CompletableDeferred()
189
+ }
190
+ field = value
191
+ }
146
192
 
147
193
  /**
148
- * Notifies that the browser configuration is ready (routes/tabs are configured). This should be
149
- * called after setting the browser AND its configuration. Only then will Android Auto be able to
150
- * browse content.
194
+ * Marks the browser's routes and tabs configured: completes [awaitBrowser] and lets Android Auto
195
+ * browse. Call after setting [browser] and its configuration.
151
196
  */
152
197
  fun notifyBrowserConfigurationReady() {
153
198
  val audioBrowser = browser ?: return
@@ -155,15 +200,13 @@ class Player(internal val context: Context) {
155
200
  if (!browserRegistered.isCompleted) {
156
201
  Timber.d("Browser configuration ready - completing deferred")
157
202
  browserRegistered.complete(audioBrowser)
158
- // Notify any subscribed controllers that content is now available
159
- // This handles the cold-start case where AA subscribed before browser was ready
203
+ // Android Auto may have subscribed on a cold start before the browser was ready.
160
204
  mediaSessionCallback.notifyBrowserReady()
161
205
  }
162
206
 
163
- // Update MediaSession commands when browser becomes available with search configured
164
- // Only update if search is available, since default state is "no search"
165
207
  if (::mediaSession.isInitialized) {
166
208
  val searchAvailable = audioBrowser.browserManager.config.hasSearch
209
+ // The session starts without search, so only a configured search needs an update.
167
210
  if (searchAvailable) {
168
211
  mediaSessionCallback.updateMediaSession(
169
212
  mediaSession,
@@ -178,25 +221,25 @@ class Player(internal val context: Context) {
178
221
  }
179
222
 
180
223
  /**
181
- * Suspends until the browser is registered, with a timeout.
224
+ * The browser [notifyBrowserConfigurationReady] registered, waiting for it if none is.
182
225
  *
183
- * @throws TimeoutCancellationException if browser is not registered within timeout
226
+ * @throws TimeoutCancellationException if it is not registered within 10 seconds
184
227
  */
185
228
  suspend fun awaitBrowser(): AudioBrowser =
186
- browser
187
- ?: try {
188
- withTimeout(10.seconds) {
189
- Timber.d("Waiting for browser registration...")
190
- browserRegistered.await()
191
- }
192
- } catch (e: TimeoutCancellationException) {
193
- Timber.e("Timed out waiting for browser registration (10s)")
194
- throw e
195
- }
229
+ try {
230
+ withTimeout(10.seconds) { browserRegistered.await() }
231
+ } catch (e: TimeoutCancellationException) {
232
+ Timber.e("Timed out waiting for browser registration (10s)")
233
+ throw e
234
+ }
235
+
236
+ internal lateinit var playerListener: PlayerListener
237
+ private set
196
238
 
197
- private lateinit var playerListener: PlayerListener
198
239
  private var cache: SimpleCache? = null
199
240
 
241
+ private var destroyed = false
242
+
200
243
  private val progressTimer: PlaybackTimer by lazy {
201
244
  PlaybackTimer(
202
245
  isActive = {
@@ -223,7 +266,7 @@ class Player(internal val context: Context) {
223
266
  private set
224
267
 
225
268
  val currentTrack: Track?
226
- get() = exoPlayer.currentMediaItem?.let { TrackFactory.fromMedia3(it) }
269
+ get() = sessionPlayer.currentMediaItem?.let { TrackFactory.fromMedia3(it) }
227
270
 
228
271
  internal var lastTrack: Track? = null
229
272
  internal var lastIndex: Int? = null
@@ -243,13 +286,11 @@ class Player(internal val context: Context) {
243
286
  }
244
287
 
245
288
  /**
246
- * Re-derives [playingState] from the current `playWhenReady` + [playbackState] and emits
247
- * `onPlaybackPlayingState` when it changed. The only writer of [playingState] — called from the
248
- * state machine ([setPlaybackState]) and from [PlayerListener.onPlayWhenReadyChanged], the change
249
- * points of its two inputs.
289
+ * Re-derives [playingState] from [shouldPlayWhenReady] and [playbackState], emitting when it
290
+ * changed. Its only writer: call it wherever either input changes.
250
291
  */
251
292
  internal fun refreshPlayingState() {
252
- val newPlayingState = PlayingStateFactory.derive(playWhenReady, playbackState)
293
+ val newPlayingState = PlayingStateFactory.derive(shouldPlayWhenReady, playbackState)
253
294
  if (newPlayingState == playingState) return
254
295
  Timber.d(
255
296
  "PlayingState changed: playing=${newPlayingState.playing}, buffering=${newPlayingState.buffering}"
@@ -259,106 +300,114 @@ class Player(internal val context: Context) {
259
300
  }
260
301
 
261
302
  var playWhenReady: Boolean
262
- get() = exoPlayer.playWhenReady
303
+ get() = sessionPlayer.playWhenReady
263
304
  set(value) {
264
- // Raising the intent at STATE_ENDED must replay, not silently no-op:
265
- // ExoPlayer's setPlayWhenReady(true) never restarts an ended player (the
266
- // ENDED→seekToDefaultPosition replay lives in media3's media-button
267
- // path, not the Player API). In the setter so every writer gets it —
268
- // play(), togglePlayback() and JS setPlayWhenReady alike.
269
- if (value && exoPlayer.playbackState == ExoPlayer.STATE_ENDED) {
270
- exoPlayer.seekToDefaultPosition()
305
+ // ExoPlayer's setPlayWhenReady(true) neither restarts an ended engine (media3 replays only on
306
+ // its media-button path) nor loads an idle one. Here in the setter so every writer plays
307
+ // alike: play(), togglePlayback(), JS, the session.
308
+ if (value && sessionPlayer.playbackState == MediaPlayer.STATE_ENDED) {
309
+ sessionPlayer.seekToDefaultPosition()
271
310
  }
272
- playWhenReadyCache = value
273
- exoPlayer.playWhenReady = value
311
+ sessionPlayer.playWhenReady = value
312
+ // No-op unless the engine is idle, so this reconnects only after a stop, an error, a
313
+ // cancelled retry or a rebuild, and never re-buffers a healthy stream. Reconnecting is also
314
+ // how a live stream rejoins its live edge.
315
+ if (value && currentTrack != null) sessionPlayer.prepare()
274
316
  }
275
317
 
318
+ /**
319
+ * The intent a setup carries, raised without loading: a setup repeats, as on a JS reload, and
320
+ * would otherwise start a stopped or failed queue. A play loads.
321
+ */
322
+ internal fun applySetupPlayWhenReady(value: Boolean) {
323
+ sessionPlayer.playWhenReady = value
324
+ }
325
+
276
326
  val duration: Long
277
- get() = if (exoPlayer.duration == C.TIME_UNSET) 0 else exoPlayer.duration
327
+ get() = if (sessionPlayer.duration == C.TIME_UNSET) 0 else sessionPlayer.duration
278
328
 
279
329
  internal var oldPosition = 0L
280
330
 
281
331
  val position: Long
282
332
  get() =
283
- if (exoPlayer.currentPosition == C.INDEX_UNSET.toLong()) 0 else exoPlayer.currentPosition
333
+ if (sessionPlayer.currentPosition == C.INDEX_UNSET.toLong()) 0
334
+ else sessionPlayer.currentPosition
284
335
 
285
336
  val bufferedPosition: Long
286
337
  get() =
287
- if (exoPlayer.bufferedPosition == C.INDEX_UNSET.toLong()) 0 else exoPlayer.bufferedPosition
338
+ if (sessionPlayer.bufferedPosition == C.INDEX_UNSET.toLong()) 0
339
+ else sessionPlayer.bufferedPosition
288
340
 
341
+ /** From 0 to 1: the local engine's, or while remote, the receiver's. */
289
342
  var volume: Float
290
- get() = exoPlayer.volume
343
+ get() = sessionPlayer.volume
291
344
  set(value) {
292
- exoPlayer.volume = value
345
+ sessionPlayer.volume = value
293
346
  }
294
347
 
295
348
  var playbackSpeed: Float
296
- get() = exoPlayer.playbackParameters.speed
349
+ get() = sessionPlayer.playbackParameters.speed
297
350
  set(value) {
298
- exoPlayer.setPlaybackSpeed(value)
351
+ sessionPlayer.setPlaybackSpeed(value)
299
352
  }
300
353
 
301
354
  val isPlaying
302
- get() = exoPlayer.isPlaying
355
+ get() = sessionPlayer.isPlaying
356
+
357
+ /**
358
+ * False while ExoPlayer suppresses output (a transient audio focus loss) though [playWhenReady]
359
+ * stays raised to resume on; mirrors media3's `ExoPlayerImplInternal.shouldPlayWhenReady`.
360
+ */
361
+ internal val shouldPlayWhenReady
362
+ get() =
363
+ sessionPlayer.playWhenReady &&
364
+ sessionPlayer.playbackSuppressionReason == MediaPlayer.PLAYBACK_SUPPRESSION_REASON_NONE
303
365
 
304
366
  var repeatMode: RepeatMode
305
- get() = RepeatModeFactory.fromMedia3(exoPlayer.repeatMode)
367
+ get() = RepeatModeFactory.fromMedia3(sessionPlayer.repeatMode)
306
368
  internal set(value) {
307
- exoPlayer.repeatMode = RepeatModeFactory.toMedia3(value)
369
+ sessionPlayer.repeatMode = RepeatModeFactory.toMedia3(value)
308
370
  }
309
371
 
310
372
  val currentIndex: Int?
311
373
  get() =
312
- if (exoPlayer.currentMediaItemIndex == C.INDEX_UNSET) null
313
- else exoPlayer.currentMediaItemIndex
374
+ if (sessionPlayer.currentMediaItemIndex == C.INDEX_UNSET) null
375
+ else sessionPlayer.currentMediaItemIndex
314
376
 
315
377
  var shuffleMode: Boolean
316
- get() = exoPlayer.shuffleModeEnabled
378
+ get() = sessionPlayer.shuffleModeEnabled
317
379
  set(value) {
318
- exoPlayer.shuffleModeEnabled = value
380
+ sessionPlayer.shuffleModeEnabled = value
319
381
  }
320
382
 
321
383
  val trackCount: Int
322
- get() = exoPlayer.mediaItemCount
384
+ get() = sessionPlayer.mediaItemCount
323
385
 
324
386
  val isEmpty: Boolean
325
- get() = exoPlayer.mediaItemCount == 0
387
+ get() = sessionPlayer.mediaItemCount == 0
326
388
 
327
389
  val tracks: Array<Track>
328
390
  get() =
329
- (0 until exoPlayer.mediaItemCount)
330
- .map { index -> TrackFactory.fromMedia3(exoPlayer.getMediaItemAt(index)) }
391
+ (0 until sessionPlayer.mediaItemCount)
392
+ .map { index -> TrackFactory.fromMedia3(sessionPlayer.getMediaItemAt(index)) }
331
393
  .toTypedArray()
332
394
 
333
- /**
334
- * Whether nothing follows the current item in *playback order* — shuffle- and repeat-aware via
335
- * media3's own order computation (the linear `currentMediaItemIndex == count - 1` check missed a
336
- * shuffled queue whose playback order ends on a different linear index). Matches iOS's
337
- * `isLastInPlaybackOrder`.
338
- */
395
+ /** In playback order, so shuffle and repeat count; not the last linear index. */
339
396
  val isLastInPlaybackOrder: Boolean
340
- get() = exoPlayer.nextMediaItemIndex == C.INDEX_UNSET
397
+ get() = sessionPlayer.nextMediaItemIndex == C.INDEX_UNSET
341
398
 
342
- /**
343
- * The source path from which the current queue was expanded (e.g., from a contextual URL). Used
344
- * to avoid re-expanding the queue when selecting tracks from the same source.
345
- */
399
+ /** The path the queue was expanded from, so selecting from the same source skips re-expanding. */
346
400
  var queueSourcePath: String? = null
347
401
  internal set
348
402
 
349
- /**
350
- * Get track at index with bounds checking.
351
- *
352
- * @param index The index of the track to retrieve.
353
- * @throws IllegalArgumentException if index is out of bounds.
354
- */
403
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
355
404
  fun getTrack(index: Int): Track {
356
- if (index < 0 || index >= exoPlayer.mediaItemCount) {
405
+ if (index < 0 || index >= sessionPlayer.mediaItemCount) {
357
406
  throw IllegalArgumentException(
358
- "Track index $index is out of bounds (size: ${exoPlayer.mediaItemCount})"
407
+ "Track index $index is out of bounds (size: ${sessionPlayer.mediaItemCount})"
359
408
  )
360
409
  }
361
- return TrackFactory.fromMedia3(exoPlayer.getMediaItemAt(index))
410
+ return TrackFactory.fromMedia3(sessionPlayer.getMediaItemAt(index))
362
411
  }
363
412
 
364
413
  var skipSilence: Boolean
@@ -367,20 +416,65 @@ class Player(internal val context: Context) {
367
416
  exoPlayer.skipSilenceEnabled = value
368
417
  }
369
418
 
419
+ private var engineOptions: PlayerSetupOptions? = null
420
+
421
+ private var deferredSetup: PlayerSetupOptions? = null
422
+
370
423
  /**
371
- * Sets up or recreates the ExoPlayer with the provided setup options. This method can be called
372
- * multiple times to change setup options.
424
+ * Builds the ExoPlayer on the first call, and rebuilds it only when the engine options changed. A
425
+ * rebuild carries over the queue, the position and the play intent. During a transient audio
426
+ * focus loss with the intent up, the rebuild waits until focus returns, the intent drops, or a
427
+ * play asks for focus again.
373
428
  */
374
429
  fun setup(setupOptions: PlayerSetupOptions) {
375
- Timber.Forest.d("Setting up player with new options")
376
-
377
430
  nowPlaying.enabled = setupOptions.autoUpdateNowPlayingMetadata
378
- // Wrap the Nitro Func into a plain suspend call so the updater (and its tests) never touch
379
- // bridge types; the double-await depth is unchanged (invoke -> bridge Promise -> JS promise).
431
+ // Unwrapped from the Nitro Func so the updater never touches bridge types.
380
432
  nowPlaying.formatter =
381
- setupOptions.nowPlayingMetadataFormatter?.let { f -> { params -> f.invoke(params).await() } }
433
+ setupOptions.nowPlayingMetadataFormatter?.let { f ->
434
+ { params -> f.invoke(params).awaitOrTimeout() }
435
+ }
382
436
 
383
- val isInitialSetup = !::exoPlayer.isInitialized
437
+ deferredSetup = setupOptions.takeIf { it.engineOptions() != engineOptions }
438
+ rebuildIfDue()
439
+ if (remoteOutputs.apply(setupOptions.remoteOutputs, exoPlayer)) attachSessionPlayer()
440
+ }
441
+
442
+ /**
443
+ * Runs a [deferredSetup] rebuild unless the engine waits out a transient focus loss with the
444
+ * intent up: the new engine would ask for focus at once, taking it from the app that holds it, or
445
+ * lose the intent when refused, as during a call. Call when the engine's state, intent or
446
+ * suppression changes.
447
+ */
448
+ internal fun rebuildIfDue() {
449
+ val options = deferredSetup ?: return
450
+ // A stopped engine keeps the suppression but holds no focus, and is carried unprepared.
451
+ if (
452
+ engineOptions != null &&
453
+ exoPlayer.playbackState != MediaPlayer.STATE_IDLE &&
454
+ exoPlayer.playWhenReady &&
455
+ exoPlayer.playbackSuppressionReason ==
456
+ MediaPlayer.PLAYBACK_SUPPRESSION_REASON_TRANSIENT_AUDIO_FOCUS_LOSS
457
+ ) {
458
+ return
459
+ }
460
+ deferredSetup = null
461
+ buildEngine(options)
462
+ engineOptions = options.engineOptions()
463
+ }
464
+
465
+ /**
466
+ * [rebuildIfDue] once the current command returns: ExoPlayer reports an intent change from inside
467
+ * the command, and a rebuild there would land between its steps, as between stop()'s drop of the
468
+ * intent and its stop.
469
+ */
470
+ internal fun rebuildIfDueLater() {
471
+ if (deferredSetup != null) mainHandler.post(::rebuildIfDue)
472
+ }
473
+
474
+ private fun buildEngine(setupOptions: PlayerSetupOptions) {
475
+ Timber.Forest.d("Setting up player with new options")
476
+ val isInitialSetup = engineOptions == null
477
+ val carried = if (isInitialSetup) null else EnginePlayback.of(exoPlayer)
384
478
 
385
479
  if (!isInitialSetup) {
386
480
  forwardingPlayer.removeListener(playerListener)
@@ -389,15 +483,15 @@ class Player(internal val context: Context) {
389
483
  }
390
484
 
391
485
  if (setupOptions.maxCacheSize > 0) {
392
- // SimpleCache locks its folder — re-setup must release the previous
393
- // instance first or the constructor throws.
486
+ // SimpleCache locks its folder: the constructor throws until the previous one is released.
394
487
  cache?.release()
395
488
  cache =
396
489
  SimpleCache(
397
490
  File(context.cacheDir, "RNAB"),
398
491
  LeastRecentlyUsedCacheEvictor(
492
+ // MB to bytes
399
493
  setupOptions.maxCacheSize.toLong() * 1_000_000
400
- ), // MB to bytes
494
+ ),
401
495
  StandaloneDatabaseProvider(context),
402
496
  )
403
497
  } else {
@@ -405,75 +499,69 @@ class Player(internal val context: Context) {
405
499
  cache = null
406
500
  }
407
501
 
408
- // One engine generation: load control, media factory, ExoPlayer (pure construction —
409
- // see buildPlayerEngine; lifecycle and wiring stay here).
410
502
  val engine =
411
503
  buildPlayerEngine(
412
504
  context,
413
505
  setupOptions,
414
506
  cache,
415
- shouldRetry = { playWhenReadyCache },
416
507
  isOnline = { networkMonitor.getOnline() },
417
508
  hasPlayed = { hasPlayedCache },
418
- onRetryPending = { exception, isNetworkError ->
419
- // Track pending network retries for acceleration when connectivity returns
420
- pendingNetworkRetry = isNetworkError
421
- if (isNetworkError) {
422
- Timber.d("Network retry pending, will accelerate on connectivity restoration")
423
- }
424
- reportRetryingError(exception)
425
- },
426
- resolveMediaConfig = { url -> browser?.getMediaRequestConfig(url) },
509
+ onRetryPending = ::reportRetryingError,
510
+ resolveMediaConfig = { url, track -> browser?.getMediaRequestConfig(url, track) },
427
511
  )
428
512
  loadControl = engine.loadControl
429
513
  mediaFactory = engine.mediaFactory
430
514
  exoPlayer = engine.exoPlayer
515
+ // Before the listener and the session are attached, so neither hears the playback replayed.
516
+ carried?.restoreTo(exoPlayer)
517
+ remoteOutputs.setLocal(exoPlayer)
518
+ keepSessionAliveOnError = setupOptions.keepSessionAliveOnError
431
519
 
432
- // A rebuilt engine starts paused and fires no change event — sync the
433
- // eager cache and tell JS, or the stale true sticks (and the emit dedupe
434
- // would swallow the next real rise).
435
- if (!isInitialSetup) {
436
- playWhenReadyCache = false
437
- emitPlayWhenReadyChanged(false)
520
+ if (isInitialSetup) playerListener = PlayerListener(this)
521
+ attachSessionPlayer()
522
+
523
+ if (isInitialSetup) {
524
+ callbacks?.onPlaybackChanged(Playback(PlaybackState.NONE, null))
525
+ equalizer.initialize(exoPlayer.audioSessionId)
526
+ } else if (localEngine.isActive) {
527
+ // No listener heard the restore. Its prepare() leaves the engine buffering; an unprepared one
528
+ // keeps its state. While remote, the receiver plays on unchanged.
529
+ if (exoPlayer.playbackState != ExoPlayer.STATE_IDLE) setPlaybackState(PlaybackState.BUFFERING)
530
+ // The new engine starts unsuppressed: an unchanged state would not re-derive it.
531
+ refreshPlayingState()
438
532
  }
439
533
 
440
- // Recreate forwarding player with new ExoPlayer
534
+ setupAutomaticBufferManager(setupOptions.automaticBuffer)
535
+ }
536
+
537
+ // Call whenever [exoPlayer] or the remote player changes.
538
+ private fun attachSessionPlayer() {
539
+ if (::forwardingPlayer.isInitialized) forwardingPlayer.removeListener(playerListener)
540
+ sessionPlayer = remoteOutputs.player ?: exoPlayer
441
541
  forwardingPlayer =
442
542
  InterceptingPlayer(
443
- exoPlayer,
543
+ sessionPlayer,
444
544
  { callbacks },
445
545
  { options },
446
- keepSessionAliveOnError = setupOptions.keepSessionAliveOnError,
546
+ keepSessionAliveOnError,
547
+ playerState = { playbackState },
548
+ playPlayer = ::play,
549
+ stopPlayer = ::stop,
447
550
  )
551
+ forwardingPlayer.addListener(playerListener)
552
+ if (::mediaSession.isInitialized) mediaSession.player = forwardingPlayer
553
+ }
448
554
 
449
- if (isInitialSetup) {
450
- // Initial setup - create player listener and emit initial state
451
- playerListener = PlayerListener(this)
452
- forwardingPlayer.addListener(playerListener)
453
- callbacks?.onPlaybackChanged(Playback(PlaybackState.NONE, null))
454
-
455
- // Initialize equalizer with audio session ID
456
- equalizer.initialize(exoPlayer.audioSessionId)
457
- } else {
458
- // Re-setup - re-add listener and update MediaSession
459
- forwardingPlayer.addListener(playerListener)
460
-
461
- // Update MediaSession with new forwardingPlayer reference if MediaSession exists
462
- if (::mediaSession.isInitialized) {
463
- Timber.Forest.d("Updating MediaSession with new forwardingPlayer reference")
464
- mediaSession.player = forwardingPlayer
465
- }
466
-
467
- setPlaybackState(PlaybackState.NONE)
468
- }
469
-
470
- // Set up automatic buffer management if enabled
471
- setupAutomaticBufferManager(setupOptions.automaticBuffer)
555
+ private suspend fun resolveRemoteUrls(track: Track): RemoteUrls {
556
+ val src = checkNotNull(track.src) { "The track has no src" }
557
+ val browserManager = browser?.browserManager
558
+ return RemoteUrls(
559
+ url = browserManager?.resolveMediaUrl(src, track)?.url() ?: src,
560
+ artworkUrl = browserManager?.resolveArtworkUrl(track)?.uri,
561
+ )
472
562
  }
473
563
 
474
- /** Sets up or tears down the automatic buffer manager based on the enabled flag. */
475
564
  private fun setupAutomaticBufferManager(enabled: Boolean) {
476
- // Detach existing manager if any
477
565
  automaticBufferManager?.detach()
478
566
 
479
567
  if (enabled) {
@@ -487,168 +575,89 @@ class Player(internal val context: Context) {
487
575
  }
488
576
  }
489
577
 
490
- /**
491
- * Starts observing network connectivity changes and invokes the callback when state changes. Also
492
- * handles accelerating pending network retries when connectivity is restored.
493
- *
494
- * @param scope The coroutine scope to use for observation
495
- */
496
578
  fun observeNetworkConnectivity(scope: kotlinx.coroutines.CoroutineScope) {
497
579
  networkMonitor.observeOnline(scope) { isOnline ->
498
580
  callbacks?.onOnlineChanged(isOnline)
499
581
 
500
- // Re-render now-playing so the formatter's stall classification (buffering vs offline) tracks
501
- // connectivity immediately, not only on the next playback transition.
582
+ // The formatter tells a stall from being offline, so it renders on a connectivity change too.
502
583
  nowPlaying.render()
503
-
504
- // Accelerate pending network retry when connectivity is restored
505
- if (isOnline && pendingNetworkRetry) {
506
- Timber.d("Network restored with pending retry, triggering immediate retry")
507
- pendingNetworkRetry = false
508
- // Only retry if player is still expecting to play
509
- if (playWhenReadyCache) {
510
- exoPlayer.prepare()
511
- }
512
- }
513
584
  }
514
585
  }
515
586
 
516
- /**
517
- * Loads a track into the player. If there is a current track, it will be replaced. If the queue
518
- * is empty, the track will be added.
519
- *
520
- * @param track The [Track] to load.
521
- */
587
+ /** Replaces the current track, keeping the rest of the queue; on an empty queue, adds it. */
522
588
  fun load(track: Track) {
523
- if (exoPlayer.mediaItemCount == 0) {
589
+ if (sessionPlayer.mediaItemCount == 0) {
524
590
  add(track)
525
591
  } else {
526
- val index = exoPlayer.currentMediaItemIndex
592
+ val index = sessionPlayer.currentMediaItemIndex
527
593
  replaceTrack(index, track)
528
- exoPlayer.seekTo(index, C.TIME_UNSET)
529
- exoPlayer.prepare()
594
+ sessionPlayer.seekTo(index, C.TIME_UNSET)
595
+ sessionPlayer.prepare()
530
596
  }
531
597
  }
532
598
 
533
- /**
534
- * Add a single track to the queue. If the AudioPlayer has no track loaded, it will load the
535
- * `track`.
536
- *
537
- * @param track The [Track] to add.
538
- */
539
- fun add(track: Track) {
540
- val mediaItem = TrackFactory.toMedia3(track)
541
- exoPlayer.addMediaItem(mediaItem)
542
- exoPlayer.prepare()
543
- }
599
+ fun add(track: Track) = add(arrayOf(track))
544
600
 
545
601
  /**
546
- * Add multiple tracks to the queue. If the AudioPlayer has no track loaded, it will load the
547
- * first track in the list.
602
+ * Loads only into an empty queue: a queue that had tracks keeps its current one as it was, idle
603
+ * after a stop or a cancelled retry.
548
604
  *
549
- * @param tracks The [Track]s to add.
605
+ * @throws IllegalArgumentException unless [atIndex] is within the queue, or -1 to append.
550
606
  */
551
- fun add(tracks: Array<Track>) {
552
- val mediaItems = TrackFactory.toMedia3(tracks)
553
- exoPlayer.addMediaItems(mediaItems.toList())
554
- exoPlayer.prepare()
555
- }
556
-
557
- /**
558
- * Add multiple tracks to the queue.
559
- *
560
- * @param tracks The [Track]s to add.
561
- * @param atIndex Index to insert tracks at. Use -1 to append to the end of the queue.
562
- * @throws IllegalArgumentException if index is out of bounds.
563
- */
564
- fun add(tracks: Array<Track>, atIndex: Int) {
607
+ fun add(tracks: Array<Track>, atIndex: Int = -1) {
565
608
  validateInsertIndex(atIndex)
566
- val index = if (atIndex == -1) exoPlayer.mediaItemCount else atIndex
567
- val mediaItems = tracks.map { TrackFactory.toMedia3(it) }
568
- exoPlayer.addMediaItems(index, mediaItems)
569
- exoPlayer.prepare()
570
- }
571
-
572
- /**
573
- * Remove a track from the queue.
574
- *
575
- * @param index The index of the track to remove.
576
- * @throws IllegalArgumentException if index is out of bounds.
577
- */
578
- fun remove(index: Int) {
579
- validateIndex(index)
580
- exoPlayer.removeMediaItem(index)
609
+ val count = sessionPlayer.mediaItemCount
610
+ sessionPlayer.addMediaItems(
611
+ if (atIndex == -1) count else atIndex,
612
+ TrackFactory.toMedia3(tracks),
613
+ )
614
+ if (count == 0) sessionPlayer.prepare()
581
615
  }
582
616
 
583
- /**
584
- * Remove tracks from the queue.
585
- *
586
- * @param indexes The indexes of the tracks to remove.
587
- * @throws IllegalArgumentException if any index is out of bounds or if duplicate indexes are
588
- * provided.
589
- */
617
+ /** @throws IllegalArgumentException if an index is out of bounds or repeated. */
590
618
  fun remove(indexes: List<Int>) {
591
619
  if (indexes.toSet().size != indexes.size) {
592
620
  throw IllegalArgumentException("Duplicate indexes provided")
593
621
  }
594
622
  indexes.forEach { validateIndex(it) }
595
- val sorted = indexes.sortedDescending()
596
- sorted.forEach { exoPlayer.removeMediaItem(it) }
623
+ val removesCurrent = sessionPlayer.currentMediaItemIndex in indexes
624
+ indexes.sortedDescending().forEach { sessionPlayer.removeMediaItem(it) }
625
+ // Loads the new current track on an engine an error left idle; a no-op otherwise.
626
+ if (removesCurrent && playWhenReady) prepare()
597
627
  }
598
628
 
599
- /**
600
- * Skip to the next track in the queue, which may depend on the current repeat mode. Does nothing
601
- * if there is no next track to skip to.
602
- */
603
- fun next() {
604
- exoPlayer.seekToNextMediaItem()
605
- exoPlayer.prepare()
606
- }
629
+ fun next() = loadAfter { sessionPlayer.seekToNextMediaItem() }
630
+
631
+ fun previous() = loadAfter { sessionPlayer.seekToPreviousMediaItem() }
607
632
 
608
633
  /**
609
- * Skip to the previous track in the queue, which may depend on the current repeat mode. Does
610
- * nothing if there is no previous track to skip to.
634
+ * Runs [move] and prepares an idle engine, unless the queue ended and stays where it was: a
635
+ * rebuild carries an ended engine idle, and it stays ended as an ended engine does.
611
636
  */
612
- fun previous() {
613
- exoPlayer.seekToPreviousMediaItem()
614
- exoPlayer.prepare()
637
+ private inline fun loadAfter(move: () -> Unit) {
638
+ val index = sessionPlayer.currentMediaItemIndex
639
+ move()
640
+ if (playbackState == PlaybackState.ENDED && sessionPlayer.currentMediaItemIndex == index) return
641
+ sessionPlayer.prepare()
615
642
  }
616
643
 
617
644
  /**
618
- * Move an track in the queue from one position to another.
645
+ * A [toIndex] past the end moves the track to the end.
619
646
  *
620
- * @param fromIndex The index of the track to move.
621
- * @param toIndex The index to move the track to. If the index is larger than the size of the
622
- * queue, the track is moved to the end of the queue instead.
623
- * @throws IllegalArgumentException if fromIndex is out of bounds.
647
+ * @throws IllegalArgumentException if [fromIndex] is out of bounds.
624
648
  */
625
649
  fun move(fromIndex: Int, toIndex: Int) {
626
650
  validateIndex(fromIndex)
627
- exoPlayer.moveMediaItem(fromIndex, toIndex)
651
+ sessionPlayer.moveMediaItem(fromIndex, toIndex)
628
652
  }
629
653
 
630
- /**
631
- * Skips to a track in the queue.
632
- *
633
- * @param index the index to skip to
634
- * @throws IllegalArgumentException if index is out of bounds.
635
- */
654
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
636
655
  fun skipTo(index: Int) {
637
656
  validateIndex(index)
638
- exoPlayer.seekTo(index, C.TIME_UNSET)
639
- exoPlayer.prepare()
657
+ sessionPlayer.seekTo(index, C.TIME_UNSET)
658
+ sessionPlayer.prepare()
640
659
  }
641
660
 
642
- /**
643
- * Sets the queue with new tracks, optionally starting at a specific index and position. This is
644
- * more efficient than calling clear() + add() + skipTo() separately.
645
- *
646
- * @param tracks The tracks to set as the new queue.
647
- * @param startIndex The index to start playback from (default: 0).
648
- * @param startPositionMs The position in milliseconds to start from (default: 0).
649
- * @param sourcePath Optional path from which this queue was expanded (for contextual URL
650
- * optimization).
651
- */
652
661
  fun setQueue(
653
662
  tracks: Array<Track>,
654
663
  startIndex: Int = 0,
@@ -656,89 +665,58 @@ class Player(internal val context: Context) {
656
665
  sourcePath: String? = null,
657
666
  ) {
658
667
  val mediaItems = TrackFactory.toMedia3(tracks).toMutableList()
659
- exoPlayer.setMediaItems(mediaItems, startIndex, startPositionMs)
668
+ sessionPlayer.setMediaItems(mediaItems, startIndex, startPositionMs)
669
+ // While remote, the queue plays in list order.
670
+ if (mediaItems.isNotEmpty()) {
671
+ localEngine.setShuffleOrder(shuffleOrderLedBy(startIndex, mediaItems.size))
672
+ }
660
673
  queueSourcePath = sourcePath
661
- exoPlayer.prepare()
674
+ sessionPlayer.prepare()
662
675
  }
663
676
 
664
- /**
665
- * Replaces track at index in queue.
666
- *
667
- * @throws IllegalArgumentException if index is out of bounds.
668
- */
677
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
669
678
  fun replaceTrack(index: Int, track: Track) {
670
679
  validateIndex(index)
671
- exoPlayer.replaceMediaItem(index, TrackFactory.toMedia3(track))
680
+ val isCurrent = index == currentIndex
681
+ if (isCurrent) nowPlaying.forgetPublished()
682
+ sessionPlayer.replaceMediaItem(index, TrackFactory.toMedia3(track))
683
+ if (isCurrent) nowPlaying.render()
672
684
  }
673
685
 
674
686
  /**
675
- * Sets the favorited state of the currently playing track. Updates the heart icon in media
676
- * controllers without interrupting playback.
687
+ * @return false only when there is no current track, so MediaSession callers can report an
688
+ * invalid state instead of a success the controller then watches revert.
677
689
  */
678
- fun setActiveTrackFavorited(favorited: Boolean) {
679
- val currentTrack = this.currentTrack ?: return
690
+ fun setActiveTrackFavorited(favorited: Boolean): Boolean {
691
+ val currentTrack = this.currentTrack ?: return false
680
692
 
681
- // Persist to the native favorites cache regardless of player state — the
682
- // user's gesture is durable even when there's no active media item to
683
- // update (queue tear-down, between-track gaps, etc.).
684
- currentTrack.src?.let { src -> browser?.browserManager?.updateFavorite(src, favorited) }
693
+ currentTrack.identity?.let { identity ->
694
+ browser?.browserManager?.updateFavorite(identity, favorited)
695
+ }
685
696
 
686
- val index = exoPlayer.currentMediaItemIndex
687
- if (index == C.INDEX_UNSET) return
697
+ val index = sessionPlayer.currentMediaItemIndex
698
+ // Still applied: the favorite is persisted above, and there is no heart to revert.
699
+ if (index == C.INDEX_UNSET) return true
688
700
 
689
- // Create updated Track with new favorited state
690
701
  val updatedTrack = currentTrack.copy(favorited = favorited)
702
+ restampMediaItem(index, updatedTrack) { setFavorite(favorited) }
691
703
 
692
- // Use buildUpon() on the existing MediaItem to update only the metadata
693
- // This preserves internal references and avoids playback interruption
694
- // Note: setTag() requires setUri() to be called, so we must re-set the URI
695
- val currentMediaItem = exoPlayer.getMediaItemAt(index)
696
- val updatedMetadata =
697
- currentMediaItem.mediaMetadata.buildUpon().setUserRating(HeartRating(favorited)).build()
698
- val updatedMediaItem =
699
- currentMediaItem
700
- .buildUpon()
701
- .setUri(currentMediaItem.localConfiguration?.uri)
702
- .setMediaMetadata(updatedMetadata)
703
- .setTag(updatedTrack)
704
- .build()
705
-
706
- exoPlayer.replaceMediaItem(index, updatedMediaItem)
707
-
708
- // Update the heart button icon in notification/Android Auto
709
704
  updateFavoriteButtonState(favorited)
710
705
 
711
- // Notify JS of the favorite state change
706
+ // The only emit: a favorite toggle mutates the active track in place, so the track and queue
707
+ // change events stay transition-only.
712
708
  callbacks?.onFavoriteChanged(FavoriteChangedEvent(updatedTrack, favorited))
713
-
714
- // Emit active track changed so useActiveTrack() hook updates
715
- val activeTrackEvent =
716
- PlaybackActiveTrackChangedEvent(
717
- lastIndex = index.toDouble(),
718
- lastTrack = currentTrack,
719
- lastPosition = exoPlayer.currentPosition.toSeconds(),
720
- index = index.toDouble(),
721
- track = updatedTrack,
722
- )
723
- callbacks?.onPlaybackActiveTrackChanged(activeTrackEvent)
724
-
725
- // Emit queue changed so useQueue() hook updates
726
- callbacks?.onPlaybackQueueChanged(tracks)
709
+ return true
727
710
  }
728
711
 
729
- /** Toggles the favorited state of the currently playing track. */
730
- fun toggleActiveTrackFavorited() {
731
- val currentTrack = this.currentTrack ?: return
732
- setActiveTrackFavorited(currentTrack.favorited != true)
712
+ fun toggleActiveTrackFavorited(): Boolean {
713
+ val currentTrack = this.currentTrack ?: return false
714
+ return setActiveTrackFavorited(currentTrack.favorited != true)
733
715
  }
734
716
 
735
717
  // MARK: - Now Playing Metadata
736
718
 
737
- /**
738
- * Now Playing rendering (flash/override/formatter precedence, dedupe, stale guards, artwork
739
- * keying) lives in [NowPlayingUpdater]; this object is its platform surface — current playback
740
- * reads plus MediaItem stamping via [replaceMediaItem], and artwork resolution via the browser.
741
- */
719
+ /** [NowPlayingUpdater] does the rendering; this is its platform surface. */
742
720
  val nowPlaying: NowPlayingUpdater =
743
721
  NowPlayingUpdater(
744
722
  object : NowPlayingSurface {
@@ -755,7 +733,7 @@ class Player(internal val context: Context) {
755
733
  get() = this@Player.playbackError
756
734
 
757
735
  override val playWhenReady
758
- get() = exoPlayer.playWhenReady
736
+ get() = shouldPlayWhenReady
759
737
 
760
738
  override val isRebuffering
761
739
  get() = loadControl.isRebuffering
@@ -777,9 +755,8 @@ class Player(internal val context: Context) {
777
755
  setTitle(title)
778
756
  .setDisplayTitle(title)
779
757
  .setArtist(secondaryLine)
780
- // Android Auto reads DISPLAY_SUBTITLE (not ARTIST) once DISPLAY_TITLE is set, so
781
- // mirror the line into `subtitle`; `artist` still drives the lock screen /
782
- // notification.
758
+ // Android Auto reads DISPLAY_SUBTITLE, not ARTIST, once DISPLAY_TITLE is set;
759
+ // `artist` still drives the lock screen and notification.
783
760
  .setSubtitle(secondaryLine)
784
761
  .setAlbumTitle(album)
785
762
  }
@@ -798,11 +775,12 @@ class Player(internal val context: Context) {
798
775
  null
799
776
  }
800
777
  val uri = resolved?.uri?.takeIf { it.isNotEmpty() } ?: return null
801
- // Remember how this URI was produced: Media3 hands it back to the bitmap loader, which
802
- // re-resolves Track-first (with the nowPlayingArtwork kind, not the global artwork
803
- // config).
804
- browserManager.artworkResolutions.register(uri, track, config)
805
- return uri
778
+ val published =
779
+ TrackFactory.sessionArtworkUri(uri, resolved.headers, SvgArtworkRenderer.isSvgUrl(uri))
780
+ // Media3 hands this URI back to the bitmap loader, which re-resolves it with the
781
+ // nowPlayingArtwork config rather than the global artwork config.
782
+ browserManager.artworkResolutions.register(published, track, config)
783
+ return published
806
784
  }
807
785
 
808
786
  override fun emitNowPlayingChanged(metadata: NowPlayingMetadata) {
@@ -812,32 +790,47 @@ class Player(internal val context: Context) {
812
790
  MainScope(),
813
791
  )
814
792
 
815
- /** Republishes the item at [index] with mutated metadata, preserving uri and Track tag. */
793
+ /**
794
+ * One replacement for the whole queue: each separate one is a timeline change and a queue event
795
+ * to JS.
796
+ */
797
+ private fun restampFavorites() {
798
+ if (!::sessionPlayer.isInitialized || sessionPlayer.mediaItemCount == 0) return
799
+ val items =
800
+ (0 until sessionPlayer.mediaItemCount).map { index ->
801
+ val item = sessionPlayer.getMediaItemAt(index)
802
+ val track = item.localConfiguration?.tag as? Track ?: return@map item
803
+ item.restamped(track) { setFavorite(track.favorited) }
804
+ }
805
+ sessionPlayer.replaceMediaItems(0, items.size, items)
806
+ }
807
+
816
808
  private fun restampMediaItem(
817
809
  index: Int,
818
810
  track: Track,
819
811
  mutate: MediaMetadata.Builder.() -> MediaMetadata.Builder,
820
812
  ) {
821
- val currentMediaItem = exoPlayer.getMediaItemAt(index)
822
- val updatedMediaItem =
823
- currentMediaItem
824
- .buildUpon()
825
- .setUri(currentMediaItem.localConfiguration?.uri)
826
- .setMediaMetadata(currentMediaItem.mediaMetadata.buildUpon().mutate().build())
827
- .setTag(track)
828
- .build()
829
- exoPlayer.replaceMediaItem(index, updatedMediaItem)
813
+ sessionPlayer.replaceMediaItem(
814
+ index,
815
+ sessionPlayer.getMediaItemAt(index).restamped(track, mutate),
816
+ )
830
817
  }
831
818
 
819
+ /** Keeps the uri so ExoPlayer updates the item in place instead of reloading it. */
820
+ private fun MediaItem.restamped(
821
+ track: Track,
822
+ mutate: MediaMetadata.Builder.() -> MediaMetadata.Builder,
823
+ ): MediaItem =
824
+ buildUpon()
825
+ .setUri(localConfiguration?.uri)
826
+ .setMediaMetadata(mediaMetadata.buildUpon().mutate().build())
827
+ .setTag(track)
828
+ .build()
829
+
832
830
  /**
833
- * Resets the retry timer when track changes. Called from PlayerListener.onMediaItemTransition.
834
- */
835
- /**
836
- * A restart from a terminal error begins a new load of the same track: fresh retry budgets and
837
- * unproven playback, so the user's tap yields a visible first-connect retry window instead of a
838
- * single silent attempt — the same behavior as re-selecting the track (ADR 0004). Hooked off the
839
- * player error clearing: every recovery path (retry(), play(), the transport controls' idle-error
840
- * recovery) goes through exoPlayer.prepare(), which clears the error.
831
+ * Fresh retry budgets and unproven playback (ADR 0004): when the track changes, and when an error
832
+ * goes terminal, since whatever restarts playback from it starts a new load and nothing loads
833
+ * until then.
841
834
  */
842
835
  internal fun resetForNewLoad() {
843
836
  resetRetryTimer()
@@ -848,14 +841,10 @@ class Player(internal val context: Context) {
848
841
  mediaFactory.resetRetryTimer()
849
842
  }
850
843
 
851
- /**
852
- * Finds the queue Track whose published artwork URI matches [uri], for display-time artwork
853
- * resolution of app-supplied queue tracks that never went through browse (so they are not in the
854
- * resolution registry). Must run on the main thread (ExoPlayer access).
855
- */
844
+ /** Main thread only (ExoPlayer access). */
856
845
  private fun findQueueTrackByArtworkUri(uri: String): Track? {
857
- for (i in 0 until exoPlayer.mediaItemCount) {
858
- val item = exoPlayer.getMediaItemAt(i)
846
+ for (i in 0 until sessionPlayer.mediaItemCount) {
847
+ val item = sessionPlayer.getMediaItemAt(i)
859
848
  if (item.mediaMetadata.artworkUri?.toString() == uri) {
860
849
  return item.localConfiguration?.tag as? Track
861
850
  }
@@ -864,10 +853,8 @@ class Player(internal val context: Context) {
864
853
  }
865
854
 
866
855
  /**
867
- * Track-first display-time artwork resolution for [CoilBitmapLoader]: registry hit
868
- * (browse/now-playing-resolved URIs) → queue-tag lookup (app-supplied tracks with raw artwork) →
869
- * header-only fallback for unattributable URIs (registry eviction / process-death restore). Null
870
- * means "fetch the URI as-is".
856
+ * For [CoilBitmapLoader]: the resolution registry, then the queue track that published [uri],
857
+ * then headers alone for a URI nothing attributes. Null means fetch the URI as-is.
871
858
  */
872
859
  suspend fun resolveDisplayArtwork(uri: String, sizeHintPixels: Int?): ImageSource? {
873
860
  val browserManager = browser?.browserManager ?: return null
@@ -876,6 +863,14 @@ class Player(internal val context: Context) {
876
863
  browserManager.displayArtworkSource(uri, imageContext)?.let {
877
864
  return it
878
865
  }
866
+ // On Android Automotive OS the queue publishes provider URIs; the resolutions are keyed by URL.
867
+ TrackFactory.artworkRoutes
868
+ ?.publicUrl(uri.toUri())
869
+ ?.takeIf { it != uri }
870
+ ?.let { browserManager.displayArtworkSource(it, imageContext) }
871
+ ?.let {
872
+ return it
873
+ }
879
874
  withContext(Dispatchers.Main) { findQueueTrackByArtworkUri(uri) }
880
875
  ?.let { track ->
881
876
  return browserManager.resolveArtworkUrl(track, null, imageContext)
@@ -883,58 +878,48 @@ class Player(internal val context: Context) {
883
878
  return browserManager.unattributedArtworkSource(uri)
884
879
  }
885
880
 
886
- /**
887
- * Updates the favorite button icon in the notification/Android Auto. Call this when track changes
888
- * or favorite state changes.
889
- */
890
881
  internal fun updateFavoriteButtonState(favorited: Boolean?) {
891
882
  if (!::mediaSession.isInitialized) return
892
883
  mediaSessionCallback.commandManager.updateFavoriteState(mediaSession, favorited)
893
884
  }
894
885
 
895
- /** Removes all the upcoming tracks, if any (the ones returned by [next]). */
886
+ internal fun updateLiveState(live: Boolean) {
887
+ if (!::mediaSession.isInitialized) return
888
+ mediaSessionCallback.commandManager.updateLiveState(mediaSession, live)
889
+ }
890
+
896
891
  fun removeUpcomingTracks() {
897
- val index = exoPlayer.currentMediaItemIndex
892
+ val index = sessionPlayer.currentMediaItemIndex
898
893
  if (index == C.INDEX_UNSET) return
899
- val lastIndex = exoPlayer.mediaItemCount
894
+ val lastIndex = sessionPlayer.mediaItemCount
900
895
  val fromIndex = index + 1
901
896
 
902
- exoPlayer.removeMediaItems(fromIndex, lastIndex)
897
+ sessionPlayer.removeMediaItems(fromIndex, lastIndex)
903
898
  }
904
899
 
905
900
  fun play() {
906
- // Through the setter so the STATE_ENDED replay handling applies
907
- // (ExoPlayer.play() is only setPlayWhenReady(true)).
908
901
  playWhenReady = true
909
- if (currentTrack != null) {
910
- // No-op unless the player is STATE_IDLE (ExoPlayer.prepare early-returns
911
- // otherwise), so this only reconnects after a stop() or error and never
912
- // re-buffers a healthy stream. Reconnecting is also how live streams
913
- // rejoin the live edge on resume.
914
- exoPlayer.prepare()
915
- }
916
902
  }
917
903
 
918
- /** Jump to the live edge (default position) of a live item; no-op otherwise. */
904
+ /**
905
+ * No-op unless the track declares `live`; ExoPlayer never marks progressive ICY radio live. A
906
+ * stream with a live window seeks to its edge; anything else reconnects, which for a non-seekable
907
+ * stream is the live edge.
908
+ */
919
909
  fun seekToLiveEdge() {
920
- if (exoPlayer.isCurrentMediaItemLive) {
921
- exoPlayer.seekToDefaultPosition()
922
- }
910
+ if (currentTrack?.live != true) return
911
+ // A receiver loads a live stream again on a seek to its default position.
912
+ if (!localEngine.reconnectAtLiveEdge()) sessionPlayer.seekToDefaultPosition()
923
913
  }
924
914
 
925
915
  /**
926
- * Executes a search and plays the results. Used for voice commands with structured search
927
- * parameters.
928
- *
929
- * @param params The structured search parameters (mode, query, artist, album, etc.)
930
- * @return true if search succeeded and playback started, false otherwise
916
+ * @return whether a result started playing: false when gated (after onGate), with no results, or
917
+ * on any error, the browser's registration timeout included.
931
918
  */
932
919
  suspend fun playFromSearch(params: SearchParams): Boolean {
933
920
  return try {
934
921
  val audioBrowser = awaitBrowser()
935
- // A gate blocks external-surface "play" search too — otherwise voice search is a way around
936
- // the gate (mirrors the iOS play-media intent guard). Resolved per request; a gated decision
937
- // fires onGate(search) and refuses.
922
+ // Gated like browsing, or voice search would be a way around the gate.
938
923
  val gateOutcome =
939
924
  audioBrowser.gateDecision(
940
925
  NativeGateRequest(reason = GateReason.SEARCH, path = null, search = params)
@@ -961,61 +946,57 @@ class Player(internal val context: Context) {
961
946
  false
962
947
  }
963
948
  } catch (e: Exception) {
949
+ currentCoroutineContext().ensureActive()
964
950
  Timber.e(e, "Error handling voice search: ${params}")
965
951
  false
966
952
  }
967
953
  }
968
954
 
955
+ /** An ended queue stays ended, as on an ended engine. */
969
956
  fun prepare() {
970
- if (currentTrack != null) {
971
- exoPlayer.prepare()
972
- }
957
+ if (currentTrack != null && playbackState != PlaybackState.ENDED) sessionPlayer.prepare()
973
958
  }
974
959
 
975
960
  fun pause() {
976
- // Through the setter so the eager playWhenReadyCache write holds for the
977
- // drop direction too — the retry policy reads it off-main before
978
- // ExoPlayer's listener round-trip syncs it.
979
961
  playWhenReady = false
980
962
  }
981
963
 
982
964
  fun togglePlayback() {
983
- if (exoPlayer.playWhenReady) {
984
- pause()
985
- } else {
986
- play()
965
+ when {
966
+ // Suppressed with the intent raised: ExoPlayer resumes when focus returns. play() would
967
+ // request focus again, and during a call that refusal drops the intent.
968
+ playWhenReady && !shouldPlayWhenReady -> Unit
969
+ PlayingStateFactory.derive(shouldPlayWhenReady, playbackState).playing -> pause()
970
+ else -> play()
987
971
  }
988
972
  }
989
973
 
990
- /**
991
- * Stops playback, without clearing the active track. Calling this method will cause the playback
992
- * state to transition to State.NONE and the player will release the loaded media and resources
993
- * required for playback.
994
- */
974
+ /** Keeps the queue; the state becomes STOPPED. */
995
975
  fun stop() {
996
- // State first so the machine's STOPPED guard suppresses the PAUSED transition
997
- // from the playWhenReady drop below; through setPlaybackState so the change
998
- // is emitted (direct field assignment bypasses events — see its docstring).
976
+ nowPlaying.clearTimedMetadata()
977
+ // State first, so the state machine's STOPPED guard swallows the PAUSED the drop below causes.
999
978
  setPlaybackState(PlaybackState.STOPPED)
979
+ val ended = sessionPlayer.playbackState == MediaPlayer.STATE_ENDED
1000
980
  playWhenReady = false
1001
- exoPlayer.stop()
981
+ sessionPlayer.stop()
982
+ // Idle at its end, the next prepare would end it again at once.
983
+ if (ended) sessionPlayer.seekToDefaultPosition()
1002
984
  }
1003
985
 
1004
986
  fun clear() {
1005
- exoPlayer.clearMediaItems()
987
+ sessionPlayer.clearMediaItems()
1006
988
  queueSourcePath = null
1007
989
  }
1008
990
 
1009
- /**
1010
- * Stops and destroys the player. Only call this when you are finished using the player, otherwise
1011
- * use [pause].
1012
- */
991
+ /** Idempotent. */
1013
992
  fun destroy() {
1014
- // Cancel without a final save: the loop would tick against the released
1015
- // player and persist position 0 over the real resumption position.
1016
- playbackStateStore.cancelPeriodicSave()
1017
- // An armed timer's Runnable would outlive the release and fire pause() into the
1018
- // released player. Cleared here, while a mid-ramp fade can still restore volume.
993
+ if (destroyed) return
994
+ destroyed = true
995
+ deferredSetup = null
996
+ // stop() saves only if playing; before it, so its STOPPED doesn't defeat the ENDED guard.
997
+ playbackStateStore.stopPeriodicSave()
998
+ // An armed timer would fire pause() into the released player. Cleared before the release,
999
+ // while a mid-ramp fade can still restore the volume.
1019
1000
  sleepTimer.clear()
1020
1001
  stop()
1021
1002
  nowPlaying.destroy()
@@ -1023,6 +1004,7 @@ class Player(internal val context: Context) {
1023
1004
  forwardingPlayer.removeListener(playerListener)
1024
1005
  automaticBufferManager?.detach()
1025
1006
  automaticBufferManager = null
1007
+ remoteOutputs.release()
1026
1008
  exoPlayer.release()
1027
1009
  cache?.release()
1028
1010
  cache = null
@@ -1032,36 +1014,40 @@ class Player(internal val context: Context) {
1032
1014
 
1033
1015
  fun seekTo(duration: Long, unit: TimeUnit) {
1034
1016
  val positionMs = TimeUnit.MILLISECONDS.convert(duration, unit)
1035
- exoPlayer.seekTo(positionMs)
1017
+ sessionPlayer.seekTo(positionMs)
1036
1018
  }
1037
1019
 
1038
1020
  fun seekBy(offset: Long, unit: TimeUnit) {
1039
- val positionMs = exoPlayer.currentPosition + TimeUnit.MILLISECONDS.convert(offset, unit)
1040
- exoPlayer.seekTo(positionMs)
1021
+ val positionMs = sessionPlayer.currentPosition + TimeUnit.MILLISECONDS.convert(offset, unit)
1022
+ sessionPlayer.seekTo(positionMs)
1041
1023
  }
1042
1024
 
1043
1025
  /**
1044
- * Invalidates in-flight [reportRetryingError] posts: bumped on track change so a report
1045
- * classified for the outgoing track can't land on the incoming one's spinner. Written on main,
1046
- * read on ExoPlayer's loader thread.
1026
+ * Bumped on track change so a [reportRetryingError] post for the outgoing track is dropped.
1027
+ * Written on main, read on ExoPlayer's loader thread.
1047
1028
  */
1048
1029
  @Volatile private var retryingErrorGeneration = 0
1049
1030
 
1050
1031
  /**
1051
- * Surfaces a load failure the retry policy is still working on: attached to the current
1052
- * (non-terminal) state via [Callbacks.onPlaybackChanged], so UIs can show the cause over the
1053
- * spinner. Not an ERROR transition, and not a [Callbacks.onPlaybackError] — that event stays
1054
- * reserved for terminal errors. Called from ExoPlayer's loader thread, hence the main hop.
1032
+ * Attaches a load failure the retry policy is still working on to the current state, for UIs to
1033
+ * show over the spinner. Not an ERROR and not [Callbacks.onPlaybackError], which stays terminal.
1034
+ * Called on ExoPlayer's loader thread.
1055
1035
  */
1056
1036
  private fun reportRetryingError(exception: IOException) {
1057
1037
  val error = PlaybackErrorClassifier.retryingLoadError(exception, networkMonitor.getOnline())
1058
1038
  val generation = retryingErrorGeneration
1059
1039
  mainHandler.post {
1060
- // The track changed while this post was in flight — the error belongs to the old one.
1061
1040
  if (generation != retryingErrorGeneration) return@post
1062
- // Only attach while the failure is what the listener is looking at. During PLAYING/READY
1063
- // buffered audio is still audibly fine, and ExoPlayer's in-place retry can succeed without
1064
- // any state change — an advisory attached there would never clear.
1041
+ // Paused, the retry would run unseen and its failure be terminal. STOPPED, ERROR and ENDED
1042
+ // reach here only from a post that raced them.
1043
+ if (
1044
+ !playWhenReady &&
1045
+ playbackState !in setOf(PlaybackState.STOPPED, PlaybackState.ERROR, PlaybackState.ENDED)
1046
+ ) {
1047
+ return@post stopRetrying()
1048
+ }
1049
+ // Only over a spinner: while PLAYING, buffered audio still plays and ExoPlayer's in-place
1050
+ // retry can succeed with no state change, so an error attached there would never clear.
1065
1051
  if (
1066
1052
  playbackState != PlaybackState.LOADING &&
1067
1053
  playbackState != PlaybackState.BUFFERING &&
@@ -1069,8 +1055,7 @@ class Player(internal val context: Context) {
1069
1055
  ) {
1070
1056
  return@post
1071
1057
  }
1072
- // Each failed attempt re-reports; identical repeats add nothing (and would
1073
- // re-render now-playing every backoff tick).
1058
+ // Each backoff tick re-reports the same error.
1074
1059
  if (playbackError == error) return@post
1075
1060
  playbackError = error
1076
1061
  callbacks?.onPlaybackChanged(Playback(playbackState, error))
@@ -1079,9 +1064,29 @@ class Player(internal val context: Context) {
1079
1064
  }
1080
1065
 
1081
1066
  /**
1082
- * Drops a retrying error whose track is gone. The new track may keep the state on
1083
- * LOADING/BUFFERING — no state-change emit — so the clear is emitted here, or the old track's
1084
- * error would linger over the new one's spinner.
1067
+ * Cancels the retry a dropped play intent leaves scheduled. No-op unless a retrying error shows.
1068
+ */
1069
+ internal fun cancelRetry() {
1070
+ // The ENDED path drops the intent before it clears the error.
1071
+ if (playbackError?.retrying != true || playbackState == PlaybackState.ENDED) return
1072
+ stopRetrying()
1073
+ }
1074
+
1075
+ /**
1076
+ * Gives up a load ExoPlayer would retry. The engine idles in PAUSED, where the next prepare()
1077
+ * reloads where it failed.
1078
+ */
1079
+ private fun stopRetrying() {
1080
+ // Before the stop: the state machine holds PAUSED through the IDLE that follows.
1081
+ setPlaybackState(PlaybackState.PAUSED)
1082
+ clearRetryingError()
1083
+ exoPlayer.stop()
1084
+ resetRetryTimer()
1085
+ }
1086
+
1087
+ /**
1088
+ * Drops the retrying error of a track that is gone. The new track may stay LOADING or BUFFERING
1089
+ * with no state change to emit the clear.
1085
1090
  */
1086
1091
  internal fun clearRetryingError() {
1087
1092
  retryingErrorGeneration++
@@ -1091,56 +1096,36 @@ class Player(internal val context: Context) {
1091
1096
  nowPlaying.render()
1092
1097
  }
1093
1098
 
1094
- /**
1095
- * Updates the player state and emits a state change event if the state has changed. Only emits an
1096
- * event if the new state differs from the current state.
1097
- *
1098
- * IMPORTANT: This method also triggers the queue ended event when the player reaches State.ENDED
1099
- * and is on the last track. All state transitions should go through this method to ensure proper
1100
- * event dispatching. Direct assignments to playerState will bypass event emission.
1101
- *
1102
- * @param state The new player state to set
1103
- */
1099
+ /** Every state change goes through here: it emits the change and the events that follow it. */
1104
1100
  internal fun setPlaybackState(state: PlaybackState) {
1105
1101
  if (state != playbackState) {
1106
1102
  val oldState = playbackState
1107
1103
  playbackState = state
1108
1104
 
1109
- // Audio rendered: this load has proven itself — retries from here on get
1110
- // the retry policy's full recovery budget, not the short first-connect one.
1111
- if (state == PlaybackState.PLAYING) {
1112
- hasPlayedCache = true
1113
- }
1105
+ if (state == PlaybackState.PLAYING) hasPlayedCache = true
1106
+ forwardingPlayer.onStateChanged(oldState)
1107
+ if (state == PlaybackState.ERROR) resetForNewLoad()
1114
1108
 
1115
- // A natural end exhausts the play intent — nothing is left to play. Keeping
1116
- // playWhenReady true inverted the play/pause toggle, held audio focus forever
1117
- // (ExoPlayer abandons it only at IDLE or on the intent dropping), and kept the
1118
- // periodic position save running. Cleared and emitted before the state /
1119
- // queue-ended callbacks so JS observes the native order (intent → state →
1120
- // queueEnded); the media3 listener's later echo is deduplicated by
1121
- // emitPlayWhenReadyChanged. The state machine's ENDED guard keeps the drop
1122
- // from re-reporting the state as PAUSED.
1109
+ // A natural end exhausts the play intent; held, it inverts the toggle, keeps audio focus and
1110
+ // the periodic save. Emitted before the state and queue-ended callbacks, matching iOS. The
1111
+ // state machine's ENDED guard keeps the drop from reporting PAUSED.
1123
1112
  if (state == PlaybackState.ENDED && playWhenReady) {
1124
1113
  playWhenReady = false
1125
1114
  emitPlayWhenReadyChanged(false)
1126
1115
  }
1127
1116
 
1128
- // The last track fires no AUTO media-item transition, so an armed
1129
- // end-of-track sleep timer would stay set forever and pause the next
1130
- // track played instead.
1117
+ // The last track fires no AUTO transition, so the end-of-track sleep timer would stay armed.
1131
1118
  if (state == PlaybackState.ENDED) {
1132
1119
  sleepTimer.onTrackEnd()
1133
1120
  }
1134
1121
 
1135
- // Clear error when transitioning away from error state
1136
1122
  if (oldState == PlaybackState.ERROR) {
1137
1123
  playbackError = null
1138
1124
  callbacks?.onPlaybackError(null)
1139
1125
  }
1140
1126
 
1141
- // A retrying error rides along through LOADING/BUFFERING/PAUSED; a state that
1142
- // proves recovery (READY/PLAYING — data flowed) or abandons the attempt clears
1143
- // it, before the Playback below is built so the emitted event is already clean.
1127
+ // A retrying error rides through LOADING, BUFFERING and PAUSED; any other state proves
1128
+ // recovery or abandons the attempt.
1144
1129
  if (
1145
1130
  playbackError?.retrying == true &&
1146
1131
  state != PlaybackState.LOADING &&
@@ -1153,25 +1138,16 @@ class Player(internal val context: Context) {
1153
1138
  val playback = Playback(state, playbackError)
1154
1139
  callbacks?.onPlaybackChanged(playback)
1155
1140
 
1156
- // Re-render the now-playing on every state change: the metadata formatter receives
1157
- // `playbackState` (plus isRebuffering / isOnline / error), so any transition can change its
1158
- // output — the live song while paused, a "Reconnecting…" line on a rebuffer, an offline/error
1159
- // line. The publish-dedupe in applyNowPlayingFields drops redundant updates, so re-running
1160
- // through the rapid startup sequence (none→loading→buffering→ready→playing) is cheap.
1141
+ // The formatter sees the state, so any transition can change what it renders.
1161
1142
  nowPlaying.render()
1162
1143
 
1163
- // Emit queue ended event when playback ends on the last track. Repeat modes never
1164
- // conceptually end the queue (matches web's endsQueue()): an ENDED that surfaces while
1165
- // repeating (e.g. a seek to the end) must not read as "playlist over".
1166
- // This coupling ensures queue ended events are always triggered consistently with state
1167
- // changes
1144
+ // A repeat mode never ends the queue, even on an ENDED from a seek to the end.
1168
1145
  if (state == PlaybackState.ENDED && isLastInPlaybackOrder && repeatMode == RepeatMode.OFF) {
1169
1146
  currentIndex?.let { index ->
1170
1147
  val event =
1171
1148
  PlaybackQueueEndedEvent(track = index.toDouble(), position = position.toSeconds())
1172
1149
  callbacks?.onPlaybackQueueEnded(event)
1173
1150
  }
1174
- // Reset saved position to 0 so resumption starts from beginning
1175
1151
  playbackStateStore.savePositionZero()
1176
1152
  }
1177
1153
 
@@ -1181,11 +1157,7 @@ class Player(internal val context: Context) {
1181
1157
  }
1182
1158
  }
1183
1159
 
1184
- /**
1185
- * Sets the progress update interval.
1186
- *
1187
- * @param interval The interval in seconds, or null to disable progress updates
1188
- */
1160
+ /** [interval] in seconds; null stops the progress events. */
1189
1161
  fun setProgressUpdateInterval(interval: Double?) {
1190
1162
  progressTimer.setInterval(interval)
1191
1163
  }
@@ -1194,21 +1166,11 @@ class Player(internal val context: Context) {
1194
1166
  intervalTimer.setInterval(if (enabled) 1.0 else null)
1195
1167
  }
1196
1168
 
1197
- /**
1198
- * Applies update options with change detection. Only updates properties that have actually
1199
- * changed and emits events accordingly.
1200
- *
1201
- * @param options The new options to apply
1202
- * @param mediaSession The MediaSession to update when capabilities change
1203
- */
1204
1169
  fun applyOptions(options: PlayerUpdateOptions) {
1205
- // Store previous values for change detection
1206
1170
  val previousOptions = this.options
1207
1171
 
1208
- // Update current options
1209
1172
  this.options = options.copy()
1210
1173
 
1211
- // Check what changed
1212
1174
  val skipSilenceChanged = previousOptions.skipSilence != options.skipSilence
1213
1175
  val progressUpdateEventIntervalChanged =
1214
1176
  previousOptions.progressUpdateEventInterval != options.progressUpdateEventInterval
@@ -1231,23 +1193,25 @@ class Player(internal val context: Context) {
1231
1193
  remoteButtonLayoutChanged ||
1232
1194
  appKilledPlaybackBehaviorChanged
1233
1195
 
1234
- // Apply only changed properties
1235
1196
  if (skipSilenceChanged) {
1236
1197
  skipSilence = options.skipSilence
1237
1198
  }
1238
1199
 
1239
1200
  if (capabilitiesChanged) {
1240
- // The `favorite` capability is the single favoriting switch — propagate
1241
- // its match mode to the browser so it can hydrate row hearts.
1242
- browser?.browserManager?.setFavoriteMatch(options.capabilities.favoriteMatch)
1201
+ // The favorite capability is the one favoriting switch; the browser hydrates row hearts from
1202
+ // it.
1203
+ browser?.browserManager?.setFavoriteEnabled(options.capabilities.favoriteEnabled)
1204
+ TrackFactory.favoriteEnabled = options.capabilities.favoriteEnabled
1205
+ if (previousOptions.capabilities.favoriteEnabled != options.capabilities.favoriteEnabled) {
1206
+ restampFavorites()
1207
+ }
1243
1208
  }
1244
1209
 
1245
1210
  if (progressUpdateEventIntervalChanged) {
1246
1211
  setProgressUpdateInterval(options.progressUpdateEventInterval)
1247
1212
  }
1248
1213
 
1249
- // The jump intervals pick the button icons (ICON_SKIP_BACK_15 and friends), so a changed
1250
- // interval has to rebuild the layout even when capabilities and placement are untouched.
1214
+ // The jump intervals pick the button icons, so a changed interval rebuilds the layout.
1251
1215
  if (
1252
1216
  capabilitiesChanged ||
1253
1217
  remoteButtonLayoutChanged ||
@@ -1270,20 +1234,10 @@ class Player(internal val context: Context) {
1270
1234
  }
1271
1235
  }
1272
1236
 
1273
- /**
1274
- * Sets the callbacks for player events.
1275
- *
1276
- * @param callbacks The callbacks to set, or null to clear callbacks
1277
- */
1278
1237
  fun setCallbacks(callbacks: Callbacks?) {
1279
1238
  this.callbacks = callbacks
1280
1239
  }
1281
1240
 
1282
- /**
1283
- * Gets the current callbacks instance.
1284
- *
1285
- * @return The current callbacks, or null if none are set
1286
- */
1287
1241
  fun getCallbacks(): Callbacks? {
1288
1242
  return this.callbacks
1289
1243
  }
@@ -1296,58 +1250,30 @@ class Player(internal val context: Context) {
1296
1250
  return options
1297
1251
  }
1298
1252
 
1299
- /**
1300
- * Gets the current network connectivity state.
1301
- *
1302
- * @return true if device is online, false otherwise
1303
- */
1304
1253
  fun getOnline(): Boolean {
1305
1254
  return networkMonitor.getOnline()
1306
1255
  }
1307
1256
 
1308
- /**
1309
- * Validates that an index is within bounds [0, trackCount).
1310
- *
1311
- * @param index The index to validate.
1312
- * @throws IllegalArgumentException if index is out of bounds.
1313
- */
1314
1257
  private fun validateIndex(index: Int) {
1315
- if (index < 0 || index >= exoPlayer.mediaItemCount) {
1258
+ if (index < 0 || index >= sessionPlayer.mediaItemCount) {
1316
1259
  throw IllegalArgumentException(
1317
- "Track index $index is out of bounds (size: ${exoPlayer.mediaItemCount})"
1260
+ "Track index $index is out of bounds (size: ${sessionPlayer.mediaItemCount})"
1318
1261
  )
1319
1262
  }
1320
1263
  }
1321
1264
 
1322
- /**
1323
- * Validates that an insertion index is within bounds [0, trackCount] or -1 (append).
1324
- *
1325
- * @param index The index to validate.
1326
- * @throws IllegalArgumentException if index is out of bounds.
1327
- */
1328
1265
  private fun validateInsertIndex(index: Int) {
1329
- if (index < -1 || index > exoPlayer.mediaItemCount) {
1266
+ if (index < -1 || index > sessionPlayer.mediaItemCount) {
1330
1267
  throw IllegalArgumentException(
1331
- "Insert index $index is out of bounds (size: ${exoPlayer.mediaItemCount}, use -1 to append)"
1268
+ "Insert index $index is out of bounds (size: ${sessionPlayer.mediaItemCount}, use -1 to append)"
1332
1269
  )
1333
1270
  }
1334
1271
  }
1335
1272
 
1336
- /**
1337
- * Gets the MediaSessionCallback for this AudioBrowser.
1338
- *
1339
- * @return MediaLibrarySession.Callback instance
1340
- */
1341
1273
  fun getMediaSessionCallback(): MediaLibraryService.MediaLibrarySession.Callback {
1342
1274
  return mediaSessionCallback
1343
1275
  }
1344
1276
 
1345
- /**
1346
- * Notifies external controllers (Android Auto, etc.) that content at the given path has changed.
1347
- * Controllers subscribed to this path will refresh their UI.
1348
- *
1349
- * @param path The path where content has changed
1350
- */
1351
1277
  fun notifyContentChanged(path: String) {
1352
1278
  mediaSessionCallback.notifyContentChanged(path)
1353
1279
  }
@@ -1356,41 +1282,24 @@ class Player(internal val context: Context) {
1356
1282
  mediaSessionCallback.invalidateAllContent()
1357
1283
  }
1358
1284
 
1359
- /**
1360
- * Returns the recommended artwork size in pixels from the connected media browser (e.g., Android
1361
- * Auto), or null if not provided.
1362
- */
1285
+ /** From the connected media browser (e.g. Android Auto), when it gives one. */
1363
1286
  val artworkSizeHintPixels: Int?
1364
1287
  get() = mediaSessionCallback.artworkSizeHintPixels
1365
1288
 
1366
- /** Returns true if the current media item is a live stream. */
1367
1289
  val isCurrentItemLive: Boolean
1368
- get() = exoPlayer.isCurrentMediaItemLive
1290
+ get() = sessionPlayer.isCurrentMediaItemLive
1369
1291
 
1370
1292
  // MARK: - Buffer Configuration
1371
1293
 
1372
- /**
1373
- * Updates the buffer configuration at runtime.
1374
- *
1375
- * The new configuration takes effect immediately for future buffering decisions. Already-buffered
1376
- * data is not affected.
1377
- *
1378
- * @param config The new buffer configuration to apply.
1379
- */
1294
+ /** Takes effect for future buffering; what is buffered stays. */
1380
1295
  fun updateBufferConfig(config: BufferConfig) {
1381
1296
  loadControl.updateBufferConfig(config)
1382
1297
  }
1383
1298
 
1384
- /**
1385
- * Gets the current buffer configuration.
1386
- *
1387
- * @return The current buffer configuration.
1388
- */
1389
1299
  fun getBufferConfig(): BufferConfig {
1390
1300
  return loadControl.getBufferConfig()
1391
1301
  }
1392
1302
 
1393
- /** Resets the buffer configuration to defaults. */
1394
1303
  fun resetBufferConfig() {
1395
1304
  loadControl.resetToDefaults()
1396
1305
  }