react-native-audio-browser 0.2.0 → 1.0.0-next.1

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 (1589) hide show
  1. package/AudioBrowser.podspec +2 -2
  2. package/README.md +209 -2
  3. package/android/build.gradle +65 -10
  4. package/android/gradle.properties +3 -3
  5. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  6. package/android/src/main/AndroidManifest.xml +29 -1
  7. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +817 -404
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  9. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  10. package/android/src/main/java/com/audiobrowser/Callbacks.kt +5 -16
  11. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  12. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  13. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +222 -0
  14. package/android/src/main/java/com/audiobrowser/Service.kt +143 -97
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  16. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +38 -0
  17. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +50 -0
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +571 -490
  19. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +269 -0
  20. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  21. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +75 -0
  22. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +104 -45
  23. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  24. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +66 -0
  25. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  26. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  27. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +14 -21
  28. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  29. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  30. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +44 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  32. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  33. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  34. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +101 -103
  35. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  36. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +15 -20
  37. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +64 -27
  38. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +42 -58
  39. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +93 -47
  40. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +136 -0
  41. package/android/src/main/java/com/audiobrowser/player/ConnectionEndSource.kt +145 -0
  42. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  43. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +25 -36
  44. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +67 -0
  45. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +150 -0
  46. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +204 -0
  47. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  48. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  49. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +82 -55
  50. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +809 -266
  51. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +241 -442
  52. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +341 -0
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +119 -0
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +109 -0
  55. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +126 -119
  56. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +60 -0
  57. package/android/src/main/java/com/audiobrowser/player/Player.kt +1024 -965
  58. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +7 -0
  59. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +120 -0
  60. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +225 -107
  61. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +96 -0
  62. package/android/src/main/java/com/audiobrowser/player/RetryFocus.kt +126 -0
  63. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +95 -157
  64. package/android/src/main/java/com/audiobrowser/player/RetryLocks.kt +52 -0
  65. package/android/src/main/java/com/audiobrowser/player/RetryLoop.kt +310 -0
  66. package/android/src/main/java/com/audiobrowser/player/RetryView.kt +31 -0
  67. package/android/src/main/java/com/audiobrowser/player/SessionViewListener.kt +168 -0
  68. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  69. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  70. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +41 -21
  71. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +76 -0
  72. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +96 -66
  73. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +85 -0
  74. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  75. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +104 -0
  76. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  77. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  78. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +742 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +203 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  90. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  91. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  92. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  93. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  94. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  95. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +160 -0
  96. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  97. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +72 -0
  98. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +54 -0
  99. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +363 -0
  100. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +149 -0
  101. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  102. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +29 -0
  103. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +13 -0
  104. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  105. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  106. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  107. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  108. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +54 -73
  109. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +49 -0
  110. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +33 -0
  111. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +23 -316
  112. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +18 -60
  113. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +26 -25
  114. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +12 -11
  115. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +25 -56
  116. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +204 -0
  117. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +45 -0
  118. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +8 -8
  119. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +13 -0
  120. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  121. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +3 -112
  122. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +21 -10
  123. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +127 -82
  124. package/android/src/main/res/values/strings.xml +26 -2
  125. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  126. package/android/src/test/java/androidx/media3/session/SessionViews.kt +38 -0
  127. package/android/src/test/java/com/audiobrowser/AudioFixtures.kt +59 -0
  128. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  129. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  130. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  131. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +90 -0
  132. package/android/src/test/java/com/audiobrowser/NetworkFixtures.kt +25 -0
  133. package/android/src/test/java/com/audiobrowser/RemoteOutputRoutesTest.kt +29 -0
  134. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +81 -0
  135. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  136. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  137. package/android/src/test/java/com/audiobrowser/ServiceFixtures.kt +48 -0
  138. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +290 -0
  139. package/android/src/test/java/com/audiobrowser/SessionPositionUpdatesTest.kt +114 -0
  140. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +247 -0
  141. package/android/src/test/java/com/audiobrowser/browser/ArtworkResolutionRegistryTest.kt +46 -0
  142. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +39 -0
  143. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +108 -0
  144. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  145. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  146. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +203 -0
  147. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -4
  148. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +233 -0
  149. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  150. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +53 -0
  151. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  152. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +157 -0
  153. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +2 -7
  154. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  155. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +44 -0
  156. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  157. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  158. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +134 -8
  159. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  160. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  161. package/android/src/test/java/com/audiobrowser/player/AutomaticBufferManagerTest.kt +208 -0
  162. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  163. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +193 -0
  164. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  165. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +55 -0
  166. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +219 -0
  167. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  168. package/android/src/test/java/com/audiobrowser/player/HandleTrackLoadSeekTest.kt +243 -0
  169. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  170. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +493 -0
  171. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  172. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +36 -0
  173. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  174. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +672 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  176. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +167 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +250 -0
  178. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  179. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +135 -0
  180. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  181. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  182. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  183. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +33 -0
  184. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  185. package/android/src/test/java/com/audiobrowser/player/PlayerQueueVersionTest.kt +79 -0
  186. package/android/src/test/java/com/audiobrowser/player/PlayerRemoteOutputsSeekTest.kt +105 -0
  187. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +738 -0
  188. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +195 -0
  189. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  190. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  191. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  192. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +365 -0
  193. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +222 -0
  194. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  195. package/android/src/test/java/com/audiobrowser/player/RetryFocusTest.kt +97 -0
  196. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +190 -0
  197. package/android/src/test/java/com/audiobrowser/player/RetryLocksTest.kt +48 -0
  198. package/android/src/test/java/com/audiobrowser/player/RetryLoopCaseTest.kt +181 -0
  199. package/android/src/test/java/com/audiobrowser/player/RetryLoopTest.kt +221 -0
  200. package/android/src/test/java/com/audiobrowser/player/RetryMaskingTest.kt +178 -0
  201. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +212 -0
  202. package/android/src/test/java/com/audiobrowser/player/SessionViewListenerTest.kt +225 -0
  203. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  204. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +234 -0
  205. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  206. package/android/src/test/java/com/audiobrowser/player/SleepTimerTest.kt +48 -0
  207. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  208. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +231 -0
  209. package/android/src/test/java/com/audiobrowser/player/VolumeFaderTest.kt +43 -0
  210. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +309 -0
  211. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  212. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  213. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  214. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1037 -0
  215. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  216. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  217. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  218. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  219. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  220. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  221. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  222. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  223. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +199 -0
  224. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  225. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  226. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  227. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  228. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +273 -0
  229. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +380 -0
  230. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  231. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +152 -0
  232. package/android/src/test/java/com/audiobrowser/tls/CertFixtures.kt +18 -0
  233. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +154 -0
  234. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +33 -0
  235. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  236. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +63 -0
  237. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +53 -0
  238. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +53 -0
  239. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +57 -0
  240. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  241. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  242. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +108 -0
  243. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  244. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +36 -0
  245. package/android/src/test/java/com/audiobrowser/util/RatingFavoritesTest.kt +34 -0
  246. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +50 -0
  247. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +61 -0
  248. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +125 -0
  249. package/android/src/test/resources/certs/isrg-root-x1.pem +31 -0
  250. package/android/src/test/resources/certs/letsencrypt-r13.der +0 -0
  251. package/android/src/test/resources/certs/letsencrypt-r13.pem +29 -0
  252. package/android/src/test/resources/certs/stationplaylist-leaf.pem +34 -0
  253. package/android/src/test/resources/sonos/device_description.xml +78 -0
  254. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  255. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  256. package/ios/AVPlayerEngine.swift +385 -0
  257. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  258. package/ios/Browser/BrowseGate.swift +70 -0
  259. package/ios/Browser/BrowserConfig.swift +131 -82
  260. package/ios/Browser/BrowserError.swift +15 -0
  261. package/ios/Browser/BrowserManager.swift +165 -494
  262. package/ios/Browser/BrowserPathHelper.swift +62 -96
  263. package/ios/Browser/FavoriteSet.swift +43 -0
  264. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  265. package/ios/Browser/JsonModels.swift +276 -146
  266. package/ios/Browser/NavigationErrorState.swift +42 -0
  267. package/ios/Browser/PageResolver.swift +132 -0
  268. package/ios/Browser/RequestLayer.swift +185 -0
  269. package/ios/Browser/RequestPipeline.swift +295 -0
  270. package/ios/Browser/SearchDrillIn.swift +38 -0
  271. package/ios/Browser/SectionScope.swift +82 -0
  272. package/ios/Browser/SimpleRouter.swift +76 -154
  273. package/ios/Browser/StyleResolver.swift +41 -0
  274. package/ios/Browser/TabBarEntries.swift +16 -0
  275. package/ios/Browser/TrackIdTemplate.swift +29 -0
  276. package/ios/CarPlay/CPInterfaceController+Safe.swift +167 -0
  277. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  278. package/ios/CarPlay/CarPlayController.swift +47 -717
  279. package/ios/CarPlay/CarPlayImageLoader.swift +88 -126
  280. package/ios/CarPlay/CarPlayListItemFactory.swift +244 -99
  281. package/ios/CarPlay/CarPlayNowPlayingManager.swift +206 -133
  282. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  283. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  284. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  285. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  286. package/ios/CarPlay/CarPlaySession.swift +203 -0
  287. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  288. package/ios/CarPlay/IntentHandlers.swift +94 -0
  289. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  290. package/ios/CarPlay/MediaIntentHandler.swift +68 -0
  291. package/ios/CarPlay/MediaIntentPlayback.swift +86 -0
  292. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  293. package/ios/CarPlay/RNABAudioBrowser.h +15 -10
  294. package/ios/CarPlay/RNABAudioBrowser.m +8 -15
  295. package/ios/CarPlay/RNABCarPlaySceneDelegate.m +2 -0
  296. package/ios/CarPlay/SectionPresentation.swift +67 -0
  297. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  298. package/ios/Extension/Capability+RemoteCommand.swift +22 -71
  299. package/ios/Extension/ChapterMetadata+AVFoundation.swift +3 -6
  300. package/ios/Extension/CxxVectorConformances.swift +4 -16
  301. package/ios/Extension/NavigationError+Conversion.swift +22 -8
  302. package/ios/Extension/PlayerCapabilities+Favorite.swift +5 -0
  303. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  304. package/ios/Extension/RequestConfig+Copying.swift +27 -0
  305. package/ios/Extension/ResolvedTrack+Copying.swift +20 -22
  306. package/ios/Extension/SearchParams+Query.swift +28 -0
  307. package/ios/Extension/Section+Copying.swift +26 -0
  308. package/ios/Extension/String+IcyCharset.swift +21 -0
  309. package/ios/Extension/TimedMetadata+AVFoundation.swift +11 -15
  310. package/ios/Extension/Track+AVPlayer.swift +5 -22
  311. package/ios/Extension/Track+Copying.swift +18 -20
  312. package/ios/Extension/Track+Identity.swift +20 -0
  313. package/ios/Extension/TrackMetadata+AVFoundation.swift +11 -14
  314. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  315. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  316. package/ios/Extension/URLError+Connectivity.swift +15 -0
  317. package/ios/Extension/Variant+Artwork.swift +35 -0
  318. package/ios/Http/HttpClient.swift +73 -167
  319. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  320. package/ios/HybridAudioBrowser+Options.swift +116 -0
  321. package/ios/HybridAudioBrowser+Player.swift +351 -0
  322. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  323. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  324. package/ios/HybridAudioBrowser.swift +164 -1127
  325. package/ios/Model/NitroTypeStubs.swift +533 -224
  326. package/ios/Model/PlayerUpdateOptions.swift +32 -38
  327. package/ios/Model/RemoteCommand.swift +6 -60
  328. package/ios/Model/TrackPlayerError.swift +73 -18
  329. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +65 -141
  330. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +67 -0
  331. package/ios/Observer/ItemObserver.swift +99 -0
  332. package/ios/Observer/PlayerObserver.swift +59 -0
  333. package/ios/Option/SessionCategories.swift +51 -79
  334. package/ios/PlaybackEvent.swift +4 -2
  335. package/ios/Player/AirPlayStallJudgement.swift +23 -0
  336. package/ios/Player/AudioSessionController.swift +190 -0
  337. package/ios/Player/DeferredSeek.swift +73 -0
  338. package/ios/Player/ErrorStatus.swift +56 -0
  339. package/ios/Player/MediaLoader.swift +94 -93
  340. package/ios/Player/NowPlayingLines.swift +49 -0
  341. package/ios/Player/NowPlayingUpdater.swift +213 -45
  342. package/ios/Player/PersistedPlaybackState.swift +10 -0
  343. package/ios/Player/PlaybackFailure.swift +121 -0
  344. package/ios/Player/PlaybackPersistence.swift +72 -0
  345. package/ios/Player/PlaybackStateMachine.swift +23 -17
  346. package/ios/Player/PlaybackTimer.swift +64 -0
  347. package/ios/Player/Player.swift +1127 -0
  348. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +6 -5
  349. package/ios/Player/PlayerEngine.swift +118 -0
  350. package/ios/Player/PlayerStatusTypes.swift +1 -6
  351. package/ios/Player/QueueManager.swift +137 -138
  352. package/ios/Player/ReconnectPacer.swift +83 -0
  353. package/ios/Player/RetryLoop.swift +374 -0
  354. package/ios/Player/ShuffleOrder.swift +36 -43
  355. package/ios/Player/SilenceBudget.swift +78 -0
  356. package/ios/Player/SleepTimerManager.swift +101 -31
  357. package/ios/Player/VolumeFader.swift +91 -0
  358. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  359. package/ios/RemoteCommand/RemoteCommandController.swift +112 -331
  360. package/ios/Tests/AirPlayStallJudgementTests.swift +52 -0
  361. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  362. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  363. package/ios/Tests/BrowseGateTests.swift +50 -0
  364. package/ios/Tests/BrowserPathHelperTests.swift +99 -0
  365. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  366. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  367. package/ios/Tests/ChapterMetadataAVFoundationTests.swift +2 -2
  368. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  369. package/ios/Tests/ConnectivityTests.swift +13 -0
  370. package/ios/Tests/DeferredSeekTests.swift +76 -0
  371. package/ios/Tests/EmitterTests.swift +22 -39
  372. package/ios/Tests/ErrorStatusTests.swift +50 -0
  373. package/ios/Tests/FavoriteSetTests.swift +61 -0
  374. package/ios/Tests/GenerationMemoTests.swift +178 -0
  375. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  376. package/ios/Tests/JsonModelsTests.swift +244 -0
  377. package/ios/Tests/LRUCacheTests.swift +106 -0
  378. package/ios/Tests/MediaIntentCriteriaTests.swift +176 -0
  379. package/ios/Tests/MediaIntentDeadlineTests.swift +75 -0
  380. package/ios/Tests/MediaLoaderAssetOptionsTests.swift +46 -0
  381. package/ios/Tests/MediaLoaderTests.swift +67 -74
  382. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  383. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  384. package/ios/Tests/ObserverTests.swift +106 -0
  385. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  386. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  387. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  388. package/ios/Tests/PlaybackStateMachineTests.swift +28 -18
  389. package/ios/Tests/PlaybackTimerTests.swift +54 -0
  390. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  391. package/ios/Tests/PlayerPolicyTests.swift +1743 -0
  392. package/ios/Tests/PlayerTests.swift +1677 -0
  393. package/ios/Tests/PlayingStateTests.swift +41 -0
  394. package/ios/Tests/QueueManagerTests.swift +366 -164
  395. package/ios/Tests/ReadyValueTests.swift +73 -0
  396. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  397. package/ios/Tests/RequestLayerTests.swift +228 -0
  398. package/ios/Tests/ResolvedTrackCopyingTests.swift +52 -43
  399. package/ios/Tests/RetryCaseTests.swift +146 -0
  400. package/ios/Tests/RetryLoopTests.swift +486 -0
  401. package/ios/Tests/SearchDrillInTests.swift +62 -0
  402. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  403. package/ios/Tests/SectionPresentationTests.swift +85 -0
  404. package/ios/Tests/SectionScopeTests.swift +164 -0
  405. package/ios/Tests/SimpleRouterTests.swift +39 -8
  406. package/ios/Tests/SleepTimerManagerTests.swift +156 -0
  407. package/ios/Tests/StyleResolverTests.swift +123 -0
  408. package/ios/Tests/SupersedingTaskTests.swift +148 -0
  409. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +42 -0
  410. package/ios/Tests/Support/SilentAudioFile.swift +13 -0
  411. package/ios/Tests/Support/TestTypes.swift +286 -84
  412. package/ios/Tests/Support/TimeLimit.swift +43 -0
  413. package/ios/Tests/TabBarEntriesTests.swift +69 -0
  414. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  415. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  416. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  417. package/ios/Tests/TrackIdentityTests.swift +20 -0
  418. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  419. package/ios/Tests/TrackSelectorTests.swift +171 -48
  420. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  421. package/ios/TrackSelector.swift +70 -80
  422. package/ios/Util/ArtworkFreshness.swift +42 -0
  423. package/ios/Util/ArtworkImageFetcher.swift +147 -8
  424. package/ios/Util/AwaitCallback.swift +80 -0
  425. package/ios/Util/ConcurrentMap.swift +19 -0
  426. package/ios/Util/Connectivity.swift +12 -0
  427. package/ios/Util/Deadline.swift +38 -0
  428. package/ios/Util/Emitter.swift +45 -22
  429. package/ios/Util/GenerationMemo.swift +43 -0
  430. package/ios/Util/LRUCache.swift +23 -159
  431. package/ios/Util/NetworkMonitor.swift +33 -31
  432. package/ios/Util/OutputPicker.swift +48 -0
  433. package/ios/Util/ReadyValue.swift +57 -0
  434. package/ios/Util/SFSymbolRenderer.swift +64 -49
  435. package/ios/Util/SVGProcessor.swift +9 -16
  436. package/ios/Util/SupersedingTask.swift +45 -0
  437. package/lib/commonjs/AudioBrowser.js +8 -8
  438. package/lib/commonjs/AudioBrowser.js.map +1 -1
  439. package/lib/commonjs/CLAUDE.md +57 -0
  440. package/lib/commonjs/features/battery.js +16 -12
  441. package/lib/commonjs/features/battery.js.map +1 -1
  442. package/lib/commonjs/features/browser-config.js +231 -0
  443. package/lib/commonjs/features/browser-config.js.map +1 -0
  444. package/lib/commonjs/features/browser.js +128 -169
  445. package/lib/commonjs/features/browser.js.map +1 -1
  446. package/lib/commonjs/features/carConnection.js +41 -0
  447. package/lib/commonjs/features/carConnection.js.map +1 -0
  448. package/lib/commonjs/features/equalizer.js +10 -6
  449. package/lib/commonjs/features/equalizer.js.map +1 -1
  450. package/lib/commonjs/features/errors.js +59 -13
  451. package/lib/commonjs/features/errors.js.map +1 -1
  452. package/lib/commonjs/features/favorites.js +29 -24
  453. package/lib/commonjs/features/favorites.js.map +1 -1
  454. package/lib/commonjs/features/gate.js +170 -0
  455. package/lib/commonjs/features/gate.js.map +1 -0
  456. package/lib/commonjs/features/index.js +22 -0
  457. package/lib/commonjs/features/index.js.map +1 -1
  458. package/lib/commonjs/features/metadata.js +64 -14
  459. package/lib/commonjs/features/metadata.js.map +1 -1
  460. package/lib/commonjs/features/network.js +6 -2
  461. package/lib/commonjs/features/network.js.map +1 -1
  462. package/lib/commonjs/features/nowPlaying.js +55 -6
  463. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  464. package/lib/commonjs/features/output.js +42 -23
  465. package/lib/commonjs/features/output.js.map +1 -1
  466. package/lib/commonjs/features/playback/controls.js +20 -4
  467. package/lib/commonjs/features/playback/controls.js.map +1 -1
  468. package/lib/commonjs/features/playback/index.js +11 -0
  469. package/lib/commonjs/features/playback/index.js.map +1 -1
  470. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  471. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  472. package/lib/commonjs/features/playback/playing.js +5 -3
  473. package/lib/commonjs/features/playback/playing.js.map +1 -1
  474. package/lib/commonjs/features/playback/progress.js +40 -17
  475. package/lib/commonjs/features/playback/progress.js.map +1 -1
  476. package/lib/commonjs/features/playback/rate.js +8 -1
  477. package/lib/commonjs/features/playback/rate.js.map +1 -1
  478. package/lib/commonjs/features/playback/state.js +5 -6
  479. package/lib/commonjs/features/playback/state.js.map +1 -1
  480. package/lib/commonjs/features/playback/trackPlaybackTime.js +91 -0
  481. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -0
  482. package/lib/commonjs/features/playback/volume.js +6 -5
  483. package/lib/commonjs/features/playback/volume.js.map +1 -1
  484. package/lib/commonjs/features/player/options.js +99 -39
  485. package/lib/commonjs/features/player/options.js.map +1 -1
  486. package/lib/commonjs/features/player/setup.js +258 -4
  487. package/lib/commonjs/features/player/setup.js.map +1 -1
  488. package/lib/commonjs/features/player/validateOptions.js +23 -0
  489. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  490. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  491. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  492. package/lib/commonjs/features/queue/queue.js +77 -24
  493. package/lib/commonjs/features/queue/queue.js.map +1 -1
  494. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  495. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  496. package/lib/commonjs/features/queue/shuffle.js +1 -2
  497. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  498. package/lib/commonjs/features/remoteControls.js +71 -137
  499. package/lib/commonjs/features/remoteControls.js.map +1 -1
  500. package/lib/commonjs/features/sleepTimer.js +33 -11
  501. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  502. package/lib/commonjs/native.js +5 -0
  503. package/lib/commonjs/native.js.map +1 -1
  504. package/lib/commonjs/native.web.js +4 -1
  505. package/lib/commonjs/native.web.js.map +1 -1
  506. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  507. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  508. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -17
  509. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  510. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -19
  511. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  512. package/lib/commonjs/utils/artwork.js +31 -0
  513. package/lib/commonjs/utils/artwork.js.map +1 -0
  514. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  515. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  516. package/lib/commonjs/utils/useDebug.js +16 -3
  517. package/lib/commonjs/utils/useDebug.js.map +1 -1
  518. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  519. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  520. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  521. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  522. package/lib/commonjs/web/NativeAudioBrowser.js +482 -177
  523. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  524. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  525. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  526. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +87 -0
  527. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -0
  528. package/lib/commonjs/web/TrackPlayer/PlaybackTimer.js +34 -0
  529. package/lib/commonjs/web/TrackPlayer/PlaybackTimer.js.map +1 -0
  530. package/lib/commonjs/web/TrackPlayer/Player.js +321 -41
  531. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  532. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +21 -0
  533. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js.map +1 -0
  534. package/lib/commonjs/web/TrackPlayer/QueueManager.js +287 -0
  535. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -0
  536. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +178 -0
  537. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -0
  538. package/lib/commonjs/web/TrackPlayer/RepeatMode.js +1 -1
  539. package/lib/commonjs/web/TrackPlayer/RepeatMode.js.map +1 -1
  540. package/lib/commonjs/web/TrackPlayer/SleepTimer.js +34 -3
  541. package/lib/commonjs/web/TrackPlayer/SleepTimer.js.map +1 -1
  542. package/lib/commonjs/web/TrackPlayer/VolumeFader.js +75 -0
  543. package/lib/commonjs/web/TrackPlayer/VolumeFader.js.map +1 -0
  544. package/lib/commonjs/web/TrackPlayer/index.js +13 -5
  545. package/lib/commonjs/web/TrackPlayer/index.js.map +1 -1
  546. package/lib/commonjs/web/browser/BrowserManager.js +341 -140
  547. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  548. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  549. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  550. package/lib/commonjs/web/browser/NavigationErrorManager.js +6 -2
  551. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  552. package/lib/commonjs/web/browser/SearchManager.js +22 -25
  553. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  554. package/lib/commonjs/web/browser/assertBrowsePageShape.js +22 -0
  555. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -0
  556. package/lib/commonjs/web/browser/classifyTrackNavigation.js +41 -0
  557. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -0
  558. package/lib/commonjs/web/browser/parseSearchResponse.js +19 -0
  559. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -0
  560. package/lib/commonjs/web/browser/sections.js +89 -0
  561. package/lib/commonjs/web/browser/sections.js.map +1 -0
  562. package/lib/commonjs/web/http/HttpClient.js +4 -23
  563. package/lib/commonjs/web/http/HttpClient.js.map +1 -1
  564. package/lib/commonjs/web/http/RequestConfigBuilder.js +194 -62
  565. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  566. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  567. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  568. package/lib/commonjs/web/playbackErrorKind.js +57 -0
  569. package/lib/commonjs/web/playbackErrorKind.js.map +1 -0
  570. package/lib/commonjs/web/player/MediaSessionManager.js +121 -0
  571. package/lib/commonjs/web/player/MediaSessionManager.js.map +1 -0
  572. package/lib/commonjs/web/player/NowPlayingManager.js +10 -8
  573. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  574. package/lib/commonjs/web/player/OptionsManager.js +9 -17
  575. package/lib/commonjs/web/player/OptionsManager.js.map +1 -1
  576. package/lib/commonjs/web/player/RemoteCommandController.js +96 -0
  577. package/lib/commonjs/web/player/RemoteCommandController.js.map +1 -0
  578. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  579. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  580. package/lib/module/AudioBrowser.js +2 -1
  581. package/lib/module/AudioBrowser.js.map +1 -1
  582. package/lib/module/CLAUDE.md +57 -0
  583. package/lib/module/features/battery.js +16 -12
  584. package/lib/module/features/battery.js.map +1 -1
  585. package/lib/module/features/browser-config.js +225 -0
  586. package/lib/module/features/browser-config.js.map +1 -0
  587. package/lib/module/features/browser.js +123 -168
  588. package/lib/module/features/browser.js.map +1 -1
  589. package/lib/module/features/carConnection.js +36 -0
  590. package/lib/module/features/carConnection.js.map +1 -0
  591. package/lib/module/features/equalizer.js +10 -6
  592. package/lib/module/features/equalizer.js.map +1 -1
  593. package/lib/module/features/errors.js +59 -13
  594. package/lib/module/features/errors.js.map +1 -1
  595. package/lib/module/features/favorites.js +29 -24
  596. package/lib/module/features/favorites.js.map +1 -1
  597. package/lib/module/features/gate.js +165 -0
  598. package/lib/module/features/gate.js.map +1 -0
  599. package/lib/module/features/index.js +2 -0
  600. package/lib/module/features/index.js.map +1 -1
  601. package/lib/module/features/metadata.js +62 -14
  602. package/lib/module/features/metadata.js.map +1 -1
  603. package/lib/module/features/network.js +6 -2
  604. package/lib/module/features/network.js.map +1 -1
  605. package/lib/module/features/nowPlaying.js +53 -6
  606. package/lib/module/features/nowPlaying.js.map +1 -1
  607. package/lib/module/features/output.js +37 -19
  608. package/lib/module/features/output.js.map +1 -1
  609. package/lib/module/features/playback/controls.js +19 -4
  610. package/lib/module/features/playback/controls.js.map +1 -1
  611. package/lib/module/features/playback/index.js +1 -0
  612. package/lib/module/features/playback/index.js.map +1 -1
  613. package/lib/module/features/playback/playWhenReady.js +6 -5
  614. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  615. package/lib/module/features/playback/playing.js +5 -3
  616. package/lib/module/features/playback/playing.js.map +1 -1
  617. package/lib/module/features/playback/progress.js +40 -17
  618. package/lib/module/features/playback/progress.js.map +1 -1
  619. package/lib/module/features/playback/rate.js +8 -1
  620. package/lib/module/features/playback/rate.js.map +1 -1
  621. package/lib/module/features/playback/state.js +5 -6
  622. package/lib/module/features/playback/state.js.map +1 -1
  623. package/lib/module/features/playback/trackPlaybackTime.js +88 -0
  624. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -0
  625. package/lib/module/features/playback/volume.js +6 -5
  626. package/lib/module/features/playback/volume.js.map +1 -1
  627. package/lib/module/features/player/options.js +99 -39
  628. package/lib/module/features/player/options.js.map +1 -1
  629. package/lib/module/features/player/setup.js +258 -4
  630. package/lib/module/features/player/setup.js.map +1 -1
  631. package/lib/module/features/player/validateOptions.js +19 -0
  632. package/lib/module/features/player/validateOptions.js.map +1 -0
  633. package/lib/module/features/queue/activeTrack.js +15 -5
  634. package/lib/module/features/queue/activeTrack.js.map +1 -1
  635. package/lib/module/features/queue/queue.js +76 -24
  636. package/lib/module/features/queue/queue.js.map +1 -1
  637. package/lib/module/features/queue/repeatMode.js +3 -2
  638. package/lib/module/features/queue/repeatMode.js.map +1 -1
  639. package/lib/module/features/queue/shuffle.js +1 -2
  640. package/lib/module/features/queue/shuffle.js.map +1 -1
  641. package/lib/module/features/remoteControls.js +70 -136
  642. package/lib/module/features/remoteControls.js.map +1 -1
  643. package/lib/module/features/sleepTimer.js +34 -12
  644. package/lib/module/features/sleepTimer.js.map +1 -1
  645. package/lib/module/native.js +5 -0
  646. package/lib/module/native.js.map +1 -1
  647. package/lib/module/native.web.js +4 -1
  648. package/lib/module/native.web.js.map +1 -1
  649. package/lib/module/test-utils/reactNativeStub.js +58 -0
  650. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  651. package/lib/module/utils/LazyNativeEmitter.js +25 -17
  652. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  653. package/lib/module/utils/NativeUpdatedValue.js +32 -19
  654. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  655. package/lib/module/utils/artwork.js +26 -0
  656. package/lib/module/utils/artwork.js.map +1 -0
  657. package/lib/module/utils/getTrackIdentity.js +22 -0
  658. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  659. package/lib/module/utils/useDebug.js +16 -3
  660. package/lib/module/utils/useDebug.js.map +1 -1
  661. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  662. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  663. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  664. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  665. package/lib/module/web/NativeAudioBrowser.js +483 -178
  666. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  667. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  668. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  669. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +83 -0
  670. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -0
  671. package/lib/module/web/TrackPlayer/PlaybackTimer.js +29 -0
  672. package/lib/module/web/TrackPlayer/PlaybackTimer.js.map +1 -0
  673. package/lib/module/web/TrackPlayer/Player.js +321 -41
  674. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  675. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +17 -0
  676. package/lib/module/web/TrackPlayer/PlayingStateFactory.js.map +1 -0
  677. package/lib/module/web/TrackPlayer/QueueManager.js +283 -0
  678. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -0
  679. package/lib/module/web/TrackPlayer/QueuePlayer.js +174 -0
  680. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -0
  681. package/lib/module/web/TrackPlayer/RepeatMode.js +1 -1
  682. package/lib/module/web/TrackPlayer/RepeatMode.js.map +1 -1
  683. package/lib/module/web/TrackPlayer/SleepTimer.js +34 -3
  684. package/lib/module/web/TrackPlayer/SleepTimer.js.map +1 -1
  685. package/lib/module/web/TrackPlayer/VolumeFader.js +70 -0
  686. package/lib/module/web/TrackPlayer/VolumeFader.js.map +1 -0
  687. package/lib/module/web/TrackPlayer/index.js +2 -1
  688. package/lib/module/web/TrackPlayer/index.js.map +1 -1
  689. package/lib/module/web/browser/BrowserManager.js +341 -140
  690. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  691. package/lib/module/web/browser/FavoriteManager.js +31 -21
  692. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  693. package/lib/module/web/browser/NavigationErrorManager.js +6 -2
  694. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  695. package/lib/module/web/browser/SearchManager.js +22 -25
  696. package/lib/module/web/browser/SearchManager.js.map +1 -1
  697. package/lib/module/web/browser/assertBrowsePageShape.js +18 -0
  698. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -0
  699. package/lib/module/web/browser/classifyTrackNavigation.js +38 -0
  700. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -0
  701. package/lib/module/web/browser/parseSearchResponse.js +15 -0
  702. package/lib/module/web/browser/parseSearchResponse.js.map +1 -0
  703. package/lib/module/web/browser/sections.js +83 -0
  704. package/lib/module/web/browser/sections.js.map +1 -0
  705. package/lib/module/web/http/HttpClient.js +4 -23
  706. package/lib/module/web/http/HttpClient.js.map +1 -1
  707. package/lib/module/web/http/RequestConfigBuilder.js +194 -62
  708. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  709. package/lib/module/web/http/followMediaRedirect.js +215 -0
  710. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  711. package/lib/module/web/playbackErrorKind.js +52 -0
  712. package/lib/module/web/playbackErrorKind.js.map +1 -0
  713. package/lib/module/web/player/MediaSessionManager.js +116 -0
  714. package/lib/module/web/player/MediaSessionManager.js.map +1 -0
  715. package/lib/module/web/player/NowPlayingManager.js +11 -8
  716. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  717. package/lib/module/web/player/OptionsManager.js +9 -17
  718. package/lib/module/web/player/OptionsManager.js.map +1 -1
  719. package/lib/module/web/player/RemoteCommandController.js +92 -0
  720. package/lib/module/web/player/RemoteCommandController.js.map +1 -0
  721. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  722. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  723. package/lib/typescript/package.json +1 -0
  724. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  725. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  726. package/lib/typescript/src/features/battery.d.ts +17 -12
  727. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  728. package/lib/typescript/src/features/browser-config.d.ts +12 -0
  729. package/lib/typescript/src/features/browser-config.d.ts.map +1 -0
  730. package/lib/typescript/src/features/browser.d.ts +99 -12
  731. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  732. package/lib/typescript/src/features/carConnection.d.ts +19 -0
  733. package/lib/typescript/src/features/carConnection.d.ts.map +1 -0
  734. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  735. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  736. package/lib/typescript/src/features/errors.d.ts +84 -14
  737. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  738. package/lib/typescript/src/features/favorites.d.ts +29 -24
  739. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  740. package/lib/typescript/src/features/gate.d.ts +99 -0
  741. package/lib/typescript/src/features/gate.d.ts.map +1 -0
  742. package/lib/typescript/src/features/index.d.ts +2 -0
  743. package/lib/typescript/src/features/index.d.ts.map +1 -1
  744. package/lib/typescript/src/features/metadata.d.ts +74 -21
  745. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  746. package/lib/typescript/src/features/network.d.ts +6 -2
  747. package/lib/typescript/src/features/network.d.ts.map +1 -1
  748. package/lib/typescript/src/features/nowPlaying.d.ts +47 -6
  749. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  750. package/lib/typescript/src/features/output.d.ts +33 -18
  751. package/lib/typescript/src/features/output.d.ts.map +1 -1
  752. package/lib/typescript/src/features/playback/controls.d.ts +16 -4
  753. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  754. package/lib/typescript/src/features/playback/index.d.ts +1 -0
  755. package/lib/typescript/src/features/playback/index.d.ts.map +1 -1
  756. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  757. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  758. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  759. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  760. package/lib/typescript/src/features/playback/progress.d.ts +14 -5
  761. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  762. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  763. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  764. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  765. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  766. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +41 -0
  767. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -0
  768. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  769. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  770. package/lib/typescript/src/features/player/options.d.ts +211 -145
  771. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  772. package/lib/typescript/src/features/player/setup.d.ts +288 -186
  773. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  774. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  775. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  776. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  777. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  778. package/lib/typescript/src/features/queue/queue.d.ts +65 -20
  779. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  780. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  781. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  782. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  783. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  784. package/lib/typescript/src/features/remoteControls.d.ts +81 -60
  785. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  786. package/lib/typescript/src/features/sleepTimer.d.ts +34 -11
  787. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  788. package/lib/typescript/src/index.d.ts.map +1 -1
  789. package/lib/typescript/src/native.d.ts +1 -2
  790. package/lib/typescript/src/native.d.ts.map +1 -1
  791. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +16 -225
  792. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  793. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  794. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  795. package/lib/typescript/src/types/browser-native.d.ts +10 -3
  796. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  797. package/lib/typescript/src/types/browser-nodes.d.ts +474 -84
  798. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  799. package/lib/typescript/src/types/browser.d.ts +518 -179
  800. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  801. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -18
  802. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  803. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -22
  804. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  805. package/lib/typescript/src/utils/artwork.d.ts +19 -0
  806. package/lib/typescript/src/utils/artwork.d.ts.map +1 -0
  807. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  808. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  809. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  810. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  811. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  812. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  813. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  814. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  815. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  816. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  817. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +3 -2
  818. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +28 -12
  819. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +8 -8
  820. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +12 -22
  822. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  825. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +43 -6
  826. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +61 -0
  827. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  830. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JBrowseResult.hpp +24 -7
  832. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  833. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +5 -5
  834. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  835. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  837. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  838. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  839. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +16 -5
  840. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  841. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +105 -0
  842. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +5 -4
  843. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +112 -0
  844. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +121 -0
  845. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +128 -0
  846. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  847. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +138 -0
  848. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +126 -0
  849. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +139 -0
  850. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  851. 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
  852. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +16 -5
  853. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +134 -0
  854. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +26 -12
  855. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +16 -4
  856. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  857. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +143 -0
  858. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  859. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  860. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  861. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  862. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +16 -5
  863. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +79 -0
  864. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  865. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -12
  866. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +13 -11
  867. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +80 -0
  868. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +4 -2
  869. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +16 -5
  870. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +4 -2
  871. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  872. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  873. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  874. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  875. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  876. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  877. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  878. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  879. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  880. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  881. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  882. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  883. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  884. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +12 -12
  885. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  886. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  887. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +23 -5
  888. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  889. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  890. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  891. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +30 -18
  892. package/nitrogen/generated/android/c++/JGate.hpp +62 -0
  893. package/nitrogen/generated/android/c++/JGateDecision.hpp +64 -0
  894. package/nitrogen/generated/android/c++/JGateEvent.hpp +58 -0
  895. package/nitrogen/generated/android/c++/JGateReason.hpp +58 -0
  896. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  897. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  898. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +317 -255
  899. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +30 -25
  900. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  901. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  902. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  903. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  904. package/nitrogen/generated/android/c++/JIOSOptions.hpp +101 -0
  905. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  906. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  907. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  908. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  909. package/nitrogen/generated/android/c++/JMediaReference.hpp +58 -0
  910. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +43 -6
  911. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  912. package/nitrogen/generated/android/c++/{JPartialAndroidSetupPlayerOptions.hpp → JNativeAndroidSetupOptions.hpp} +10 -10
  913. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +100 -40
  914. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +74 -0
  915. package/nitrogen/generated/android/c++/{JPartialIOSSetupPlayerOptions.hpp → JNativeIOSSetupOptions.hpp} +18 -18
  916. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +36 -13
  917. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +191 -0
  918. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +20 -26
  919. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  920. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  921. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  922. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +8 -2
  923. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +12 -22
  924. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +102 -0
  925. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +5 -19
  926. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +9 -5
  927. package/nitrogen/generated/android/c++/JOptions.hpp +18 -16
  928. package/nitrogen/generated/android/c++/{JIosOutput.hpp → JOutput.hpp} +15 -15
  929. package/nitrogen/generated/android/c++/JOutputType.hpp +88 -0
  930. package/nitrogen/generated/android/c++/JPlayback.hpp +4 -2
  931. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +16 -5
  932. package/nitrogen/generated/android/c++/JPlaybackError.hpp +20 -5
  933. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +4 -2
  934. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +76 -0
  935. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  936. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  937. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  938. package/nitrogen/generated/android/c++/JPlaybackState.hpp +5 -5
  939. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +2 -2
  940. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  941. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  942. package/nitrogen/generated/android/c++/{JNotificationButton.hpp → JRemoteButton.hpp} +20 -20
  943. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +86 -0
  944. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  945. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  946. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  947. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  948. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  949. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  950. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  951. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  952. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  953. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  954. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +85 -59
  955. package/nitrogen/generated/android/c++/JRetryConfig.hpp +13 -9
  956. package/nitrogen/generated/android/c++/JSearchMode.hpp +29 -11
  957. package/nitrogen/generated/android/c++/JSearchParams.hpp +11 -5
  958. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  959. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  960. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  961. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  962. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  963. package/nitrogen/generated/android/c++/JStallReason.hpp +58 -0
  964. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  965. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  966. package/nitrogen/generated/android/c++/JTrack.hpp +45 -48
  967. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +31 -15
  968. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  969. package/nitrogen/generated/android/c++/JTrackRequest.hpp +93 -0
  970. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  971. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +16 -3
  972. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  973. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  974. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  975. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.cpp +26 -0
  976. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +75 -0
  977. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.cpp +41 -0
  978. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +133 -0
  979. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.cpp +26 -0
  980. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +70 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioContentType.kt +4 -4
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +20 -9
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{RatingType.kt → ArtworkRendering.kt} +5 -10
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +47 -4
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +56 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayNowPlayingButton.kt +3 -3
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{NotificationButton.kt → CarPlayPlayingIndicatorLocation.kt} +5 -8
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +71 -0
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +17 -2
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +78 -0
  1002. 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 +78 -0
  1003. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +78 -0
  1004. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  1005. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +78 -0
  1006. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +78 -0
  1007. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +78 -0
  1008. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  1009. 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
  1010. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  1011. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +78 -0
  1012. 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
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.kt → Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt} +12 -14
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  1018. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  1019. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  1020. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  1021. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_void_RemoteSetRatingEvent.kt → Func_void_GateEvent.kt} +9 -11
  1022. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  1023. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  1024. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  1025. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_void_IosOutput.kt → Func_void_Output.kt} +9 -11
  1026. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  1027. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  1028. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  1029. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  1030. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  1031. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  1032. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  1033. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  1034. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  1035. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  1036. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  1037. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  1038. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  1039. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  1040. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  1041. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  1042. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +9 -11
  1043. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  1044. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  1045. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  1046. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  1047. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  1048. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  1049. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  1050. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +56 -0
  1051. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +56 -0
  1052. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +51 -0
  1053. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateReason.kt +23 -0
  1054. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  1055. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +114 -110
  1056. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +66 -0
  1057. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  1058. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  1059. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  1060. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  1061. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaReference.kt +23 -0
  1062. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +45 -4
  1063. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  1064. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{PartialAndroidSetupPlayerOptions.kt → NativeAndroidSetupOptions.kt} +36 -5
  1065. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +64 -6
  1066. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +61 -0
  1067. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +71 -0
  1068. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +31 -4
  1069. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +100 -0
  1070. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +29 -6
  1071. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  1072. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  1073. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  1074. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorType.kt +3 -1
  1075. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +20 -9
  1076. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +66 -0
  1077. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +32 -6
  1078. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +23 -3
  1079. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +26 -3
  1080. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +61 -0
  1081. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +33 -0
  1082. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  1083. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  1084. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +33 -3
  1085. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  1086. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorKind.kt +29 -0
  1087. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  1088. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  1089. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  1090. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackState.kt +6 -6
  1091. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +35 -0
  1092. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  1093. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  1094. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButton.kt +26 -0
  1095. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +61 -0
  1096. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  1097. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  1098. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  1099. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  1100. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  1101. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  1102. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  1103. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  1104. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  1105. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +74 -13
  1106. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +24 -4
  1107. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchMode.kt +12 -6
  1108. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +33 -3
  1109. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  1110. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  1111. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  1112. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  1113. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  1114. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StallReason.kt +23 -0
  1115. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  1116. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  1117. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +62 -10
  1118. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +25 -3
  1119. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  1120. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +61 -0
  1121. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  1122. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +38 -4
  1123. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  1124. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  1125. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  1126. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Variant_NullType_NotificationButtonLayout.kt → Variant_NullType_RemoteButtonLayout.kt} +24 -15
  1127. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +75 -0
  1128. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +62 -0
  1129. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1130. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +162 -42
  1131. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +1476 -684
  1132. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +91 -49
  1133. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +219 -124
  1134. package/nitrogen/generated/ios/swift/AndroidAudioContentType.swift +8 -8
  1135. package/nitrogen/generated/ios/swift/AndroidOptions.swift +12 -22
  1136. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1137. package/nitrogen/generated/ios/swift/ArtworkRequestConfig.swift +95 -1
  1138. package/nitrogen/generated/ios/swift/ArtworkVariants.swift +34 -0
  1139. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1140. package/nitrogen/generated/ios/swift/CarPlayNowPlayingButton.swift +4 -4
  1141. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1142. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1143. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1144. package/nitrogen/generated/ios/swift/FormatNowPlayingParams.swift +67 -0
  1145. package/nitrogen/generated/ios/swift/FormattedNavigationError.swift +17 -4
  1146. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.swift +54 -0
  1147. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.swift +69 -0
  1148. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___Track.swift +54 -0
  1149. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.swift +60 -0
  1150. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__optional_std__string____Track.swift +60 -0
  1151. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.swift +61 -0
  1152. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.swift +61 -0
  1153. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1154. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.swift +77 -0
  1155. package/nitrogen/generated/ios/swift/Func_void_GateDecision.swift +46 -0
  1156. package/nitrogen/generated/ios/swift/{Func_void_RemoteSetRatingEvent.swift → Func_void_GateEvent.swift} +10 -10
  1157. package/nitrogen/generated/ios/swift/{Func_void_IosOutput.swift → Func_void_Output.swift} +10 -10
  1158. package/nitrogen/generated/ios/swift/Func_void_TransformableRequestConfig.swift +46 -0
  1159. package/nitrogen/generated/ios/swift/Func_void_bool.swift +5 -5
  1160. package/nitrogen/generated/ios/swift/Func_void_std__optional_NowPlayingUpdate_.swift +46 -0
  1161. package/nitrogen/generated/ios/swift/Func_void_std__optional_std__string_.swift +53 -0
  1162. package/nitrogen/generated/ios/swift/{Func_void_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError___.swift → Func_void_std__shared_ptr_Promise_GateDecision__.swift} +17 -17
  1163. package/nitrogen/generated/ios/swift/Func_void_std__shared_ptr_Promise_TransformableRequestConfig__.swift +66 -0
  1164. package/nitrogen/generated/ios/swift/Func_void_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError____.swift +81 -0
  1165. package/nitrogen/generated/ios/swift/Gate.swift +47 -0
  1166. package/nitrogen/generated/ios/swift/GateDecision.swift +40 -0
  1167. package/nitrogen/generated/ios/swift/GateEvent.swift +29 -0
  1168. package/nitrogen/generated/ios/swift/GateReason.swift +40 -0
  1169. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1170. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +23 -15
  1171. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +262 -199
  1172. package/nitrogen/generated/ios/swift/IOSOptions.swift +56 -0
  1173. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1174. package/nitrogen/generated/ios/swift/MediaReference.swift +40 -0
  1175. package/nitrogen/generated/ios/swift/MediaRequestConfig.swift +107 -1
  1176. package/nitrogen/generated/ios/swift/{PartialAndroidSetupPlayerOptions.swift → NativeAndroidSetupOptions.swift} +5 -5
  1177. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +208 -22
  1178. package/nitrogen/generated/ios/swift/NativeGateRequest.swift +58 -0
  1179. package/nitrogen/generated/ios/swift/{PartialIOSSetupPlayerOptions.swift → NativeIOSSetupOptions.swift} +5 -5
  1180. package/nitrogen/generated/ios/swift/NativeRouteEntry.swift +19 -19
  1181. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +217 -0
  1182. package/nitrogen/generated/ios/swift/NativeUpdateOptions.swift +12 -25
  1183. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1184. package/nitrogen/generated/ios/swift/NavigationErrorType.swift +8 -0
  1185. package/nitrogen/generated/ios/swift/NitroAndroidUpdateOptions.swift +12 -41
  1186. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +101 -0
  1187. package/nitrogen/generated/ios/swift/NowPlayingMetadata.swift +1 -48
  1188. package/nitrogen/generated/ios/swift/NowPlayingUpdate.swift +19 -1
  1189. package/nitrogen/generated/ios/swift/Options.swift +10 -4
  1190. package/nitrogen/generated/ios/swift/{IosOutput.swift → Output.swift} +7 -7
  1191. package/nitrogen/generated/ios/swift/OutputType.swift +80 -0
  1192. package/nitrogen/generated/ios/swift/PlaybackError.swift +43 -2
  1193. package/nitrogen/generated/ios/swift/PlaybackErrorKind.swift +64 -0
  1194. package/nitrogen/generated/ios/swift/PlaybackState.swift +4 -4
  1195. package/nitrogen/generated/ios/swift/{NotificationButton.swift → RemoteButton.swift} +10 -10
  1196. package/nitrogen/generated/ios/swift/RemoteButtonLayout.swift +57 -0
  1197. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1198. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +125 -70
  1199. package/nitrogen/generated/ios/swift/RetryConfig.swift +35 -4
  1200. package/nitrogen/generated/ios/swift/SearchMode.swift +36 -12
  1201. package/nitrogen/generated/ios/swift/SearchParams.swift +7 -2
  1202. package/nitrogen/generated/ios/swift/{ImageRowItem.swift → Section.swift} +33 -27
  1203. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1204. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1205. package/nitrogen/generated/ios/swift/StallReason.swift +40 -0
  1206. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1207. package/nitrogen/generated/ios/swift/Track.swift +91 -60
  1208. package/nitrogen/generated/ios/swift/TrackLoadEvent.swift +20 -2
  1209. package/nitrogen/generated/ios/swift/TrackRequest.swift +106 -0
  1210. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1211. package/nitrogen/generated/ios/swift/TransformableRequestConfig.swift +60 -1
  1212. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1213. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1214. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1215. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +30 -0
  1216. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +32 -0
  1217. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +30 -0
  1218. package/nitrogen/generated/shared/c++/AndroidAudioContentType.hpp +10 -10
  1219. package/nitrogen/generated/shared/c++/AndroidOptions.hpp +8 -19
  1220. package/nitrogen/generated/shared/c++/ArtworkRendering.hpp +76 -0
  1221. package/nitrogen/generated/shared/c++/ArtworkRequestConfig.hpp +10 -2
  1222. package/nitrogen/generated/shared/c++/{HeartRating.hpp → ArtworkVariants.hpp} +20 -16
  1223. package/nitrogen/generated/shared/c++/CarPlayNowPlayingButton.hpp +6 -6
  1224. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1225. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1226. package/nitrogen/generated/shared/c++/EqualizerSettings.hpp +0 -2
  1227. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1228. package/nitrogen/generated/shared/c++/FormatNowPlayingParams.hpp +110 -0
  1229. package/nitrogen/generated/shared/c++/FormattedNavigationError.hpp +6 -5
  1230. package/nitrogen/generated/shared/c++/{StarRating.hpp → Gate.hpp} +21 -16
  1231. package/nitrogen/generated/shared/c++/{ThumbsRating.hpp → GateDecision.hpp} +23 -17
  1232. package/nitrogen/generated/shared/c++/{PercentageRating.hpp → GateEvent.hpp} +18 -17
  1233. package/nitrogen/generated/shared/c++/GateReason.hpp +76 -0
  1234. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1235. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +24 -19
  1236. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +47 -36
  1237. package/nitrogen/generated/shared/c++/IOSOptions.hpp +98 -0
  1238. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1239. package/nitrogen/generated/shared/c++/MediaReference.hpp +76 -0
  1240. package/nitrogen/generated/shared/c++/MediaRequestConfig.hpp +10 -2
  1241. package/nitrogen/generated/shared/c++/{PartialAndroidSetupPlayerOptions.hpp → NativeAndroidSetupOptions.hpp} +11 -11
  1242. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +35 -15
  1243. package/nitrogen/generated/shared/c++/NativeGateRequest.hpp +97 -0
  1244. package/nitrogen/generated/shared/c++/{PartialIOSSetupPlayerOptions.hpp → NativeIOSSetupOptions.hpp} +11 -11
  1245. package/nitrogen/generated/shared/c++/NativeRouteEntry.hpp +5 -5
  1246. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +145 -0
  1247. package/nitrogen/generated/shared/c++/NativeUpdateOptions.hpp +9 -7
  1248. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1249. package/nitrogen/generated/shared/c++/NavigationErrorType.hpp +8 -0
  1250. package/nitrogen/generated/shared/c++/NitroAndroidUpdateOptions.hpp +8 -19
  1251. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +99 -0
  1252. package/nitrogen/generated/shared/c++/NowPlayingMetadata.hpp +3 -19
  1253. package/nitrogen/generated/shared/c++/NowPlayingUpdate.hpp +6 -2
  1254. package/nitrogen/generated/shared/c++/Options.hpp +8 -8
  1255. package/nitrogen/generated/shared/c++/{IosOutput.hpp → Output.hpp} +18 -18
  1256. package/nitrogen/generated/shared/c++/OutputType.hpp +116 -0
  1257. package/nitrogen/generated/shared/c++/PlaybackError.hpp +18 -3
  1258. package/nitrogen/generated/shared/c++/PlaybackErrorKind.hpp +100 -0
  1259. package/nitrogen/generated/shared/c++/PlaybackState.hpp +9 -9
  1260. package/nitrogen/generated/shared/c++/{NotificationButton.hpp → RemoteButton.hpp} +25 -25
  1261. package/nitrogen/generated/shared/c++/RemoteButtonLayout.hpp +94 -0
  1262. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1263. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +52 -37
  1264. package/nitrogen/generated/shared/c++/RetryConfig.hpp +10 -6
  1265. package/nitrogen/generated/shared/c++/SearchMode.hpp +39 -15
  1266. package/nitrogen/generated/shared/c++/SearchParams.hpp +9 -2
  1267. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1268. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1269. package/nitrogen/generated/shared/c++/StallReason.hpp +76 -0
  1270. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1271. package/nitrogen/generated/shared/c++/Track.hpp +37 -30
  1272. package/nitrogen/generated/shared/c++/TrackLoadEvent.hpp +7 -2
  1273. package/nitrogen/generated/shared/c++/TrackRequest.hpp +93 -0
  1274. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1275. package/nitrogen/generated/shared/c++/TransformableRequestConfig.hpp +6 -2
  1276. package/package.json +50 -20
  1277. package/src/AudioBrowser.ts +2 -1
  1278. package/src/CLAUDE.md +57 -0
  1279. package/src/codegen-no-config-variant.test.ts +70 -0
  1280. package/src/docs-floors.test.ts +71 -0
  1281. package/src/features/battery.test.ts +79 -0
  1282. package/src/features/battery.ts +17 -13
  1283. package/src/features/browser-config.test.ts +125 -0
  1284. package/src/features/browser-config.ts +297 -0
  1285. package/src/features/browser.test.ts +19 -0
  1286. package/src/features/browser.ts +119 -213
  1287. package/src/features/carConnection.ts +35 -0
  1288. package/src/features/equalizer.ts +10 -6
  1289. package/src/features/errors.ts +94 -13
  1290. package/src/features/favorites.ts +29 -24
  1291. package/src/features/gate.test.ts +72 -0
  1292. package/src/features/gate.ts +176 -0
  1293. package/src/features/hook-wiring.test.ts +302 -0
  1294. package/src/features/index.ts +2 -0
  1295. package/src/features/metadata.ts +89 -29
  1296. package/src/features/network.ts +6 -2
  1297. package/src/features/nowPlaying.ts +56 -6
  1298. package/src/features/output.ts +40 -22
  1299. package/src/features/playback/controls.ts +19 -4
  1300. package/src/features/playback/index.ts +1 -0
  1301. package/src/features/playback/playWhenReady.ts +6 -5
  1302. package/src/features/playback/playing.ts +16 -3
  1303. package/src/features/playback/progress.test.ts +169 -0
  1304. package/src/features/playback/progress.ts +43 -17
  1305. package/src/features/playback/rate.ts +8 -1
  1306. package/src/features/playback/state.ts +10 -6
  1307. package/src/features/playback/trackPlaybackTime.test.ts +76 -0
  1308. package/src/features/playback/trackPlaybackTime.ts +108 -0
  1309. package/src/features/playback/volume.ts +6 -5
  1310. package/src/features/player/options.test.ts +38 -0
  1311. package/src/features/player/options.ts +254 -128
  1312. package/src/features/player/setup.test.ts +134 -0
  1313. package/src/features/player/setup.ts +481 -194
  1314. package/src/features/player/validateOptions.ts +21 -0
  1315. package/src/features/queue/activeTrack.ts +15 -5
  1316. package/src/features/queue/queue.test.ts +36 -0
  1317. package/src/features/queue/queue.ts +80 -24
  1318. package/src/features/queue/repeatMode.ts +2 -2
  1319. package/src/features/queue/shuffle.ts +1 -2
  1320. package/src/features/remoteControls.ts +70 -148
  1321. package/src/features/sleepTimer.test.ts +171 -0
  1322. package/src/features/sleepTimer.ts +48 -13
  1323. package/src/native.ts +5 -0
  1324. package/src/native.web.ts +4 -1
  1325. package/src/nitro-stub-drift.test.ts +277 -0
  1326. package/src/public-surface.test.ts +147 -0
  1327. package/src/specs/audio-browser.nitro.ts +146 -42
  1328. package/src/style-resolution.test.ts +210 -0
  1329. package/src/test-utils/reactNativeStub.ts +60 -0
  1330. package/src/types/browser-native.ts +24 -7
  1331. package/src/types/browser-nodes.ts +505 -92
  1332. package/src/types/browser.ts +548 -183
  1333. package/src/utils/LazyNativeEmitter.ts +25 -17
  1334. package/src/utils/NativeUpdatedValue.ts +30 -18
  1335. package/src/utils/artwork.ts +30 -0
  1336. package/src/utils/getTrackIdentity.ts +22 -0
  1337. package/src/utils/useDebug.test.ts +182 -0
  1338. package/src/utils/useDebug.ts +16 -3
  1339. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1340. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1341. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1342. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1343. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +564 -0
  1344. package/src/web/NativeAudioBrowser.ts +588 -219
  1345. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1346. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +186 -0
  1347. package/src/web/TrackPlayer/PlaybackStateMachine.ts +98 -0
  1348. package/src/web/TrackPlayer/PlaybackTimer.test.ts +67 -0
  1349. package/src/web/TrackPlayer/PlaybackTimer.ts +33 -0
  1350. package/src/web/TrackPlayer/Player.dispatch.test.ts +274 -0
  1351. package/src/web/TrackPlayer/Player.load.test.ts +222 -0
  1352. package/src/web/TrackPlayer/Player.ts +377 -55
  1353. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +51 -0
  1354. package/src/web/TrackPlayer/PlayingStateFactory.ts +24 -0
  1355. package/src/web/TrackPlayer/QueueManager.test.ts +318 -0
  1356. package/src/web/TrackPlayer/QueueManager.ts +316 -0
  1357. package/src/web/TrackPlayer/QueuePlayer.ts +206 -0
  1358. package/src/web/TrackPlayer/RepeatMode.ts +1 -1
  1359. package/src/web/TrackPlayer/SleepTimer.ts +38 -3
  1360. package/src/web/TrackPlayer/VolumeFader.ts +74 -0
  1361. package/src/web/TrackPlayer/index.ts +2 -1
  1362. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1363. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1364. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1365. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1366. package/src/web/__tests__/retry.test.ts +169 -0
  1367. package/src/web/browser/BrowserManager.ts +421 -154
  1368. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1369. package/src/web/browser/FavoriteManager.ts +28 -23
  1370. package/src/web/browser/NavigationErrorManager.ts +6 -2
  1371. package/src/web/browser/SearchManager.test.ts +75 -0
  1372. package/src/web/browser/SearchManager.ts +26 -33
  1373. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1374. package/src/web/browser/__tests__/layer-resolver.test.ts +104 -0
  1375. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1376. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1377. package/src/web/browser/assertBrowsePageShape.test.ts +27 -0
  1378. package/src/web/browser/assertBrowsePageShape.ts +29 -0
  1379. package/src/web/browser/classifyTrackNavigation.test.ts +43 -0
  1380. package/src/web/browser/classifyTrackNavigation.ts +35 -0
  1381. package/src/web/browser/parseSearchResponse.test.ts +31 -0
  1382. package/src/web/browser/parseSearchResponse.ts +14 -0
  1383. package/src/web/browser/sections.test.ts +91 -0
  1384. package/src/web/browser/sections.ts +72 -0
  1385. package/src/web/http/HttpClient.ts +5 -35
  1386. package/src/web/http/RequestConfigBuilder.test.ts +299 -0
  1387. package/src/web/http/RequestConfigBuilder.ts +230 -66
  1388. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1389. package/src/web/http/followMediaRedirect.ts +253 -0
  1390. package/src/web/playbackErrorKind.test.ts +55 -0
  1391. package/src/web/playbackErrorKind.ts +56 -0
  1392. package/src/web/player/MediaSessionManager.test.ts +220 -0
  1393. package/src/web/player/MediaSessionManager.ts +151 -0
  1394. package/src/web/player/NowPlayingManager.test.ts +46 -0
  1395. package/src/web/player/NowPlayingManager.ts +10 -8
  1396. package/src/web/player/OptionsManager.ts +12 -18
  1397. package/src/web/player/RemoteCommandController.test.ts +171 -0
  1398. package/src/web/player/RemoteCommandController.ts +166 -0
  1399. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1400. package/src/web/util/BrowserPathHelper.ts +68 -13
  1401. package/website/guide/android-auto.md +126 -0
  1402. package/website/guide/android-certificates.md +488 -0
  1403. package/website/guide/artwork.md +300 -0
  1404. package/website/guide/audio-output.md +382 -0
  1405. package/website/guide/automotive.md +91 -0
  1406. package/website/guide/basic-usage.md +154 -0
  1407. package/website/guide/battery.md +142 -0
  1408. package/website/guide/browser.md +674 -0
  1409. package/website/guide/carplay.md +733 -0
  1410. package/website/guide/configuration.md +215 -0
  1411. package/website/guide/equalizer.md +235 -0
  1412. package/website/guide/errors.md +359 -0
  1413. package/website/guide/favorites.md +164 -0
  1414. package/website/guide/gate.md +157 -0
  1415. package/website/guide/getting-started.md +99 -0
  1416. package/website/guide/hooks.md +247 -0
  1417. package/website/guide/live-streams.md +218 -0
  1418. package/website/guide/metadata.md +289 -0
  1419. package/website/guide/migrating-from-track-player.md +289 -0
  1420. package/website/guide/native-callback-fetch.md +137 -0
  1421. package/website/guide/network.md +103 -0
  1422. package/website/guide/now-playing.md +203 -0
  1423. package/website/guide/playback.md +405 -0
  1424. package/website/guide/queue.md +334 -0
  1425. package/website/guide/remote-controls.md +314 -0
  1426. package/website/guide/search.md +270 -0
  1427. package/website/guide/sleep-timer.md +289 -0
  1428. package/website/guide/track.md +271 -0
  1429. package/android/src/main/java/com/audiobrowser/player/PlaybackProgressUpdateManager.kt +0 -59
  1430. package/android/src/main/java/com/audiobrowser/util/RatingFactory.kt +0 -72
  1431. package/android/src/main/java/com/audiobrowser/util/ResolvedTrackFactory.kt +0 -36
  1432. package/android/src/test/java/com/audiobrowser/player/PlaybackProgressUpdateManagerTest.kt +0 -146
  1433. package/ios/Bridge.h +0 -8
  1434. package/ios/Browser/BrowserManager+URLResolution.swift +0 -260
  1435. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -60
  1436. package/ios/CarPlay/Track+CarPlay.swift +0 -63
  1437. package/ios/Model/MediaURL.swift +0 -67
  1438. package/ios/Model/SourceType.swift +0 -6
  1439. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1440. package/ios/NowPlayingInfo/NowPlayingInfoCenter.swift +0 -9
  1441. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1442. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1443. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -79
  1444. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -110
  1445. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1446. package/ios/Observer/PlayerTimeObserver.swift +0 -105
  1447. package/ios/Option/PitchAlgorithms.swift +0 -17
  1448. package/ios/Option/TimeEventFrequency.swift +0 -18
  1449. package/ios/Player/LoadSeekCoordinator.swift +0 -84
  1450. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1451. package/ios/Player/PlaybackCoordinator.swift +0 -520
  1452. package/ios/Player/PlaybackEffectHandler.swift +0 -44
  1453. package/ios/Player/PlaybackErrorHandler.swift +0 -91
  1454. package/ios/Player/PlaybackProgressUpdateManager.swift +0 -68
  1455. package/ios/Player/PlayingStateManager.swift +0 -32
  1456. package/ios/Player/RetryManager.swift +0 -246
  1457. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1458. package/ios/Player/SleepTimerHandling.swift +0 -7
  1459. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1460. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -294
  1461. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -486
  1462. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -213
  1463. package/ios/Tests/PlaybackProgressUpdateManagerTests.swift +0 -166
  1464. package/ios/TrackPlayer.swift +0 -692
  1465. package/ios/TrackPlayerCallbacks.swift +0 -92
  1466. package/ios/Util/MetadataAdapter.swift +0 -131
  1467. package/ios/Util/OnceValue.swift +0 -70
  1468. package/lib/commonjs/features/rating.js +0 -2
  1469. package/lib/commonjs/features/rating.js.map +0 -1
  1470. package/lib/commonjs/types/player.js +0 -2
  1471. package/lib/commonjs/types/player.js.map +0 -1
  1472. package/lib/commonjs/web/SimpleRouter.test.js +0 -174
  1473. package/lib/commonjs/web/SimpleRouter.test.js.map +0 -1
  1474. package/lib/commonjs/web/TrackPlayer/PlaylistPlayer.js +0 -293
  1475. package/lib/commonjs/web/TrackPlayer/PlaylistPlayer.js.map +0 -1
  1476. package/lib/module/features/rating.js +0 -2
  1477. package/lib/module/features/rating.js.map +0 -1
  1478. package/lib/module/types/player.js +0 -2
  1479. package/lib/module/types/player.js.map +0 -1
  1480. package/lib/module/web/SimpleRouter.test.js +0 -174
  1481. package/lib/module/web/SimpleRouter.test.js.map +0 -1
  1482. package/lib/module/web/TrackPlayer/PlaylistPlayer.js +0 -288
  1483. package/lib/module/web/TrackPlayer/PlaylistPlayer.js.map +0 -1
  1484. package/lib/typescript/src/features/rating.d.ts +0 -14
  1485. package/lib/typescript/src/features/rating.d.ts.map +0 -1
  1486. package/lib/typescript/src/native.web.d.ts +0 -3
  1487. package/lib/typescript/src/native.web.d.ts.map +0 -1
  1488. package/lib/typescript/src/types/player.d.ts +0 -64
  1489. package/lib/typescript/src/types/player.d.ts.map +0 -1
  1490. package/lib/typescript/src/web/NativeAudioBrowser.d.ts +0 -188
  1491. package/lib/typescript/src/web/NativeAudioBrowser.d.ts.map +0 -1
  1492. package/lib/typescript/src/web/SimpleRouter.d.ts +0 -40
  1493. package/lib/typescript/src/web/SimpleRouter.d.ts.map +0 -1
  1494. package/lib/typescript/src/web/SimpleRouter.test.d.ts +0 -2
  1495. package/lib/typescript/src/web/SimpleRouter.test.d.ts.map +0 -1
  1496. package/lib/typescript/src/web/TrackPlayer/Event.d.ts +0 -11
  1497. package/lib/typescript/src/web/TrackPlayer/Event.d.ts.map +0 -1
  1498. package/lib/typescript/src/web/TrackPlayer/Player.d.ts +0 -59
  1499. package/lib/typescript/src/web/TrackPlayer/Player.d.ts.map +0 -1
  1500. package/lib/typescript/src/web/TrackPlayer/PlaylistPlayer.d.ts +0 -39
  1501. package/lib/typescript/src/web/TrackPlayer/PlaylistPlayer.d.ts.map +0 -1
  1502. package/lib/typescript/src/web/TrackPlayer/RepeatMode.d.ts +0 -6
  1503. package/lib/typescript/src/web/TrackPlayer/RepeatMode.d.ts.map +0 -1
  1504. package/lib/typescript/src/web/TrackPlayer/SetupNotCalledError.d.ts +0 -4
  1505. package/lib/typescript/src/web/TrackPlayer/SetupNotCalledError.d.ts.map +0 -1
  1506. package/lib/typescript/src/web/TrackPlayer/SleepTimer.d.ts +0 -34
  1507. package/lib/typescript/src/web/TrackPlayer/SleepTimer.d.ts.map +0 -1
  1508. package/lib/typescript/src/web/TrackPlayer/State.d.ts +0 -13
  1509. package/lib/typescript/src/web/TrackPlayer/State.d.ts.map +0 -1
  1510. package/lib/typescript/src/web/TrackPlayer/index.d.ts +0 -5
  1511. package/lib/typescript/src/web/TrackPlayer/index.d.ts.map +0 -1
  1512. package/lib/typescript/src/web/browser/BrowserManager.d.ts +0 -154
  1513. package/lib/typescript/src/web/browser/BrowserManager.d.ts.map +0 -1
  1514. package/lib/typescript/src/web/browser/FavoriteManager.d.ts +0 -42
  1515. package/lib/typescript/src/web/browser/FavoriteManager.d.ts.map +0 -1
  1516. package/lib/typescript/src/web/browser/NavigationErrorManager.d.ts +0 -40
  1517. package/lib/typescript/src/web/browser/NavigationErrorManager.d.ts.map +0 -1
  1518. package/lib/typescript/src/web/browser/SearchManager.d.ts +0 -22
  1519. package/lib/typescript/src/web/browser/SearchManager.d.ts.map +0 -1
  1520. package/lib/typescript/src/web/http/HttpClient.d.ts +0 -25
  1521. package/lib/typescript/src/web/http/HttpClient.d.ts.map +0 -1
  1522. package/lib/typescript/src/web/http/RequestConfigBuilder.d.ts +0 -98
  1523. package/lib/typescript/src/web/http/RequestConfigBuilder.d.ts.map +0 -1
  1524. package/lib/typescript/src/web/player/NowPlayingManager.d.ts +0 -34
  1525. package/lib/typescript/src/web/player/NowPlayingManager.d.ts.map +0 -1
  1526. package/lib/typescript/src/web/player/OptionsManager.d.ts +0 -32
  1527. package/lib/typescript/src/web/player/OptionsManager.d.ts.map +0 -1
  1528. package/lib/typescript/src/web/util/BrowserPathHelper.d.ts +0 -69
  1529. package/lib/typescript/src/web/util/BrowserPathHelper.d.ts.map +0 -1
  1530. package/lib/typescript/src/web/util/shuffle.d.ts +0 -8
  1531. package/lib/typescript/src/web/util/shuffle.d.ts.map +0 -1
  1532. package/nitrogen/generated/android/c++/JAndroidUpdateOptions.hpp +0 -86
  1533. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.hpp +0 -147
  1534. package/nitrogen/generated/android/c++/JFunc_void_IosOutput.hpp +0 -80
  1535. package/nitrogen/generated/android/c++/JFunc_void_RemoteSetRatingEvent.hpp +0 -87
  1536. package/nitrogen/generated/android/c++/JHeartRating.hpp +0 -57
  1537. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -75
  1538. package/nitrogen/generated/android/c++/JIosOutputType.hpp +0 -85
  1539. package/nitrogen/generated/android/c++/JNotificationButtonLayout.hpp +0 -94
  1540. package/nitrogen/generated/android/c++/JPartialSetupPlayerOptions.hpp +0 -96
  1541. package/nitrogen/generated/android/c++/JPercentageRating.hpp +0 -57
  1542. package/nitrogen/generated/android/c++/JRatingType.hpp +0 -73
  1543. package/nitrogen/generated/android/c++/JRemoteSetRatingEvent.hpp +0 -66
  1544. package/nitrogen/generated/android/c++/JStarRating.hpp +0 -57
  1545. package/nitrogen/generated/android/c++/JThumbsRating.hpp +0 -57
  1546. package/nitrogen/generated/android/c++/JUpdateOptions.hpp +0 -105
  1547. package/nitrogen/generated/android/c++/JVariant_HeartRating_ThumbsRating_StarRating_PercentageRating.cpp +0 -34
  1548. package/nitrogen/generated/android/c++/JVariant_HeartRating_ThumbsRating_StarRating_PercentageRating.hpp +0 -105
  1549. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp +0 -26
  1550. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.hpp +0 -75
  1551. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidUpdateOptions.kt +0 -50
  1552. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HeartRating.kt +0 -38
  1553. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -47
  1554. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IosOutput.kt +0 -44
  1555. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IosOutputType.kt +0 -32
  1556. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NotificationButtonLayout.kt +0 -50
  1557. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PartialIOSSetupPlayerOptions.kt +0 -50
  1558. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PartialSetupPlayerOptions.kt +0 -47
  1559. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PercentageRating.kt +0 -38
  1560. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSetRatingEvent.kt +0 -38
  1561. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StarRating.kt +0 -38
  1562. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ThumbsRating.kt +0 -38
  1563. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/UpdateOptions.kt +0 -53
  1564. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_HeartRating_ThumbsRating_StarRating_PercentageRating.kt +0 -77
  1565. package/nitrogen/generated/ios/swift/AndroidUpdateOptions.swift +0 -119
  1566. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.swift +0 -68
  1567. package/nitrogen/generated/ios/swift/HeartRating.swift +0 -29
  1568. package/nitrogen/generated/ios/swift/IosOutputType.swift +0 -76
  1569. package/nitrogen/generated/ios/swift/NotificationButtonLayout.swift +0 -92
  1570. package/nitrogen/generated/ios/swift/PartialSetupPlayerOptions.swift +0 -101
  1571. package/nitrogen/generated/ios/swift/PercentageRating.swift +0 -29
  1572. package/nitrogen/generated/ios/swift/RatingType.swift +0 -60
  1573. package/nitrogen/generated/ios/swift/RemoteSetRatingEvent.swift +0 -58
  1574. package/nitrogen/generated/ios/swift/StarRating.swift +0 -29
  1575. package/nitrogen/generated/ios/swift/ThumbsRating.swift +0 -29
  1576. package/nitrogen/generated/ios/swift/UpdateOptions.swift +0 -143
  1577. package/nitrogen/generated/ios/swift/Variant_HeartRating_ThumbsRating_StarRating_PercentageRating.swift +0 -20
  1578. package/nitrogen/generated/ios/swift/Variant_NullType_NotificationButtonLayout.swift +0 -18
  1579. package/nitrogen/generated/shared/c++/AndroidUpdateOptions.hpp +0 -109
  1580. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -98
  1581. package/nitrogen/generated/shared/c++/IosOutputType.hpp +0 -112
  1582. package/nitrogen/generated/shared/c++/NotificationButtonLayout.hpp +0 -102
  1583. package/nitrogen/generated/shared/c++/PartialSetupPlayerOptions.hpp +0 -104
  1584. package/nitrogen/generated/shared/c++/RatingType.hpp +0 -96
  1585. package/nitrogen/generated/shared/c++/RemoteSetRatingEvent.hpp +0 -94
  1586. package/nitrogen/generated/shared/c++/UpdateOptions.hpp +0 -111
  1587. package/src/features/rating.ts +0 -17
  1588. package/src/types/player.ts +0 -69
  1589. package/src/web/TrackPlayer/PlaylistPlayer.ts +0 -346
@@ -2,331 +2,341 @@ package com.audiobrowser.player
2
2
 
3
3
  import android.annotation.SuppressLint
4
4
  import android.content.Context
5
- import androidx.media3.common.AudioAttributes
5
+ import android.media.AudioManager
6
+ import android.os.Handler
7
+ import android.os.Looper
8
+ import android.os.SystemClock
9
+ import androidx.core.net.toUri
6
10
  import androidx.media3.common.C
7
- import androidx.media3.common.ForwardingPlayer
8
- import androidx.media3.common.HeartRating
9
11
  import androidx.media3.common.MediaItem
10
- import androidx.media3.common.TrackSelectionParameters
12
+ import androidx.media3.common.MediaMetadata
13
+ import androidx.media3.common.PlaybackException
14
+ import androidx.media3.common.Player as MediaPlayer
15
+ import androidx.media3.common.Timeline
11
16
  import androidx.media3.database.StandaloneDatabaseProvider
12
17
  import androidx.media3.datasource.cache.LeastRecentlyUsedCacheEvictor
13
18
  import androidx.media3.datasource.cache.SimpleCache
14
- import androidx.media3.exoplayer.DefaultRenderersFactory
15
19
  import androidx.media3.exoplayer.ExoPlayer
16
- import androidx.media3.exoplayer.upstream.DefaultBandwidthMeter
17
20
  import androidx.media3.session.MediaLibraryService
18
21
  import androidx.media3.session.MediaSession
19
22
  import com.audiobrowser.AudioBrowser
20
23
  import com.audiobrowser.Callbacks
24
+ import com.audiobrowser.browser.displayArtworkSource
25
+ import com.audiobrowser.browser.resolveArtworkUrl
26
+ import com.audiobrowser.browser.resolveMediaUrl
27
+ import com.audiobrowser.browser.unattributedArtworkSource
28
+ import com.audiobrowser.cast.createCastRemote
21
29
  import com.audiobrowser.extension.NumberExt.Companion.toSeconds
22
- import com.margelo.nitro.audiobrowser.ImageContext
30
+ import com.audiobrowser.extension.identity
23
31
  import com.audiobrowser.model.PlayerSetupOptions
24
32
  import com.audiobrowser.model.PlayerUpdateOptions
25
- import com.audiobrowser.util.AndroidAudioContentTypeFactory
33
+ import com.audiobrowser.model.RetryPolicy
34
+ import com.audiobrowser.remote.RemoteOutputsController
35
+ import com.audiobrowser.remote.RemotePlayback
36
+ import com.audiobrowser.remote.RemoteUrls
37
+ import com.audiobrowser.sonos.SonosRemote
38
+ import com.audiobrowser.util.ArtworkRoutes
39
+ import com.audiobrowser.util.ArtworkUris
40
+ import com.audiobrowser.util.Automotive
26
41
  import com.audiobrowser.util.CoilBitmapLoader
27
- import com.audiobrowser.util.EqualizerManager
28
42
  import com.audiobrowser.util.NetworkConnectivityMonitor
29
43
  import com.audiobrowser.util.PlayingStateFactory
30
44
  import com.audiobrowser.util.RepeatModeFactory
45
+ import com.audiobrowser.util.SvgArtworkRenderer
31
46
  import com.audiobrowser.util.TrackFactory
32
- import com.margelo.nitro.audiobrowser.AndroidPlayerWakeMode
47
+ import com.audiobrowser.util.TrackFactory.setFavorite
48
+ import com.audiobrowser.util.awaitOrTimeout
49
+ import com.audiobrowser.util.isAutomotive
33
50
  import com.margelo.nitro.audiobrowser.AppKilledPlaybackBehavior
34
51
  import com.margelo.nitro.audiobrowser.FavoriteChangedEvent
52
+ import com.margelo.nitro.audiobrowser.GateEvent
53
+ import com.margelo.nitro.audiobrowser.GateReason
54
+ import com.margelo.nitro.audiobrowser.ImageContext
55
+ import com.margelo.nitro.audiobrowser.ImageSource
56
+ import com.margelo.nitro.audiobrowser.NativeGateRequest
35
57
  import com.margelo.nitro.audiobrowser.NowPlayingMetadata
36
- import com.margelo.nitro.audiobrowser.NowPlayingUpdate
37
58
  import com.margelo.nitro.audiobrowser.Playback
38
- import com.margelo.nitro.audiobrowser.PlaybackActiveTrackChangedEvent
39
59
  import com.margelo.nitro.audiobrowser.PlaybackError
60
+ import com.margelo.nitro.audiobrowser.PlaybackPlayWhenReadyChangedEvent
40
61
  import com.margelo.nitro.audiobrowser.PlaybackProgressUpdatedEvent
41
62
  import com.margelo.nitro.audiobrowser.PlaybackQueueEndedEvent
42
63
  import com.margelo.nitro.audiobrowser.PlaybackState
43
64
  import com.margelo.nitro.audiobrowser.PlayingState
44
- import com.margelo.nitro.audiobrowser.RatingType
45
- import com.margelo.nitro.audiobrowser.RemoteJumpBackwardEvent
46
- import com.margelo.nitro.audiobrowser.RemoteJumpForwardEvent
47
- import com.margelo.nitro.audiobrowser.RemoteSeekEvent
48
65
  import com.margelo.nitro.audiobrowser.RepeatMode
49
66
  import com.margelo.nitro.audiobrowser.SearchParams
50
- import com.margelo.nitro.audiobrowser.SleepTimer as NitroSleepTimer
51
- import com.margelo.nitro.audiobrowser.SleepTimerEndOfTrack
52
- import com.margelo.nitro.audiobrowser.SleepTimerTime
53
67
  import com.margelo.nitro.audiobrowser.Track
54
- import com.margelo.nitro.core.NullType
55
68
  import java.io.File
69
+ import java.io.IOException
56
70
  import java.util.concurrent.TimeUnit
57
71
  import kotlin.time.Duration.Companion.seconds
58
72
  import kotlinx.coroutines.CompletableDeferred
73
+ import kotlinx.coroutines.CoroutineScope
74
+ import kotlinx.coroutines.Dispatchers
75
+ import kotlinx.coroutines.MainScope
59
76
  import kotlinx.coroutines.TimeoutCancellationException
77
+ import kotlinx.coroutines.currentCoroutineContext
78
+ import kotlinx.coroutines.ensureActive
79
+ import kotlinx.coroutines.withContext
60
80
  import kotlinx.coroutines.withTimeout
61
81
  import timber.log.Timber
62
82
 
83
+ /**
84
+ * The window behind its live edge that lets a live item pause in place, as on-demand does (a DVR
85
+ * window). A shorter one is a stream that can't be rewound: a pause closes it.
86
+ */
87
+ private const val PAUSABLE_LIVE_WINDOW_MS = 30_000L
88
+
89
+ /**
90
+ * STOPPED stays out: stop() idles the engine itself, and [Player.stopRetrying] would make it
91
+ * PAUSED.
92
+ */
93
+ private val LIVE_CONNECTION_STATES =
94
+ setOf(
95
+ PlaybackState.LOADING,
96
+ PlaybackState.READY,
97
+ PlaybackState.BUFFERING,
98
+ PlaybackState.PLAYING,
99
+ PlaybackState.PAUSED,
100
+ )
101
+
63
102
  @SuppressLint("RestrictedApi")
64
- class Player(internal val context: Context) {
103
+ class Player
104
+ internal constructor(
105
+ internal val context: Context,
106
+ castRemote: (Context, String?) -> RemotePlayback?,
107
+ sonosRemote: (Context, CoroutineScope) -> RemotePlayback,
108
+ ) {
109
+ constructor(context: Context) : this(context, ::createCastRemote, ::SonosRemote)
110
+
65
111
  val appKilledPlaybackBehavior: AppKilledPlaybackBehavior
66
112
  get() = options.appKilledPlaybackBehavior
67
113
 
68
114
  private var options = PlayerUpdateOptions()
115
+ private val mainHandler = Handler(Looper.getMainLooper())
116
+
117
+ /** Audio focus while [retryLoop] keeps the engine idle; see [RetryFocus]. */
118
+ internal val retryFocus: RetryFocus =
119
+ RetryFocus(
120
+ RetryFocus.Platform(
121
+ context.getSystemService(Context.AUDIO_SERVICE) as AudioManager,
122
+ mainHandler,
123
+ ) {
124
+ exoPlayer.audioAttributes.audioAttributesV21.audioAttributes
125
+ },
126
+ // A permanent loss pauses, as media3 does while playing.
127
+ onLoss = { playWhenReady = false },
128
+ onSuppressionChanged = {
129
+ // Posted: it changes the play intent the loop is reporting from.
130
+ mainHandler.post {
131
+ retryLoop?.playIntentChanged(shouldPlayWhenReady)
132
+ refreshPlayingState()
133
+ }
134
+ },
135
+ )
69
136
  internal var callbacks: Callbacks? = null
70
137
  private lateinit var mediaSession: MediaSession
71
138
  val networkMonitor: NetworkConnectivityMonitor = NetworkConnectivityMonitor(context)
72
- private var equalizerManager: EqualizerManager? = null
139
+ internal val equalizer =
140
+ EqualizerController(onSettingsChanged = { settings -> callbacks?.onEqualizerChanged(settings) })
73
141
  private val mediaSessionCallback = MediaSessionCallback(this)
74
142
  internal val playbackStateStore = PlaybackStateStore(this)
75
- private val sleepTimer =
76
- object : SleepTimer() {
77
- override fun onComplete() {
78
- Timber.d("Sleep timer completed, stopping playback")
79
- stop()
80
- callbacks?.onSleepTimerChanged(NitroSleepTimer.create(NullType.NULL))
143
+ // Fades the local engine only: a remote receiver keeps its own volume.
144
+ internal val volumeFader =
145
+ VolumeFader(getVolume = { exoPlayer.volume }, setVolume = { exoPlayer.volume = it })
146
+ internal val sleepTimer =
147
+ SleepTimerManager(
148
+ volumeFader,
149
+ pause = { pause() },
150
+ onChanged = { callbacks?.onSleepTimerChanged(it) },
151
+ )
152
+
153
+ /** The local engine. Rebuilt when the engine options change. */
154
+ internal lateinit var exoPlayer: ExoPlayer
155
+ private set
156
+
157
+ /**
158
+ * What plays: [exoPlayer], or while a remote output is on, the remote-switching player around it.
159
+ * Every playback read and command goes here. Local-only work that would disturb a remote (retry,
160
+ * reconnect, stuck recovery, the shuffle order) goes through [localEngine]; the equalizer,
161
+ * skip-silence, buffering and the volume fade act on [exoPlayer] alone.
162
+ */
163
+ lateinit var sessionPlayer: MediaPlayer
164
+ private set
165
+
166
+ /** [sessionPlayer] behind the remote-command seam: what the MediaSession wraps. */
167
+ internal lateinit var forwardingPlayer: InterceptingPlayer
168
+
169
+ private val remoteOutputs =
170
+ RemoteOutputsController(
171
+ context,
172
+ ::resolveRemoteUrls,
173
+ castRemote,
174
+ sonosRemote,
175
+ localHeld = { retryLoop?.reconnecting == true },
176
+ )
177
+
178
+ internal val localEngine =
179
+ LocalEngine({ exoPlayer }, isRemote = { remoteOutputs.player?.isRemote == true })
180
+
181
+ private var keepSessionAliveOnError = true
182
+
183
+ /** Automatic retry for the local engine; null when the setup turns retry off. */
184
+ internal var retryLoop: RetryLoop? = null
185
+ private set
186
+
187
+ /** What the wake mode holds while [retryLoop] keeps the engine idle; see [RetryLocks]. */
188
+ internal var retryLocks: RetryLocks? = null
189
+ private set
190
+
191
+ /** The playing item's id, for the load error policy on ExoPlayer's playback thread. */
192
+ @Volatile internal var playingMediaId: String? = null
193
+
194
+ /** The last recoverable load failure, the cause of a give-up that has no player error in hand. */
195
+ @Volatile private var lastLoadFailure: IOException? = null
196
+
197
+ private val retryEngine =
198
+ object : RetryLoop.Engine {
199
+ override fun reconnect() =
200
+ retryFocus.handOver { localEngine.retry(toLiveEdge = isCurrentItemLive) }
201
+
202
+ // A play after a pause over a retry connects nothing until then: no failure shows it.
203
+ override fun holdChanged(held: Boolean, kept: Boolean) {
204
+ retryLocks?.hold(held)
205
+ // A suppressed request outlives the intent it dropped: it waits for the focus to return.
206
+ if (held) retryFocus.hold() else if (!kept || !retryFocus.suppressed) retryFocus.release()
207
+ }
208
+
209
+ override fun awaitNetwork() =
210
+ showRetryingError(
211
+ PlaybackErrorClassifier.retryingLoadError(lastLoadFailure ?: IOException(), false)
212
+ )
213
+
214
+ override fun giveUp(cause: PlaybackException?) {
215
+ // A remote output took over before the listener heard it: the loop is done either way.
216
+ if (!localEngine.isActive) return
217
+ // ERROR first: the state machine holds it through the IDLE the stop brings.
218
+ playerListener.surfaceTerminal(
219
+ cause
220
+ ?: PlaybackException(
221
+ "No audio within the retry budget",
222
+ lastLoadFailure,
223
+ PlaybackException.ERROR_CODE_IO_NETWORK_CONNECTION_FAILED,
224
+ )
225
+ )
226
+ exoPlayer.stop()
81
227
  }
82
228
  }
83
229
 
84
- lateinit var exoPlayer: ExoPlayer
85
- lateinit var forwardingPlayer: androidx.media3.common.Player
86
- /** Thread-safe cache of playWhenReady for access from non-main threads (e.g., retry policy) */
87
- @Volatile internal var playWhenReadyCache = false
88
- private lateinit var mediaFactory: MediaFactory
89
- private lateinit var loadControl: DynamicLoadControl
90
- private var automaticBufferManager: AutomaticBufferManager? = null
230
+ private var lastEmittedPlayWhenReady: Boolean? = null
91
231
 
92
232
  /**
93
- * Tracks whether a network-related retry is pending. When true, network restoration will trigger
94
- * an immediate retry via exoPlayer.prepare().
233
+ * Emits a playWhenReady change to JS once per value. Both the synchronous clear at ENDED in
234
+ * [setPlaybackState] and the media3 listener (changes ExoPlayer makes itself, e.g. audio focus)
235
+ * call it; their overlap is dropped.
95
236
  */
96
- @Volatile private var pendingNetworkRetry = false
237
+ internal fun emitPlayWhenReadyChanged(value: Boolean) {
238
+ if (lastEmittedPlayWhenReady == value) return
239
+ lastEmittedPlayWhenReady = value
240
+ callbacks?.onPlaybackPlayWhenReadyChanged(PlaybackPlayWhenReadyChangedEvent(value))
241
+ }
97
242
 
98
- private var _browser: AudioBrowser? = null
99
- private var browserRegistered = CompletableDeferred<AudioBrowser>()
243
+ private lateinit var mediaFactory: MediaFactory
244
+ private lateinit var loadControl: DynamicLoadControl
245
+ private var automaticBufferManager: AutomaticBufferManager? = null
246
+
247
+ @Volatile private var browserRegistered = CompletableDeferred<AudioBrowser>()
100
248
  private var _coilBitmapLoader: CoilBitmapLoader? = null
101
249
 
102
- /**
103
- * Coil ImageLoader for SVG pre-rendering in Android Auto browse items.
104
- * Set by Service after creation.
105
- */
250
+ /** For SVG pre-rendering of Android Auto browse items. Set by the service. */
106
251
  var imageLoader: coil3.ImageLoader? = null
107
252
 
108
253
  /**
109
- * Set the CoilBitmapLoader for artwork URL transformation. Called from Service after creation.
254
+ * Called on the main thread when a resumption meant to start playback fails. Set by the service.
110
255
  */
256
+ var onPlaybackResumptionFailed: () -> Unit = {}
257
+
258
+ /** Maps the browse content provider's content:// tokens to artwork URLs. */
259
+ val browseArtworkRegistry = com.audiobrowser.browser.BrowseArtworkRegistry()
260
+
261
+ init {
262
+ Automotive.device = context.isAutomotive
263
+ TrackFactory.favoriteEnabled = options.capabilities.favoriteEnabled
264
+ TrackFactory.artworkRoutes =
265
+ ArtworkRoutes(browseArtworkRegistry, ArtworkUris.authorityFor(context.packageName))
266
+ }
267
+
111
268
  var coilBitmapLoader: CoilBitmapLoader?
112
269
  get() = _coilBitmapLoader
113
270
  set(value) {
114
271
  _coilBitmapLoader = value
115
- // If browser is already set, wire up the resolver
116
- _browser?.let { audioBrowser -> wireUpArtworkResolver(audioBrowser, value) }
117
272
  }
118
273
 
119
- var browser: AudioBrowser?
120
- get() = _browser
274
+ var browser: AudioBrowser? = null
121
275
  set(value) {
122
- _browser = value
123
- value?.let { audioBrowser ->
124
- // Wire up artwork URL resolver
125
- // This ensures the resolver is available when onGetChildren resumes
126
- wireUpArtworkResolver(audioBrowser, _coilBitmapLoader)
127
-
128
- // NOTE: We do NOT complete browserRegistered here.
129
- // Configuration (routes/tabs) must be set before Android Auto can browse.
130
- // Call notifyBrowserConfigurationReady() after configuration is set.
276
+ // A completed registration is the previous browser's; an open one keeps its waiters.
277
+ if (browserRegistered.isCompleted) {
278
+ browserRegistered = CompletableDeferred()
131
279
  }
280
+ field = value
132
281
  }
133
282
 
134
283
  /**
135
- * Notifies that the browser configuration is ready (routes/tabs are configured).
136
- * This should be called after setting the browser AND its configuration.
137
- * Only then will Android Auto be able to browse content.
284
+ * Marks the browser's routes and tabs configured: completes [awaitBrowser] and lets Android Auto
285
+ * browse. Call after setting [browser] and its configuration.
138
286
  */
139
287
  fun notifyBrowserConfigurationReady() {
140
- val audioBrowser = _browser ?: return
288
+ val audioBrowser = browser ?: return
141
289
 
142
290
  if (!browserRegistered.isCompleted) {
143
291
  Timber.d("Browser configuration ready - completing deferred")
144
292
  browserRegistered.complete(audioBrowser)
145
- // Notify any subscribed controllers that content is now available
146
- // This handles the cold-start case where AA subscribed before browser was ready
293
+ // Android Auto may have subscribed on a cold start before the browser was ready.
147
294
  mediaSessionCallback.notifyBrowserReady()
148
295
  }
149
296
 
150
- // Update MediaSession commands when browser becomes available with search configured
151
- // Only update if search is available, since default state is "no search"
152
297
  if (::mediaSession.isInitialized) {
153
298
  val searchAvailable = audioBrowser.browserManager.config.hasSearch
299
+ // The session starts without search, so only a configured search needs an update.
154
300
  if (searchAvailable) {
155
301
  mediaSessionCallback.updateMediaSession(
156
302
  mediaSession,
157
303
  options.capabilities,
158
- options.notificationButtons,
304
+ options.remoteButtonLayout,
159
305
  searchAvailable,
306
+ options.forwardJumpInterval,
307
+ options.backwardJumpInterval,
160
308
  )
161
309
  }
162
310
  }
163
311
  }
164
312
 
165
313
  /**
166
- * Wires up the artwork URL resolver between BrowserManager and CoilBitmapLoader. This enables
167
- * artwork URL transformation during browse-time (Phase 2).
168
- */
169
- private fun wireUpArtworkResolver(audioBrowser: AudioBrowser, loader: CoilBitmapLoader?) {
170
- val browserManager = audioBrowser.browserManager
171
- if (loader != null) {
172
- Timber.d("Wiring up artwork URL resolver")
173
- browserManager.artworkUrlResolver = { track, perRouteConfig, imageContext ->
174
- loader.transformArtworkUrlForTrack(track, perRouteConfig, imageContext)
175
- }
176
- // Clear content cache so that content resolved before the resolver was wired up
177
- // will be re-fetched with artwork transformation applied
178
- browserManager.clearContentCache()
179
- Timber.d("Cleared content cache after wiring artwork resolver")
180
- } else {
181
- Timber.d("CoilBitmapLoader not available - artwork URL transformation disabled")
182
- browserManager.artworkUrlResolver = null
183
- }
184
- }
185
-
186
- /**
187
- * Suspends until the browser is registered, with a timeout.
314
+ * The browser [notifyBrowserConfigurationReady] registered, waiting for it if none is.
188
315
  *
189
- * @throws TimeoutCancellationException if browser is not registered within timeout
316
+ * @throws TimeoutCancellationException if it is not registered within 10 seconds
190
317
  */
191
318
  suspend fun awaitBrowser(): AudioBrowser =
192
- browser
193
- ?: try {
194
- withTimeout(10.seconds) {
195
- Timber.d("Waiting for browser registration...")
196
- browserRegistered.await()
197
- }
198
- } catch (e: TimeoutCancellationException) {
199
- Timber.e("Timed out waiting for browser registration (10s)")
200
- throw e
201
- }
202
-
203
- /**
204
- * ForwardingPlayer that intercepts external player actions and dispatches them to callbacks.
205
- *
206
- * This class blocks all external media item modifications to delegate control to RNAB. These
207
- * overrides prevent media controllers (like Android Auto, notifications) from directly modifying
208
- * the queue, ensuring all queue changes go through the RNAB API for proper state management and
209
- * event handling.
210
- */
211
- private inner class InterceptingPlayer(player: ExoPlayer) : ForwardingPlayer(player) {
212
-
213
- override fun setMediaItems(mediaItems: MutableList<MediaItem>, resetPosition: Boolean) {
214
- return super.setMediaItems(mediaItems, resetPosition)
215
- }
216
-
217
- override fun addMediaItems(mediaItems: MutableList<MediaItem>) {
218
- return super.addMediaItems(mediaItems)
219
- }
220
-
221
- override fun addMediaItems(index: Int, mediaItems: MutableList<MediaItem>) {
222
- return super.addMediaItems(index, mediaItems)
223
- }
224
-
225
- override fun setMediaItems(
226
- mediaItems: MutableList<MediaItem>,
227
- startIndex: Int,
228
- startPositionMs: Long,
229
- ) {
230
- return super.setMediaItems(mediaItems, startIndex, startPositionMs)
231
- }
232
-
233
- override fun setMediaItems(mediaItems: MutableList<MediaItem>) {
234
- return super.setMediaItems(mediaItems)
235
- }
236
-
237
- // Intercept playback controls and dispatch to callbacks or fall back to default behavior
238
- override fun play() {
239
- if (callbacks?.handleRemotePlay() != true) {
240
- super.play()
241
- }
242
- }
243
-
244
- override fun pause() {
245
- if (callbacks?.handleRemotePause() != true) {
246
- super.pause()
247
- }
248
- }
249
-
250
- override fun seekToNext() {
251
- Timber.Forest.d("InterceptingPlayer.seekToNext() called")
252
- if (callbacks?.handleRemoteNext() != true) {
253
- super.seekToNext()
254
- }
255
- }
256
-
257
- override fun seekToNextMediaItem() {
258
- Timber.Forest.d("InterceptingPlayer.seekToNextMediaItem() called")
259
- if (callbacks?.handleRemoteNext() != true) {
260
- super.seekToNextMediaItem()
261
- }
262
- }
263
-
264
- override fun seekToPrevious() {
265
- Timber.Forest.d("InterceptingPlayer.seekToPrevious() called")
266
- if (callbacks?.handleRemotePrevious() != true) {
267
- super.seekToPrevious()
268
- }
269
- }
270
-
271
- override fun seekToPreviousMediaItem() {
272
- Timber.Forest.d("InterceptingPlayer.seekToPreviousMediaItem() called")
273
- if (callbacks?.handleRemotePrevious() != true) {
274
- super.seekToPreviousMediaItem()
275
- }
276
- }
277
-
278
- override fun seekForward() {
279
- Timber.Forest.d("InterceptingPlayer.seekForward() called")
280
- if (
281
- callbacks?.handleRemoteJumpForward(
282
- RemoteJumpForwardEvent(interval = options.forwardJumpInterval)
283
- ) != true
284
- ) {
285
- super.seekForward()
286
- }
319
+ try {
320
+ withTimeout(10.seconds) { browserRegistered.await() }
321
+ } catch (e: TimeoutCancellationException) {
322
+ Timber.e("Timed out waiting for browser registration (10s)")
323
+ throw e
287
324
  }
288
325
 
289
- override fun seekBack() {
290
- if (
291
- callbacks?.handleRemoteJumpBackward(
292
- RemoteJumpBackwardEvent(interval = options.backwardJumpInterval)
293
- ) != true
294
- ) {
295
- super.seekBack()
296
- }
297
- }
326
+ internal lateinit var playerListener: PlayerListener
327
+ private set
298
328
 
299
- override fun stop() {
300
- if (callbacks?.handleRemoteStop() != true) {
301
- super.stop()
302
- }
303
- }
329
+ private var cache: SimpleCache? = null
304
330
 
305
- override fun seekTo(mediaItemIndex: Int, positionMs: Long) {
306
- if (
307
- callbacks?.handleRemoteSeek(RemoteSeekEvent(position = positionMs.toDouble() / 1000.0)) !=
308
- true
309
- ) {
310
- super.seekTo(mediaItemIndex, positionMs)
311
- }
312
- }
331
+ private var destroyed = false
313
332
 
314
- override fun seekTo(positionMs: Long) {
315
- if (
316
- callbacks?.handleRemoteSeek(RemoteSeekEvent(position = positionMs.toDouble() / 1000.0)) !=
317
- true
318
- ) {
319
- super.seekTo(positionMs)
333
+ private val progressTimer: PlaybackTimer by lazy {
334
+ PlaybackTimer(
335
+ isActive = {
336
+ it == PlaybackState.LOADING || it == PlaybackState.BUFFERING || it == PlaybackState.PLAYING
320
337
  }
321
- }
322
- }
323
-
324
- private lateinit var playerListener: PlayerListener
325
- private var cache: SimpleCache? = null
326
-
327
- private val progressUpdateManager: PlaybackProgressUpdateManager by lazy {
328
- PlaybackProgressUpdateManager {
329
- val index = currentIndex ?: return@PlaybackProgressUpdateManager
338
+ ) {
339
+ val index = currentIndex ?: return@PlaybackTimer
330
340
  val event =
331
341
  PlaybackProgressUpdatedEvent(
332
342
  position = position.toSeconds(),
@@ -338,10 +348,15 @@ class Player(internal val context: Context) {
338
348
  }
339
349
  }
340
350
 
351
+ private val intervalTimer: PlaybackTimer by lazy {
352
+ PlaybackTimer(isActive = { it == PlaybackState.PLAYING }) { callbacks?.onPlaybackInterval() }
353
+ }
354
+
341
355
  internal var playingState: PlayingState = PlayingState(false, false)
356
+ private set
342
357
 
343
358
  val currentTrack: Track?
344
- get() = exoPlayer.currentMediaItem?.let { TrackFactory.fromMedia3(it) }
359
+ get() = sessionPlayer.currentMediaItem?.let { TrackFactory.fromMedia3(it) }
345
360
 
346
361
  internal var lastTrack: Track? = null
347
362
  internal var lastIndex: Int? = null
@@ -352,9 +367,6 @@ class Player(internal val context: Context) {
352
367
  internal var playbackState: PlaybackState = PlaybackState.NONE
353
368
  private set
354
369
 
355
- /** Current now playing metadata override (null = use track metadata) */
356
- private var nowPlayingOverride: NowPlayingUpdate? = null
357
-
358
370
  fun getPlayback(): Playback {
359
371
  return Playback(playbackState, playbackError)
360
372
  }
@@ -363,95 +375,159 @@ class Player(internal val context: Context) {
363
375
  return playingState
364
376
  }
365
377
 
378
+ /**
379
+ * Re-derives [playingState] from [shouldPlayWhenReady] and [playbackState], emitting when it
380
+ * changed. Its only writer: call it wherever either input changes.
381
+ */
382
+ internal fun refreshPlayingState() {
383
+ val newPlayingState = PlayingStateFactory.derive(shouldPlayWhenReady, playbackState)
384
+ if (newPlayingState == playingState) return
385
+ Timber.d(
386
+ "PlayingState changed: playing=${newPlayingState.playing}, buffering=${newPlayingState.buffering}"
387
+ )
388
+ playingState = newPlayingState
389
+ callbacks?.onPlaybackPlayingState(playingState)
390
+ }
391
+
366
392
  var playWhenReady: Boolean
367
- get() = exoPlayer.playWhenReady
393
+ get() = sessionPlayer.playWhenReady
368
394
  set(value) {
369
- playWhenReadyCache = value
370
- exoPlayer.playWhenReady = value
395
+ // ExoPlayer's setPlayWhenReady(true) neither restarts an ended engine (media3 replays only on
396
+ // its media-button path) nor loads an idle one. Here in the setter so every writer plays
397
+ // alike: play(), togglePlayback(), JS, the session.
398
+ if (value && sessionPlayer.playbackState == MediaPlayer.STATE_ENDED) {
399
+ sessionPlayer.seekToDefaultPosition()
400
+ }
401
+ sessionPlayer.playWhenReady = value
402
+ // No-op unless the engine is idle, so this reconnects only after a stop, an error, a
403
+ // cancelled retry or a rebuild, and never re-buffers a healthy stream. Reconnecting is also
404
+ // how a live stream rejoins its live edge. Not while the retry loop paces the reconnect.
405
+ if (
406
+ value &&
407
+ currentTrack != null &&
408
+ retryView(sessionPlayer.playbackState) == MediaPlayer.STATE_IDLE
409
+ ) {
410
+ // An idle engine keeps its position, a seek's while parked included: within a live
411
+ // window, the reconnect would resume there.
412
+ if (currentTrack?.live == true && !liveItemPausable) sessionPlayer.seekToDefaultPosition()
413
+ sessionPlayer.prepare()
414
+ }
371
415
  }
372
416
 
417
+ /**
418
+ * The intent a setup carries, raised without loading: a setup repeats, as on a JS reload, and
419
+ * would otherwise start a stopped or failed queue. A play loads.
420
+ */
421
+ internal fun applySetupPlayWhenReady(value: Boolean) {
422
+ sessionPlayer.playWhenReady = value
423
+ }
424
+
373
425
  val duration: Long
374
- get() = if (exoPlayer.duration == C.TIME_UNSET) 0 else exoPlayer.duration
426
+ get() = if (sessionPlayer.duration == C.TIME_UNSET) 0 else sessionPlayer.duration
375
427
 
376
428
  internal var oldPosition = 0L
377
429
 
378
430
  val position: Long
379
431
  get() =
380
- if (exoPlayer.currentPosition == C.INDEX_UNSET.toLong()) 0 else exoPlayer.currentPosition
432
+ if (sessionPlayer.currentPosition == C.INDEX_UNSET.toLong()) 0
433
+ else sessionPlayer.currentPosition
381
434
 
382
435
  val bufferedPosition: Long
383
436
  get() =
384
- if (exoPlayer.bufferedPosition == C.INDEX_UNSET.toLong()) 0 else exoPlayer.bufferedPosition
437
+ if (sessionPlayer.bufferedPosition == C.INDEX_UNSET.toLong()) 0
438
+ else sessionPlayer.bufferedPosition
385
439
 
440
+ /** From 0 to 1: the local engine's, or while remote, the receiver's. */
386
441
  var volume: Float
387
- get() = exoPlayer.volume
442
+ get() = sessionPlayer.volume
388
443
  set(value) {
389
- exoPlayer.volume = value
444
+ sessionPlayer.volume = value
390
445
  }
391
446
 
392
447
  var playbackSpeed: Float
393
- get() = exoPlayer.playbackParameters.speed
448
+ get() = sessionPlayer.playbackParameters.speed
394
449
  set(value) {
395
- exoPlayer.setPlaybackSpeed(value)
450
+ sessionPlayer.setPlaybackSpeed(value)
396
451
  }
397
452
 
398
453
  val isPlaying
399
- get() = exoPlayer.isPlaying
454
+ get() = sessionPlayer.isPlaying
400
455
 
401
- var ratingType: RatingType = RatingType.NONE
456
+ /**
457
+ * False while ExoPlayer suppresses output (a transient audio focus loss) though [playWhenReady]
458
+ * stays raised to resume on; mirrors media3's `ExoPlayerImplInternal.shouldPlayWhenReady`.
459
+ */
460
+ internal val shouldPlayWhenReady: Boolean
461
+ get() =
462
+ sessionPlayer.playWhenReady &&
463
+ sessionPlayer.playbackSuppressionReason == MediaPlayer.PLAYBACK_SUPPRESSION_REASON_NONE &&
464
+ !retryFocus.suppressed
402
465
 
403
466
  var repeatMode: RepeatMode
404
- get() = RepeatModeFactory.fromMedia3(exoPlayer.repeatMode)
467
+ get() = RepeatModeFactory.fromMedia3(sessionPlayer.repeatMode)
405
468
  internal set(value) {
406
- exoPlayer.repeatMode = RepeatModeFactory.toMedia3(value)
469
+ sessionPlayer.repeatMode = RepeatModeFactory.toMedia3(value)
407
470
  }
408
471
 
409
472
  val currentIndex: Int?
410
473
  get() =
411
- if (exoPlayer.currentMediaItemIndex == C.INDEX_UNSET) null
412
- else exoPlayer.currentMediaItemIndex
474
+ if (sessionPlayer.currentMediaItemIndex == C.INDEX_UNSET) null
475
+ else sessionPlayer.currentMediaItemIndex
413
476
 
414
477
  var shuffleMode: Boolean
415
- get() = exoPlayer.shuffleModeEnabled
478
+ get() = sessionPlayer.shuffleModeEnabled
416
479
  set(value) {
417
- exoPlayer.shuffleModeEnabled = value
480
+ sessionPlayer.shuffleModeEnabled = value
418
481
  }
419
482
 
420
483
  val trackCount: Int
421
- get() = exoPlayer.mediaItemCount
484
+ get() = sessionPlayer.mediaItemCount
422
485
 
423
486
  val isEmpty: Boolean
424
- get() = exoPlayer.mediaItemCount == 0
487
+ get() = sessionPlayer.mediaItemCount == 0
425
488
 
426
489
  val tracks: Array<Track>
427
490
  get() =
428
- (0 until exoPlayer.mediaItemCount)
429
- .map { index -> TrackFactory.fromMedia3(exoPlayer.getMediaItemAt(index)) }
491
+ (0 until sessionPlayer.mediaItemCount)
492
+ .map { index -> TrackFactory.fromMedia3(sessionPlayer.getMediaItemAt(index)) }
430
493
  .toTypedArray()
431
494
 
432
- val isLastTrack: Boolean
433
- get() = exoPlayer.currentMediaItemIndex == exoPlayer.mediaItemCount - 1
495
+ /** In playback order, so shuffle and repeat count; not the last linear index. */
496
+ val isLastInPlaybackOrder: Boolean
497
+ get() = sessionPlayer.nextMediaItemIndex == C.INDEX_UNSET
434
498
 
435
499
  /**
436
- * The source path from which the current queue was expanded (e.g., from a contextual URL). Used
437
- * to avoid re-expanding the queue when selecting tracks from the same source.
500
+ * Changes whenever the queue's tracks or their order change, whoever changed them, and never
501
+ * repeats in the process, so equal readings mean the same queue even across players.
438
502
  */
439
- var queueSourcePath: String? = null
440
- internal set
503
+ var queueVersion = 0
504
+ private set
505
+
506
+ private var versionedMediaIds = emptyList<String>()
441
507
 
442
508
  /**
443
- * Get track at index with bounds checking.
444
- *
445
- * @param index The index of the track to retrieve.
446
- * @throws IllegalArgumentException if index is out of bounds.
509
+ * Compares media ids: an engine rebuild sets the same items again and reports a playlist change.
447
510
  */
511
+ internal fun onPlaylistChanged() {
512
+ val mediaIds =
513
+ (0 until sessionPlayer.mediaItemCount).map { sessionPlayer.getMediaItemAt(it).mediaId }
514
+ if (mediaIds == versionedMediaIds) return
515
+ versionedMediaIds = mediaIds
516
+ queueVersion = ++lastQueueVersion
517
+ }
518
+
519
+ /** The path the queue was expanded from, so selecting from the same source skips re-expanding. */
520
+ var queueSourcePath: String? = null
521
+ internal set
522
+
523
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
448
524
  fun getTrack(index: Int): Track {
449
- if (index < 0 || index >= exoPlayer.mediaItemCount) {
525
+ if (index < 0 || index >= sessionPlayer.mediaItemCount) {
450
526
  throw IllegalArgumentException(
451
- "Track index $index is out of bounds (size: ${exoPlayer.mediaItemCount})"
527
+ "Track index $index is out of bounds (size: ${sessionPlayer.mediaItemCount})"
452
528
  )
453
529
  }
454
- return TrackFactory.fromMedia3(exoPlayer.getMediaItemAt(index))
530
+ return TrackFactory.fromMedia3(sessionPlayer.getMediaItemAt(index))
455
531
  }
456
532
 
457
533
  var skipSilence: Boolean
@@ -460,14 +536,65 @@ class Player(internal val context: Context) {
460
536
  exoPlayer.skipSilenceEnabled = value
461
537
  }
462
538
 
539
+ private var engineOptions: PlayerSetupOptions? = null
540
+
541
+ private var deferredSetup: PlayerSetupOptions? = null
542
+
463
543
  /**
464
- * Sets up or recreates the ExoPlayer with the provided setup options. This method can be called
465
- * multiple times to change setup options.
544
+ * Builds the ExoPlayer on the first call, and rebuilds it only when the engine options changed. A
545
+ * rebuild carries over the queue, the position and the play intent. During a transient audio
546
+ * focus loss with the intent up, the rebuild waits until focus returns, the intent drops, or a
547
+ * play asks for focus again.
466
548
  */
467
549
  fun setup(setupOptions: PlayerSetupOptions) {
468
- Timber.Forest.d("Setting up player with new options")
550
+ nowPlaying.enabled = setupOptions.autoUpdateNowPlayingMetadata
551
+ // Unwrapped from the Nitro Func so the updater never touches bridge types.
552
+ nowPlaying.formatter =
553
+ setupOptions.nowPlayingMetadataFormatter?.let { f ->
554
+ { params -> f.invoke(params).awaitOrTimeout() }
555
+ }
469
556
 
470
- val isInitialSetup = !::exoPlayer.isInitialized
557
+ deferredSetup = setupOptions.takeIf { it.engineOptions() != engineOptions }
558
+ rebuildIfDue()
559
+ if (remoteOutputs.apply(setupOptions.remoteOutputs, exoPlayer)) attachSessionPlayer()
560
+ }
561
+
562
+ /**
563
+ * Runs a [deferredSetup] rebuild unless the engine waits out a transient focus loss with the
564
+ * intent up: the new engine would ask for focus at once, taking it from the app that holds it, or
565
+ * lose the intent when refused, as during a call. Call when the engine's state, intent or
566
+ * suppression changes.
567
+ */
568
+ internal fun rebuildIfDue() {
569
+ val options = deferredSetup ?: return
570
+ // A stopped engine keeps the suppression but holds no focus, and is carried unprepared.
571
+ if (
572
+ engineOptions != null &&
573
+ exoPlayer.playbackState != MediaPlayer.STATE_IDLE &&
574
+ exoPlayer.playWhenReady &&
575
+ exoPlayer.playbackSuppressionReason ==
576
+ MediaPlayer.PLAYBACK_SUPPRESSION_REASON_TRANSIENT_AUDIO_FOCUS_LOSS
577
+ ) {
578
+ return
579
+ }
580
+ deferredSetup = null
581
+ buildEngine(options)
582
+ engineOptions = options.engineOptions()
583
+ }
584
+
585
+ /**
586
+ * [rebuildIfDue] once the current command returns: ExoPlayer reports an intent change from inside
587
+ * the command, and a rebuild there would land between its steps, as between stop()'s drop of the
588
+ * intent and its stop.
589
+ */
590
+ internal fun rebuildIfDueLater() {
591
+ if (deferredSetup != null) mainHandler.post(::rebuildIfDue)
592
+ }
593
+
594
+ private fun buildEngine(setupOptions: PlayerSetupOptions) {
595
+ Timber.Forest.d("Setting up player with new options")
596
+ val isInitialSetup = engineOptions == null
597
+ val carried = if (isInitialSetup) null else EnginePlayback.of(exoPlayer)
471
598
 
472
599
  if (!isInitialSetup) {
473
600
  forwardingPlayer.removeListener(playerListener)
@@ -476,12 +603,15 @@ class Player(internal val context: Context) {
476
603
  }
477
604
 
478
605
  if (setupOptions.maxCacheSize > 0) {
606
+ // SimpleCache locks its folder: the constructor throws until the previous one is released.
607
+ cache?.release()
479
608
  cache =
480
609
  SimpleCache(
481
610
  File(context.cacheDir, "RNAB"),
482
611
  LeastRecentlyUsedCacheEvictor(
612
+ // MB to bytes
483
613
  setupOptions.maxCacheSize.toLong() * 1_000_000
484
- ), // MB to bytes
614
+ ),
485
615
  StandaloneDatabaseProvider(context),
486
616
  )
487
617
  } else {
@@ -489,123 +619,78 @@ class Player(internal val context: Context) {
489
619
  cache = null
490
620
  }
491
621
 
492
- // Recreate ExoPlayer with new setup options
493
- val renderer = DefaultRenderersFactory(context)
494
- renderer.setExtensionRendererMode(DefaultRenderersFactory.EXTENSION_RENDERER_MODE_PREFER)
495
-
496
- // Create bandwidth meter for adaptive bitrate selection in HLS/DASH
497
- val bandwidthMeter = DefaultBandwidthMeter.Builder(context).build()
498
-
499
- loadControl = run {
500
- val minBuffer = setupOptions.minBuffer.toInt()
501
- val maxBuffer = setupOptions.maxBuffer.toInt()
502
- val playBuffer = setupOptions.playBuffer.toInt()
503
- // When automatic (rebufferBuffer is null), start at playBuffer and let AutomaticBufferManager
504
- // adjust
505
- // When fixed (rebufferBuffer is set), use that value
506
- val playAfterRebuffer = setupOptions.rebufferBuffer?.toInt() ?: playBuffer
507
- val backBuffer = setupOptions.backBuffer.toInt()
508
- val config =
509
- BufferConfig(
510
- minBufferMs = minBuffer,
511
- maxBufferMs = maxBuffer,
512
- bufferForPlaybackMs = playBuffer,
513
- bufferForPlaybackAfterRebufferMs = playAfterRebuffer,
514
- backBufferMs = backBuffer,
515
- )
516
- DynamicLoadControl(initialConfig = config)
517
- }
518
- // Create MediaFactory with reference to browser for media URL transformation
519
- // shouldRetry checks playWhenReady to avoid retrying when paused (e.g., another app took audio
520
- // focus). Uses thread-safe cache since this is called from ExoPlayer's playback thread.
521
- // isOnline and onRetryPending enable network-aware retry acceleration.
522
- mediaFactory =
523
- MediaFactory(
622
+ val engine =
623
+ buildPlayerEngine(
524
624
  context,
625
+ setupOptions,
525
626
  cache,
526
- setupOptions.retryPolicy,
527
- shouldRetry = { playWhenReadyCache },
528
- isOnline = { networkMonitor.getOnline() },
529
- onRetryPending = { isNetworkError ->
530
- // Track pending network retries for acceleration when connectivity returns
531
- pendingNetworkRetry = isNetworkError
532
- if (isNetworkError) {
533
- Timber.d("Network retry pending, will accelerate on connectivity restoration")
534
- }
535
- },
536
- transferListener = bandwidthMeter,
537
- ) { url ->
538
- browser?.getMediaRequestConfig(url)
539
- }
540
-
541
- exoPlayer =
542
- ExoPlayer.Builder(context)
543
- .setRenderersFactory(renderer)
544
- .setBandwidthMeter(bandwidthMeter)
545
- .setHandleAudioBecomingNoisy(setupOptions.handleAudioBecomingNoisy)
546
- .setMediaSourceFactory(mediaFactory)
547
- .setWakeMode(
548
- when (setupOptions.wakeMode) {
549
- AndroidPlayerWakeMode.NONE -> C.WAKE_MODE_NONE
550
- AndroidPlayerWakeMode.LOCAL -> C.WAKE_MODE_LOCAL
551
- AndroidPlayerWakeMode.NETWORK -> C.WAKE_MODE_NETWORK
552
- }
553
- )
554
- .setLoadControl(loadControl)
555
- .setName("AudioBrowser")
556
- .build()
557
- exoPlayer.setAudioAttributes(
558
- AudioAttributes.Builder()
559
- .setUsage(C.USAGE_MEDIA)
560
- .setContentType(AndroidAudioContentTypeFactory.toMedia3(setupOptions.audioContentType))
561
- .build(),
562
- true, // handle audio focus
563
- )
564
-
565
- // Apply setup-specific options
566
- setupOptions.audioOffload?.let {
567
- val audioOffloadPreferences =
568
- TrackSelectionParameters.AudioOffloadPreferences.Builder()
569
- .setAudioOffloadMode(
570
- TrackSelectionParameters.AudioOffloadPreferences.AUDIO_OFFLOAD_MODE_ENABLED
571
- )
572
- .setIsGaplessSupportRequired(it.gaplessSupportRequired)
573
- .setIsSpeedChangeSupportRequired(it.rateChangeSupportRequired)
574
- .build()
575
- exoPlayer.trackSelectionParameters.audioOffloadPreferences = audioOffloadPreferences
576
- }
577
-
578
- // Recreate forwarding player with new ExoPlayer
579
- forwardingPlayer = InterceptingPlayer(exoPlayer)
627
+ onLoadFailure = ::onLoadFailure,
628
+ isCurrent = { it.mediaId == playingMediaId },
629
+ resolveMediaConfig = { url, track -> browser?.getMediaRequestConfig(url, track) },
630
+ )
631
+ loadControl = engine.loadControl
632
+ mediaFactory = engine.mediaFactory
633
+ exoPlayer = engine.exoPlayer
634
+ // A reconnect the old loop held between connections: the engine is carried idle and unprepared.
635
+ val heldIdle = retryLoop?.reconnecting == true && localEngine.isActive
636
+ retryLoop?.suspend()
637
+ // Before the listener and the session are attached, so neither hears the playback replayed.
638
+ carried?.restoreTo(exoPlayer)
639
+ remoteOutputs.setLocal(exoPlayer)
640
+ keepSessionAliveOnError = setupOptions.keepSessionAliveOnError
641
+
642
+ if (isInitialSetup) playerListener = PlayerListener(this)
643
+ attachSessionPlayer()
644
+ if (heldIdle && exoPlayer.playbackState == ExoPlayer.STATE_IDLE && exoPlayer.mediaItemCount > 0)
645
+ exoPlayer.prepare()
646
+ playerListener.engineAttached()
647
+ retryLoop = newRetryLoop(setupOptions)
648
+ playingMediaId = exoPlayer.currentMediaItem?.mediaId
580
649
 
581
650
  if (isInitialSetup) {
582
- // Initial setup - create player listener and emit initial state
583
- playerListener = PlayerListener(this)
584
- forwardingPlayer.addListener(playerListener)
585
651
  callbacks?.onPlaybackChanged(Playback(PlaybackState.NONE, null))
586
-
587
- // Initialize equalizer with audio session ID
588
- initializeEqualizer()
589
- } else {
590
- // Re-setup - re-add listener and update MediaSession
591
- forwardingPlayer.addListener(playerListener)
592
-
593
- // Update MediaSession with new forwardingPlayer reference if MediaSession exists
594
- if (::mediaSession.isInitialized) {
595
- Timber.Forest.d("Updating MediaSession with new forwardingPlayer reference")
596
- mediaSession.player = forwardingPlayer
597
- }
598
-
599
- setPlaybackState(PlaybackState.NONE)
652
+ equalizer.initialize(exoPlayer.audioSessionId)
653
+ } else if (localEngine.isActive) {
654
+ // No listener heard the restore. Its prepare() leaves the engine buffering; an unprepared one
655
+ // keeps its state. While remote, the receiver plays on unchanged.
656
+ if (exoPlayer.playbackState != ExoPlayer.STATE_IDLE) setPlaybackState(PlaybackState.BUFFERING)
657
+ // The new engine starts unsuppressed: an unchanged state would not re-derive it.
658
+ refreshPlayingState()
600
659
  }
601
660
 
602
- // Set up automatic buffer management if enabled
603
661
  setupAutomaticBufferManager(setupOptions.automaticBuffer)
604
662
  }
605
663
 
606
- /** Sets up or tears down the automatic buffer manager based on the enabled flag. */
664
+ // Call whenever [exoPlayer] or the remote player changes.
665
+ private fun attachSessionPlayer() {
666
+ if (::forwardingPlayer.isInitialized) forwardingPlayer.removeListener(playerListener)
667
+ sessionPlayer = remoteOutputs.player ?: exoPlayer
668
+ forwardingPlayer =
669
+ InterceptingPlayer(
670
+ sessionPlayer,
671
+ { callbacks },
672
+ { options },
673
+ keepSessionAliveOnError,
674
+ playerState = { playbackState },
675
+ engineView = ::retryView,
676
+ masksPlaying = { retryMasksPlaying },
677
+ playPlayer = ::play,
678
+ stopPlayer = ::stop,
679
+ )
680
+ forwardingPlayer.addEngineListener(playerListener)
681
+ if (::mediaSession.isInitialized) mediaSession.player = forwardingPlayer
682
+ }
683
+
684
+ private suspend fun resolveRemoteUrls(track: Track): RemoteUrls {
685
+ val src = checkNotNull(track.src) { "The track has no src" }
686
+ val browserManager = browser?.browserManager
687
+ return RemoteUrls(
688
+ url = browserManager?.resolveMediaUrl(src, track)?.url() ?: src,
689
+ artworkUrl = browserManager?.resolveArtworkUrl(track)?.uri,
690
+ )
691
+ }
692
+
607
693
  private fun setupAutomaticBufferManager(enabled: Boolean) {
608
- // Detach existing manager if any
609
694
  automaticBufferManager?.detach()
610
695
 
611
696
  if (enabled) {
@@ -619,164 +704,90 @@ class Player(internal val context: Context) {
619
704
  }
620
705
  }
621
706
 
622
- /**
623
- * Starts observing network connectivity changes and invokes the callback when state changes.
624
- * Also handles accelerating pending network retries when connectivity is restored.
625
- *
626
- * @param scope The coroutine scope to use for observation
627
- */
628
707
  fun observeNetworkConnectivity(scope: kotlinx.coroutines.CoroutineScope) {
629
708
  networkMonitor.observeOnline(scope) { isOnline ->
630
709
  callbacks?.onOnlineChanged(isOnline)
710
+ retryLoop?.onlineChanged(isOnline)
631
711
 
632
- // Accelerate pending network retry when connectivity is restored
633
- if (isOnline && pendingNetworkRetry) {
634
- Timber.d("Network restored with pending retry, triggering immediate retry")
635
- pendingNetworkRetry = false
636
- // Only retry if player is still expecting to play
637
- if (playWhenReadyCache) {
638
- exoPlayer.prepare()
639
- }
640
- }
712
+ // The formatter tells a stall from being offline, so it renders on a connectivity change too.
713
+ nowPlaying.render()
641
714
  }
642
715
  }
643
716
 
644
- /**
645
- * Loads a track into the player. If there is a current track, it will be replaced. If the queue
646
- * is empty, the track will be added.
647
- *
648
- * @param track The [Track] to load.
649
- */
717
+ /** Replaces the current track, keeping the rest of the queue; on an empty queue, adds it. */
650
718
  fun load(track: Track) {
651
- if (exoPlayer.mediaItemCount == 0) {
719
+ if (sessionPlayer.mediaItemCount == 0) {
652
720
  add(track)
653
721
  } else {
654
- val index = exoPlayer.currentMediaItemIndex
722
+ val index = sessionPlayer.currentMediaItemIndex
655
723
  replaceTrack(index, track)
656
- exoPlayer.seekTo(index, C.TIME_UNSET)
657
- exoPlayer.prepare()
724
+ sessionPlayer.seekTo(index, C.TIME_UNSET)
725
+ sessionPlayer.prepare()
658
726
  }
659
727
  }
660
728
 
661
- /**
662
- * Add a single track to the queue. If the AudioPlayer has no track loaded, it will load the
663
- * `track`.
664
- *
665
- * @param track The [Track] to add.
666
- */
667
- fun add(track: Track) {
668
- val mediaItem = TrackFactory.toMedia3(track)
669
- exoPlayer.addMediaItem(mediaItem)
670
- exoPlayer.prepare()
671
- }
672
-
673
- /**
674
- * Add multiple tracks to the queue. If the AudioPlayer has no track loaded, it will load the
675
- * first track in the list.
676
- *
677
- * @param tracks The [Track]s to add.
678
- */
679
- fun add(tracks: Array<Track>) {
680
- val mediaItems = TrackFactory.toMedia3(tracks)
681
- exoPlayer.addMediaItems(mediaItems.toList())
682
- exoPlayer.prepare()
683
- }
729
+ fun add(track: Track) = add(arrayOf(track))
684
730
 
685
731
  /**
686
- * Add multiple tracks to the queue.
732
+ * Loads only into an empty queue: a queue that had tracks keeps its current one as it was, idle
733
+ * after a stop or a cancelled retry.
687
734
  *
688
- * @param tracks The [Track]s to add.
689
- * @param atIndex Index to insert tracks at. Use -1 to append to the end of the queue.
690
- * @throws IllegalArgumentException if index is out of bounds.
735
+ * @throws IllegalArgumentException unless [atIndex] is within the queue, or -1 to append.
691
736
  */
692
- fun add(tracks: Array<Track>, atIndex: Int) {
737
+ fun add(tracks: Array<Track>, atIndex: Int = -1) {
693
738
  validateInsertIndex(atIndex)
694
- val index = if (atIndex == -1) exoPlayer.mediaItemCount else atIndex
695
- val mediaItems = tracks.map { TrackFactory.toMedia3(it) }
696
- exoPlayer.addMediaItems(index, mediaItems)
697
- exoPlayer.prepare()
698
- }
699
-
700
- /**
701
- * Remove a track from the queue.
702
- *
703
- * @param index The index of the track to remove.
704
- * @throws IllegalArgumentException if index is out of bounds.
705
- */
706
- fun remove(index: Int) {
707
- validateIndex(index)
708
- exoPlayer.removeMediaItem(index)
739
+ val count = sessionPlayer.mediaItemCount
740
+ sessionPlayer.addMediaItems(
741
+ if (atIndex == -1) count else atIndex,
742
+ TrackFactory.toMedia3(tracks),
743
+ )
744
+ if (count == 0) sessionPlayer.prepare()
709
745
  }
710
746
 
711
- /**
712
- * Remove tracks from the queue.
713
- *
714
- * @param indexes The indexes of the tracks to remove.
715
- * @throws IllegalArgumentException if any index is out of bounds or if duplicate indexes are
716
- * provided.
717
- */
747
+ /** @throws IllegalArgumentException if an index is out of bounds or repeated. */
718
748
  fun remove(indexes: List<Int>) {
719
749
  if (indexes.toSet().size != indexes.size) {
720
750
  throw IllegalArgumentException("Duplicate indexes provided")
721
751
  }
722
752
  indexes.forEach { validateIndex(it) }
723
- val sorted = indexes.sortedDescending()
724
- sorted.forEach { exoPlayer.removeMediaItem(it) }
753
+ val removesCurrent = sessionPlayer.currentMediaItemIndex in indexes
754
+ indexes.sortedDescending().forEach { sessionPlayer.removeMediaItem(it) }
755
+ // Loads the new current track on an engine an error left idle; a no-op otherwise.
756
+ if (removesCurrent && playWhenReady) prepare()
725
757
  }
726
758
 
727
- /**
728
- * Skip to the next track in the queue, which may depend on the current repeat mode. Does nothing
729
- * if there is no next track to skip to.
730
- */
731
- fun next() {
732
- exoPlayer.seekToNextMediaItem()
733
- exoPlayer.prepare()
734
- }
759
+ fun next() = loadAfter { sessionPlayer.seekToNextMediaItem() }
760
+
761
+ fun previous() = loadAfter { sessionPlayer.seekToPreviousMediaItem() }
735
762
 
736
763
  /**
737
- * Skip to the previous track in the queue, which may depend on the current repeat mode. Does
738
- * nothing if there is no previous track to skip to.
764
+ * Runs [move] and prepares an idle engine, unless the queue ended and stays where it was: a
765
+ * rebuild carries an ended engine idle, and it stays ended as an ended engine does.
739
766
  */
740
- fun previous() {
741
- exoPlayer.seekToPreviousMediaItem()
742
- exoPlayer.prepare()
767
+ private inline fun loadAfter(move: () -> Unit) {
768
+ val index = sessionPlayer.currentMediaItemIndex
769
+ move()
770
+ if (playbackState == PlaybackState.ENDED && sessionPlayer.currentMediaItemIndex == index) return
771
+ sessionPlayer.prepare()
743
772
  }
744
773
 
745
774
  /**
746
- * Move an track in the queue from one position to another.
775
+ * A [toIndex] past the end moves the track to the end.
747
776
  *
748
- * @param fromIndex The index of the track to move.
749
- * @param toIndex The index to move the track to. If the index is larger than the size of the
750
- * queue, the track is moved to the end of the queue instead.
751
- * @throws IllegalArgumentException if fromIndex is out of bounds.
777
+ * @throws IllegalArgumentException if [fromIndex] is out of bounds.
752
778
  */
753
779
  fun move(fromIndex: Int, toIndex: Int) {
754
780
  validateIndex(fromIndex)
755
- exoPlayer.moveMediaItem(fromIndex, toIndex)
781
+ sessionPlayer.moveMediaItem(fromIndex, toIndex)
756
782
  }
757
783
 
758
- /**
759
- * Skips to a track in the queue.
760
- *
761
- * @param index the index to skip to
762
- * @throws IllegalArgumentException if index is out of bounds.
763
- */
784
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
764
785
  fun skipTo(index: Int) {
765
786
  validateIndex(index)
766
- exoPlayer.seekTo(index, C.TIME_UNSET)
767
- exoPlayer.prepare()
787
+ sessionPlayer.seekTo(index, C.TIME_UNSET)
788
+ sessionPlayer.prepare()
768
789
  }
769
790
 
770
- /**
771
- * Sets the queue with new tracks, optionally starting at a specific index and position. This is
772
- * more efficient than calling clear() + add() + skipTo() separately.
773
- *
774
- * @param tracks The tracks to set as the new queue.
775
- * @param startIndex The index to start playback from (default: 0).
776
- * @param startPositionMs The position in milliseconds to start from (default: 0).
777
- * @param sourcePath Optional path from which this queue was expanded (for contextual URL
778
- * optimization).
779
- */
780
791
  fun setQueue(
781
792
  tracks: Array<Track>,
782
793
  startIndex: Int = 0,
@@ -784,213 +795,339 @@ class Player(internal val context: Context) {
784
795
  sourcePath: String? = null,
785
796
  ) {
786
797
  val mediaItems = TrackFactory.toMedia3(tracks).toMutableList()
787
- exoPlayer.setMediaItems(mediaItems, startIndex, startPositionMs)
798
+ sessionPlayer.setMediaItems(mediaItems, startIndex, startPositionMs)
799
+ // While remote, the queue plays in list order.
800
+ if (mediaItems.isNotEmpty()) {
801
+ localEngine.setShuffleOrder(shuffleOrderLedBy(startIndex, mediaItems.size))
802
+ }
788
803
  queueSourcePath = sourcePath
789
- exoPlayer.prepare()
804
+ sessionPlayer.prepare()
790
805
  }
791
806
 
792
- /**
793
- * Replaces track at index in queue.
794
- *
795
- * @throws IllegalArgumentException if index is out of bounds.
796
- */
807
+ /** @throws IllegalArgumentException if [index] is out of bounds. */
797
808
  fun replaceTrack(index: Int, track: Track) {
798
809
  validateIndex(index)
799
- exoPlayer.replaceMediaItem(index, TrackFactory.toMedia3(track))
810
+ val isCurrent = index == currentIndex
811
+ if (isCurrent) nowPlaying.forgetPublished()
812
+ sessionPlayer.replaceMediaItem(index, TrackFactory.toMedia3(track))
813
+ if (isCurrent) nowPlaying.render()
800
814
  }
801
815
 
802
816
  /**
803
- * Sets the favorited state of the currently playing track. Updates the heart icon in media
804
- * controllers without interrupting playback.
817
+ * @return false only when there is no current track, so MediaSession callers can report an
818
+ * invalid state instead of a success the controller then watches revert.
805
819
  */
806
- fun setActiveTrackFavorited(favorited: Boolean) {
807
- val index = exoPlayer.currentMediaItemIndex
808
- if (index == C.INDEX_UNSET) return
820
+ fun setActiveTrackFavorited(favorited: Boolean): Boolean {
821
+ val currentTrack = this.currentTrack ?: return false
809
822
 
810
- val currentTrack = this.currentTrack ?: return
811
-
812
- // Update native favorites cache (only tracks with src can be favorited)
813
- currentTrack.src?.let { src -> browser?.browserManager?.updateFavorite(src, favorited) }
814
-
815
- // Create updated Track with new favorited state
816
- val updatedTrack =
817
- Track(
818
- url = currentTrack.url,
819
- src = currentTrack.src,
820
- artwork = currentTrack.artwork,
821
- artworkSource = currentTrack.artworkSource,
822
- artworkCarPlayTinted = currentTrack.artworkCarPlayTinted,
823
- title = currentTrack.title,
824
- subtitle = currentTrack.subtitle,
825
- artist = currentTrack.artist,
826
- album = currentTrack.album,
827
- description = currentTrack.description,
828
- genre = currentTrack.genre,
829
- duration = currentTrack.duration,
830
- style = currentTrack.style,
831
- childrenStyle = currentTrack.childrenStyle,
832
- favorited = favorited,
833
- groupTitle = currentTrack.groupTitle,
834
- live = currentTrack.live,
835
- imageRow = currentTrack.imageRow,
836
- )
823
+ currentTrack.identity?.let { identity ->
824
+ browser?.browserManager?.updateFavorite(identity, favorited)
825
+ }
837
826
 
838
- // Use buildUpon() on the existing MediaItem to update only the metadata
839
- // This preserves internal references and avoids playback interruption
840
- // Note: setTag() requires setUri() to be called, so we must re-set the URI
841
- val currentMediaItem = exoPlayer.getMediaItemAt(index)
842
- val updatedMetadata =
843
- currentMediaItem.mediaMetadata.buildUpon().setUserRating(HeartRating(favorited)).build()
844
- val updatedMediaItem =
845
- currentMediaItem
846
- .buildUpon()
847
- .setUri(currentMediaItem.localConfiguration?.uri)
848
- .setMediaMetadata(updatedMetadata)
849
- .setTag(updatedTrack)
850
- .build()
851
-
852
- exoPlayer.replaceMediaItem(index, updatedMediaItem)
853
-
854
- // Update the heart button icon in notification/Android Auto
855
- updateFavoriteButtonState(favorited)
827
+ val index = sessionPlayer.currentMediaItemIndex
828
+ // Still applied: the favorite is persisted above, and there is no heart to revert.
829
+ if (index == C.INDEX_UNSET) return true
856
830
 
857
- // Notify JS of the favorite state change
858
- callbacks?.onFavoriteChanged(FavoriteChangedEvent(updatedTrack, favorited))
831
+ val updatedTrack = currentTrack.copy(favorited = favorited)
832
+ restampMediaItem(index, updatedTrack) { setFavorite(favorited) }
859
833
 
860
- // Emit active track changed so useActiveTrack() hook updates
861
- val activeTrackEvent =
862
- PlaybackActiveTrackChangedEvent(
863
- lastIndex = index.toDouble(),
864
- lastTrack = currentTrack,
865
- lastPosition = exoPlayer.currentPosition.toSeconds(),
866
- index = index.toDouble(),
867
- track = updatedTrack,
868
- )
869
- callbacks?.onPlaybackActiveTrackChanged(activeTrackEvent)
834
+ updateFavoriteButtonState(favorited)
870
835
 
871
- // Emit queue changed so useQueue() hook updates
872
- callbacks?.onPlaybackQueueChanged(tracks)
836
+ // The only emit: a favorite toggle mutates the active track in place, so the track and queue
837
+ // change events stay transition-only.
838
+ callbacks?.onFavoriteChanged(FavoriteChangedEvent(updatedTrack, favorited))
839
+ return true
873
840
  }
874
841
 
875
- /** Toggles the favorited state of the currently playing track. */
876
- fun toggleActiveTrackFavorited() {
877
- val currentTrack = this.currentTrack ?: return
878
- setActiveTrackFavorited(currentTrack.favorited != true)
842
+ fun toggleActiveTrackFavorited(): Boolean {
843
+ val currentTrack = this.currentTrack ?: return false
844
+ return setActiveTrackFavorited(currentTrack.favorited != true)
879
845
  }
880
846
 
881
847
  // MARK: - Now Playing Metadata
882
848
 
849
+ /** [NowPlayingUpdater] does the rendering; this is its platform surface. */
850
+ val nowPlaying: NowPlayingUpdater =
851
+ NowPlayingUpdater(
852
+ object : NowPlayingSurface {
853
+ override val currentIndex
854
+ get() = this@Player.currentIndex
855
+
856
+ override val currentTrack
857
+ get() = this@Player.currentTrack
858
+
859
+ override val playbackState
860
+ get() = this@Player.playbackState
861
+
862
+ override val playbackError
863
+ get() = this@Player.playbackError
864
+
865
+ override val playWhenReady
866
+ get() = shouldPlayWhenReady
867
+
868
+ override val isRebuffering
869
+ get() = loadControl.isRebuffering
870
+
871
+ override val isOnline
872
+ get() = networkMonitor.getOnline()
873
+
874
+ override val hasNowPlayingArtworkConfig
875
+ get() = browser?.browserManager?.config?.nowPlayingArtwork != null
876
+
877
+ override fun stampFields(
878
+ index: Int,
879
+ track: Track,
880
+ title: String?,
881
+ secondaryLine: String?,
882
+ album: String?,
883
+ ) =
884
+ restampMediaItem(index, track) {
885
+ setTitle(title)
886
+ .setDisplayTitle(title)
887
+ .setArtist(secondaryLine)
888
+ // Android Auto reads DISPLAY_SUBTITLE, not ARTIST, once DISPLAY_TITLE is set;
889
+ // `artist` still drives the lock screen and notification.
890
+ .setSubtitle(secondaryLine)
891
+ .setAlbumTitle(album)
892
+ }
893
+
894
+ override fun stampArtwork(index: Int, track: Track, uri: String) =
895
+ restampMediaItem(index, track) { setArtworkUri(uri.toUri()) }
896
+
897
+ override suspend fun resolveNowPlayingArtwork(track: Track, sizePx: Double): String? {
898
+ val browserManager = browser?.browserManager ?: return null
899
+ val config = browserManager.config.nowPlayingArtwork ?: return null
900
+ val resolved =
901
+ try {
902
+ browserManager.resolveArtworkUrl(track, config, ImageContext(sizePx, sizePx))
903
+ } catch (e: Exception) {
904
+ Timber.e(e, "Failed to resolve now-playing artwork for track id=${track.id}")
905
+ null
906
+ }
907
+ val uri = resolved?.uri?.takeIf { it.isNotEmpty() } ?: return null
908
+ val published =
909
+ TrackFactory.sessionArtworkUri(uri, resolved.headers, SvgArtworkRenderer.isSvgUrl(uri))
910
+ // Media3 hands this URI back to the bitmap loader, which re-resolves it with the
911
+ // nowPlayingArtwork config rather than the global artwork config.
912
+ browserManager.artworkResolutions.register(published, track, config)
913
+ return published
914
+ }
915
+
916
+ override fun emitNowPlayingChanged(metadata: NowPlayingMetadata) {
917
+ callbacks?.onNowPlayingChanged(metadata)
918
+ }
919
+ },
920
+ MainScope(),
921
+ )
922
+
883
923
  /**
884
- * Updates the now playing notification metadata. Pass null to clear overrides and revert to track
885
- * metadata.
924
+ * One replacement for the whole queue: each separate one is a timeline change and a queue event
925
+ * to JS.
886
926
  */
887
- fun updateNowPlaying(update: NowPlayingUpdate?) {
888
- nowPlayingOverride = update
889
- applyNowPlayingMetadata()
890
- }
891
-
892
- /** Gets the current now playing metadata (override if set, else track metadata). */
893
- fun getNowPlaying(): NowPlayingMetadata? {
894
- val track = currentTrack ?: return null
895
- val override = nowPlayingOverride
896
-
897
- return NowPlayingMetadata(
898
- elapsedTime = null,
899
- title = override?.title ?: track.title,
900
- album = track.album,
901
- artist = override?.artist ?: track.artist,
902
- duration = track.duration,
903
- artwork = track.artwork,
904
- description = track.description,
905
- mediaId = track.src ?: track.url,
906
- genre = track.genre,
907
- rating = null, // TODO: map track.favorited to rating if needed
927
+ private fun restampFavorites() {
928
+ if (!::sessionPlayer.isInitialized || sessionPlayer.mediaItemCount == 0) return
929
+ val items =
930
+ (0 until sessionPlayer.mediaItemCount).map { index ->
931
+ val item = sessionPlayer.getMediaItemAt(index)
932
+ val track = item.localConfiguration?.tag as? Track ?: return@map item
933
+ item.restamped(track) { setFavorite(track.favorited) }
934
+ }
935
+ sessionPlayer.replaceMediaItems(0, items.size, items)
936
+ }
937
+
938
+ private fun restampMediaItem(
939
+ index: Int,
940
+ track: Track,
941
+ mutate: MediaMetadata.Builder.() -> MediaMetadata.Builder,
942
+ ) {
943
+ sessionPlayer.replaceMediaItem(
944
+ index,
945
+ sessionPlayer.getMediaItemAt(index).restamped(track, mutate),
908
946
  )
909
947
  }
910
948
 
911
- /**
912
- * Clears the now playing override when track changes. Called from
913
- * PlayerListener.onMediaItemTransition.
914
- */
915
- internal fun clearNowPlayingOverride() {
916
- nowPlayingOverride = null
949
+ /** Keeps the uri so ExoPlayer updates the item in place instead of reloading it. */
950
+ private fun MediaItem.restamped(
951
+ track: Track,
952
+ mutate: MediaMetadata.Builder.() -> MediaMetadata.Builder,
953
+ ): MediaItem =
954
+ buildUpon()
955
+ .setUri(localConfiguration?.uri)
956
+ .setMediaMetadata(mediaMetadata.buildUpon().mutate().build())
957
+ .setTag(track)
958
+ .build()
959
+
960
+ private fun newRetryLoop(options: PlayerSetupOptions): RetryLoop? {
961
+ val (maxRetries, recoveryMs, firstConnectMs) =
962
+ when (val policy = options.retryPolicy) {
963
+ RetryPolicy.Default -> return null
964
+ is RetryPolicy.Infinite ->
965
+ Triple(null, policy.maxRetryDurationMs, policy.firstConnectMaxRetryDurationMs)
966
+ is RetryPolicy.Limited ->
967
+ Triple(
968
+ policy.maxRetries,
969
+ policy.maxRetryDurationMs,
970
+ policy.firstConnectMaxRetryDurationMs,
971
+ )
972
+ }
973
+ val recovery = recoveryMs ?: 120_000
974
+ val firstConnect = firstConnectMs ?: 12_000
975
+ retryLocks =
976
+ RetryLocks(context, options.wakeMode, maxHoldMs = recovery + firstConnect, mainHandler)
977
+ return RetryLoop(
978
+ clock = SystemClock::elapsedRealtime,
979
+ timer = { delayMs, action ->
980
+ val runnable = Runnable(action)
981
+ mainHandler.postDelayed(runnable, delayMs)
982
+ val cancel: () -> Unit = { mainHandler.removeCallbacks(runnable) }
983
+ cancel
984
+ },
985
+ engine = retryEngine,
986
+ maxRetries = maxRetries,
987
+ recoveryMs = recovery,
988
+ firstConnectMs = firstConnect,
989
+ online = networkMonitor.getOnline(),
990
+ )
991
+ .also {
992
+ it.playIntentChanged(shouldPlayWhenReady)
993
+ if (localEngine.isActive && exoPlayer.playbackState != MediaPlayer.STATE_IDLE) {
994
+ it.loadStarted()
995
+ it.isPlayingChanged(exoPlayer.isPlaying)
996
+ } else {
997
+ it.suspend()
998
+ }
999
+ }
917
1000
  }
918
1001
 
919
1002
  /**
920
- * Resets the retry timer when track changes. Called from PlayerListener.onMediaItemTransition.
1003
+ * A new Load for the retry loop (ADR 0014): a track change, or the phone taking over playback.
921
1004
  */
922
- internal fun resetRetryTimer() {
923
- mediaFactory.resetRetryTimer()
1005
+ internal fun startRetryLoad() {
1006
+ playingMediaId = exoPlayer.currentMediaItem?.mediaId
1007
+ val loop = retryLoop ?: return
1008
+ if (!localEngine.isActive) return loop.suspend()
1009
+ lastLoadFailure = null
1010
+ if (exoPlayer.playbackState == MediaPlayer.STATE_IDLE) {
1011
+ // Nothing connects an idle engine's new track but a prepare, and leaving idle starts its
1012
+ // Load.
1013
+ val held = loop.reconnecting
1014
+ loop.suspend()
1015
+ if (held) exoPlayer.prepare()
1016
+ return
1017
+ }
1018
+ loop.loadStarted()
1019
+ loop.isPlayingChanged(exoPlayer.isPlaying)
924
1020
  }
925
1021
 
926
1022
  /**
927
- * Applies the current now playing metadata to the media notification. Uses the override if set,
928
- * otherwise uses track metadata.
1023
+ * The engine state the listener and the session are shown: the retry loop's idle engine reads
1024
+ * buffering, and so does a READY blip before a failed connection's error surfaces.
929
1025
  */
930
- private fun applyNowPlayingMetadata() {
931
- val index = currentIndex ?: return
932
- val track = currentTrack ?: return
933
- val override = nowPlayingOverride
934
-
935
- val currentMediaItem = exoPlayer.getMediaItemAt(index)
936
- val updatedMetadata =
937
- currentMediaItem.mediaMetadata
938
- .buildUpon()
939
- .setTitle(override?.title ?: track.title)
940
- .setDisplayTitle(override?.title ?: track.title)
941
- .setArtist(override?.artist ?: track.artist)
942
- .build()
943
-
944
- val updatedMediaItem =
945
- currentMediaItem
946
- .buildUpon()
947
- .setUri(currentMediaItem.localConfiguration?.uri)
948
- .setMediaMetadata(updatedMetadata)
949
- .setTag(track)
950
- .build()
951
-
952
- exoPlayer.replaceMediaItem(index, updatedMediaItem)
953
-
954
- // Notify JS of the now playing metadata change
955
- getNowPlaying()?.let { callbacks?.onNowPlayingChanged(it) }
1026
+ internal fun retryView(@MediaPlayer.State engineState: Int): Int {
1027
+ val loop = retryLoop?.takeIf { localEngine.isActive } ?: return engineState
1028
+ return RetryView.engineState(
1029
+ engineState,
1030
+ loop.reconnecting,
1031
+ loop.failurePending,
1032
+ exoPlayer.totalBufferedDuration,
1033
+ )
1034
+ }
1035
+
1036
+ /** Whether the engine's playing is a blip the retry loop hides; see [retryView]. */
1037
+ internal val retryMasksPlaying: Boolean
1038
+ get() =
1039
+ localEngine.isActive &&
1040
+ RetryView.isBlip(retryLoop?.failurePending == true, exoPlayer.totalBufferedDuration)
1041
+
1042
+ /** Main thread only (ExoPlayer access). */
1043
+ private fun findQueueTrackByArtworkUri(uri: String): Track? {
1044
+ for (i in 0 until sessionPlayer.mediaItemCount) {
1045
+ val item = sessionPlayer.getMediaItemAt(i)
1046
+ if (item.mediaMetadata.artworkUri?.toString() == uri) {
1047
+ return item.localConfiguration?.tag as? Track
1048
+ }
1049
+ }
1050
+ return null
956
1051
  }
957
1052
 
958
1053
  /**
959
- * Updates the favorite button icon in the notification/Android Auto. Call this when track changes
960
- * or favorite state changes.
1054
+ * For [CoilBitmapLoader]: the resolution registry, then the queue track that published [uri],
1055
+ * then headers alone for a URI nothing attributes. Null means fetch the URI as-is.
961
1056
  */
1057
+ suspend fun resolveDisplayArtwork(uri: String, sizeHintPixels: Int?): ImageSource? {
1058
+ val browserManager = browser?.browserManager ?: return null
1059
+ val imageContext =
1060
+ sizeHintPixels?.takeIf { it > 0 }?.let { ImageContext(it.toDouble(), it.toDouble()) }
1061
+ browserManager.displayArtworkSource(uri, imageContext)?.let {
1062
+ return it
1063
+ }
1064
+ // On Android Automotive OS the queue publishes provider URIs; the resolutions are keyed by URL.
1065
+ TrackFactory.artworkRoutes
1066
+ ?.publicUrl(uri.toUri())
1067
+ ?.takeIf { it != uri }
1068
+ ?.let { browserManager.displayArtworkSource(it, imageContext) }
1069
+ ?.let {
1070
+ return it
1071
+ }
1072
+ withContext(Dispatchers.Main) { findQueueTrackByArtworkUri(uri) }
1073
+ ?.let { track ->
1074
+ return browserManager.resolveArtworkUrl(track, null, imageContext)
1075
+ }
1076
+ return browserManager.unattributedArtworkSource(uri)
1077
+ }
1078
+
962
1079
  internal fun updateFavoriteButtonState(favorited: Boolean?) {
963
1080
  if (!::mediaSession.isInitialized) return
964
1081
  mediaSessionCallback.commandManager.updateFavoriteState(mediaSession, favorited)
965
1082
  }
966
1083
 
967
- /** Removes all the upcoming tracks, if any (the ones returned by [next]). */
1084
+ internal fun updateLiveState(live: Boolean) {
1085
+ if (!::mediaSession.isInitialized) return
1086
+ mediaSessionCallback.commandManager.updateLiveState(mediaSession, live)
1087
+ }
1088
+
968
1089
  fun removeUpcomingTracks() {
969
- val index = exoPlayer.currentMediaItemIndex
1090
+ val index = sessionPlayer.currentMediaItemIndex
970
1091
  if (index == C.INDEX_UNSET) return
971
- val lastIndex = exoPlayer.mediaItemCount
1092
+ val lastIndex = sessionPlayer.mediaItemCount
972
1093
  val fromIndex = index + 1
973
1094
 
974
- exoPlayer.removeMediaItems(fromIndex, lastIndex)
1095
+ sessionPlayer.removeMediaItems(fromIndex, lastIndex)
975
1096
  }
976
1097
 
977
1098
  fun play() {
978
- exoPlayer.play()
979
- if (currentTrack != null) {
980
- exoPlayer.prepare()
981
- }
1099
+ playWhenReady = true
982
1100
  }
983
1101
 
984
1102
  /**
985
- * Executes a search and plays the results. Used for voice commands with structured search
986
- * parameters.
987
- *
988
- * @param params The structured search parameters (mode, query, artist, album, etc.)
989
- * @return true if search succeeded and playback started, false otherwise
1103
+ * No-op unless the track declares `live`; ExoPlayer never marks progressive ICY radio live. A
1104
+ * stream with a live window seeks to its edge; anything else reconnects, which for a non-seekable
1105
+ * stream is the live edge.
1106
+ */
1107
+ fun seekToLiveEdge() {
1108
+ if (currentTrack?.live != true || liveStreamParked) return
1109
+ // A receiver loads a live stream again on a seek to its default position.
1110
+ if (!localEngine.reconnectAtLiveEdge()) sessionPlayer.seekToDefaultPosition()
1111
+ }
1112
+
1113
+ /**
1114
+ * @return whether a result started playing: false when gated (after onGate), with no results, or
1115
+ * on any error, the browser's registration timeout included.
990
1116
  */
991
1117
  suspend fun playFromSearch(params: SearchParams): Boolean {
992
1118
  return try {
993
- val browserManager = awaitBrowser().browserManager
1119
+ val audioBrowser = awaitBrowser()
1120
+ // Gated like browsing, or voice search would be a way around the gate.
1121
+ val gateOutcome =
1122
+ audioBrowser.gateDecision(
1123
+ NativeGateRequest(reason = GateReason.SEARCH, path = null, search = params)
1124
+ )
1125
+ if (gateOutcome.gated) {
1126
+ Timber.i("playFromSearch refused — request is gated")
1127
+ audioBrowser.onGate(GateEvent(GateReason.SEARCH))
1128
+ return false
1129
+ }
1130
+ val browserManager = audioBrowser.browserManager
994
1131
 
995
1132
  Timber.d(
996
1133
  "Executing voice search: mode=${params.mode}, query='${params.query}', artist='${params.artist}', album='${params.album}'"
@@ -1007,150 +1144,282 @@ class Player(internal val context: Context) {
1007
1144
  false
1008
1145
  }
1009
1146
  } catch (e: Exception) {
1147
+ currentCoroutineContext().ensureActive()
1010
1148
  Timber.e(e, "Error handling voice search: ${params}")
1011
1149
  false
1012
1150
  }
1013
1151
  }
1014
1152
 
1153
+ /** An ended queue stays ended, as on an ended engine. */
1015
1154
  fun prepare() {
1016
- if (currentTrack != null) {
1017
- exoPlayer.prepare()
1018
- }
1155
+ if (liveStreamParked) return
1156
+ if (currentTrack != null && playbackState != PlaybackState.ENDED) sessionPlayer.prepare()
1019
1157
  }
1020
1158
 
1021
1159
  fun pause() {
1022
- exoPlayer.pause()
1160
+ playWhenReady = false
1023
1161
  }
1024
1162
 
1025
1163
  fun togglePlayback() {
1026
- if (exoPlayer.playWhenReady) {
1027
- pause()
1028
- } else {
1029
- play()
1164
+ when {
1165
+ // Suppressed with the intent raised: ExoPlayer resumes when focus returns. play() would
1166
+ // request focus again, and during a call that refusal drops the intent.
1167
+ playWhenReady && !shouldPlayWhenReady -> Unit
1168
+ PlayingStateFactory.derive(shouldPlayWhenReady, playbackState).playing -> pause()
1169
+ else -> play()
1030
1170
  }
1031
1171
  }
1032
1172
 
1033
- /**
1034
- * Stops playback, without clearing the active track. Calling this method will cause the playback
1035
- * state to transition to State.NONE and the player will release the loaded media and resources
1036
- * required for playback.
1037
- */
1173
+ /** Keeps the queue; the state becomes STOPPED. */
1038
1174
  fun stop() {
1039
- playbackState = PlaybackState.STOPPED
1040
- exoPlayer.playWhenReady = false
1041
- exoPlayer.stop()
1175
+ nowPlaying.clearTimedMetadata()
1176
+ // State first, so the state machine's STOPPED guard swallows the PAUSED the drop below causes.
1177
+ setPlaybackState(PlaybackState.STOPPED)
1178
+ val ended = sessionPlayer.playbackState == MediaPlayer.STATE_ENDED
1179
+ playWhenReady = false
1180
+ // The next play is a new Load.
1181
+ retryLoop?.suspend()
1182
+ sessionPlayer.stop()
1183
+ playerListener.fenceOutgoingMetadata()
1184
+ // Idle at its end, the next prepare would end it again at once.
1185
+ if (ended) sessionPlayer.seekToDefaultPosition()
1042
1186
  }
1043
1187
 
1044
1188
  fun clear() {
1045
- exoPlayer.clearMediaItems()
1189
+ sessionPlayer.clearMediaItems()
1046
1190
  queueSourcePath = null
1047
1191
  }
1048
1192
 
1049
- /**
1050
- * Stops and destroys the player. Only call this when you are finished using the player, otherwise
1051
- * use [pause].
1052
- */
1193
+ /** Idempotent. */
1053
1194
  fun destroy() {
1195
+ if (destroyed) return
1196
+ destroyed = true
1197
+ deferredSetup = null
1198
+ // stop() saves only if playing; before it, so its STOPPED doesn't defeat the ENDED guard.
1199
+ playbackStateStore.stopPeriodicSave()
1200
+ // An armed timer would fire pause() into the released player. Cleared before the release,
1201
+ // while a mid-ramp fade can still restore the volume.
1202
+ sleepTimer.clear()
1054
1203
  stop()
1204
+ nowPlaying.destroy()
1205
+ mediaSessionCallback.destroy()
1055
1206
  forwardingPlayer.removeListener(playerListener)
1056
1207
  automaticBufferManager?.detach()
1057
1208
  automaticBufferManager = null
1209
+ remoteOutputs.release()
1058
1210
  exoPlayer.release()
1059
1211
  cache?.release()
1060
1212
  cache = null
1061
1213
  networkMonitor.destroy()
1062
- equalizerManager?.release()
1063
- equalizerManager = null
1214
+ equalizer.release()
1064
1215
  }
1065
1216
 
1066
1217
  fun seekTo(duration: Long, unit: TimeUnit) {
1067
1218
  val positionMs = TimeUnit.MILLISECONDS.convert(duration, unit)
1068
- exoPlayer.seekTo(positionMs)
1219
+ sessionPlayer.seekTo(positionMs)
1069
1220
  }
1070
1221
 
1071
1222
  fun seekBy(offset: Long, unit: TimeUnit) {
1072
- val positionMs = exoPlayer.currentPosition + TimeUnit.MILLISECONDS.convert(offset, unit)
1073
- exoPlayer.seekTo(positionMs)
1223
+ val positionMs = sessionPlayer.currentPosition + TimeUnit.MILLISECONDS.convert(offset, unit)
1224
+ sessionPlayer.seekTo(positionMs)
1074
1225
  }
1075
1226
 
1076
1227
  /**
1077
- * Updates the player state and emits a state change event if the state has changed. Only emits an
1078
- * event if the new state differs from the current state.
1079
- *
1080
- * IMPORTANT: This method also triggers the queue ended event when the player reaches State.ENDED
1081
- * and is on the last track. All state transitions should go through this method to ensure proper
1082
- * event dispatching. Direct assignments to playerState will bypass event emission.
1083
- *
1084
- * @param state The new player state to set
1228
+ * Bumped on track change and seek so an [onLoadFailure] post for an earlier connection is
1229
+ * dropped. Written on main, read on ExoPlayer's playback thread.
1230
+ */
1231
+ @Volatile private var retryingErrorGeneration = 0
1232
+
1233
+ /**
1234
+ * A recoverable load failure, on ExoPlayer's playback thread. Posted to main ahead of the state
1235
+ * changes it causes, so the retry loop holds the engine before its READY blip or error arrives.
1236
+ * It also attaches the failure to the current state, for UIs to show over the spinner: not an
1237
+ * ERROR and not [Callbacks.onPlaybackError], which stays terminal.
1238
+ */
1239
+ internal fun onLoadFailure(exception: IOException, inPlace: Boolean) {
1240
+ val atMs = SystemClock.elapsedRealtime()
1241
+ lastLoadFailure = exception
1242
+ val error = PlaybackErrorClassifier.retryingLoadError(exception, networkMonitor.getOnline())
1243
+ val generation = retryingErrorGeneration
1244
+ mainHandler.post {
1245
+ if (generation != retryingErrorGeneration) return@post
1246
+ if (localEngine.isActive) retryLoop?.connectionFailed(inPlace, atMs)
1247
+ showRetryingError(error)
1248
+ }
1249
+ }
1250
+
1251
+ /** Drops the [onLoadFailure] reports still on their way: they belong to an earlier connection. */
1252
+ internal fun dropFailureReports() {
1253
+ retryingErrorGeneration++
1254
+ }
1255
+
1256
+ private fun showRetryingError(error: PlaybackError) {
1257
+ // Paused, the retry would run unseen and its failure be terminal. STOPPED, ERROR and ENDED
1258
+ // reach here only from a post that raced them.
1259
+ if (
1260
+ !playWhenReady &&
1261
+ playbackState !in setOf(PlaybackState.STOPPED, PlaybackState.ERROR, PlaybackState.ENDED)
1262
+ ) {
1263
+ return stopRetrying()
1264
+ }
1265
+ // Only over a spinner: while PLAYING, buffered audio still plays and ExoPlayer's in-place
1266
+ // retry can succeed with no state change, so an error attached there would never clear.
1267
+ if (
1268
+ playbackState != PlaybackState.LOADING &&
1269
+ playbackState != PlaybackState.BUFFERING &&
1270
+ playbackState != PlaybackState.PAUSED
1271
+ ) {
1272
+ return
1273
+ }
1274
+ // Each backoff tick re-reports the same error.
1275
+ if (playbackError == error) return
1276
+ playbackError = error
1277
+ callbacks?.onPlaybackChanged(Playback(playbackState, error))
1278
+ nowPlaying.render()
1279
+ }
1280
+
1281
+ /**
1282
+ * Cancels the retry a dropped play intent leaves scheduled. No-op unless a retrying error shows.
1283
+ */
1284
+ internal fun cancelRetry() {
1285
+ // The ENDED path drops the intent before it clears the error.
1286
+ if (playbackError?.retrying != true || playbackState == PlaybackState.ENDED) return
1287
+ stopRetrying()
1288
+ }
1289
+
1290
+ /**
1291
+ * A paused engine goes on loading a live stream until its buffer is full, and a resume plays what
1292
+ * it buffered, behind the stream. The engine idles in PAUSED instead, closing the connection, and
1293
+ * the next play's prepare() reconnects at the live edge.
1294
+ */
1295
+ internal fun dropLiveConnection() {
1296
+ if (currentTrack?.live != true || !localEngine.isActive || liveItemPausable) return
1297
+ if (playbackState !in LIVE_CONNECTION_STATES) return
1298
+ if (exoPlayer.playbackState == ExoPlayer.STATE_IDLE) return
1299
+ stopRetrying()
1300
+ }
1301
+
1302
+ /** A live window that seeks at least [PAUSABLE_LIVE_WINDOW_MS] behind its live edge. */
1303
+ private val liveItemPausable: Boolean
1304
+ get() {
1305
+ val timeline = exoPlayer.currentTimeline
1306
+ if (timeline.isEmpty) return false
1307
+ val window = timeline.getWindow(exoPlayer.currentMediaItemIndex, Timeline.Window())
1308
+ return window.isDynamic &&
1309
+ window.isSeekable &&
1310
+ !window.isPlaceholder &&
1311
+ window.defaultPositionMs >= PAUSABLE_LIVE_WINDOW_MS
1312
+ }
1313
+
1314
+ /** A live track paused on an idle engine: it reconnects only to play, at the live edge. */
1315
+ private val liveStreamParked: Boolean
1316
+ get() =
1317
+ currentTrack?.live == true &&
1318
+ !playWhenReady &&
1319
+ localEngine.isActive &&
1320
+ exoPlayer.playbackState == ExoPlayer.STATE_IDLE
1321
+
1322
+ /**
1323
+ * Gives up a load ExoPlayer would retry. The engine idles in PAUSED, where the next prepare()
1324
+ * reloads where it failed.
1325
+ */
1326
+ private fun stopRetrying() {
1327
+ // Before the stop: the state machine holds PAUSED through the IDLE that follows.
1328
+ setPlaybackState(PlaybackState.PAUSED)
1329
+ clearRetryingError()
1330
+ exoPlayer.stop()
1331
+ // An engine the loop already holds idle leaves no IDLE for the listener to see.
1332
+ retryLoop?.engineStopped()
1333
+ }
1334
+
1335
+ /**
1336
+ * Drops the retrying error of a track that is gone. The new track may stay LOADING or BUFFERING
1337
+ * with no state change to emit the clear.
1085
1338
  */
1339
+ internal fun clearRetryingError() {
1340
+ dropFailureReports()
1341
+ if (playbackError?.retrying != true) return
1342
+ playbackError = null
1343
+ callbacks?.onPlaybackChanged(Playback(playbackState, null))
1344
+ nowPlaying.render()
1345
+ }
1346
+
1347
+ /** Every state change goes through here: it emits the change and the events that follow it. */
1086
1348
  internal fun setPlaybackState(state: PlaybackState) {
1087
1349
  if (state != playbackState) {
1088
1350
  val oldState = playbackState
1089
1351
  playbackState = state
1090
1352
 
1091
- // Clear error when transitioning away from error state
1353
+ forwardingPlayer.onStateChanged(oldState)
1354
+ // Whatever restarts playback from it starts a new Load.
1355
+ if (state == PlaybackState.ERROR) retryLoop?.suspend()
1356
+
1357
+ // A natural end exhausts the play intent; held, it inverts the toggle, keeps audio focus and
1358
+ // the periodic save. Emitted before the state and queue-ended callbacks, matching iOS. The
1359
+ // state machine's ENDED guard keeps the drop from reporting PAUSED.
1360
+ if (state == PlaybackState.ENDED && playWhenReady) {
1361
+ playWhenReady = false
1362
+ emitPlayWhenReadyChanged(false)
1363
+ }
1364
+
1365
+ // The last track fires no AUTO transition, so the end-of-track sleep timer would stay armed.
1366
+ if (state == PlaybackState.ENDED) {
1367
+ sleepTimer.onTrackEnd()
1368
+ }
1369
+
1092
1370
  if (oldState == PlaybackState.ERROR) {
1093
1371
  playbackError = null
1094
1372
  callbacks?.onPlaybackError(null)
1095
1373
  }
1096
1374
 
1375
+ // A retrying error rides through LOADING, BUFFERING and PAUSED; any other state proves
1376
+ // recovery or abandons the attempt.
1377
+ if (
1378
+ playbackError?.retrying == true &&
1379
+ state != PlaybackState.LOADING &&
1380
+ state != PlaybackState.BUFFERING &&
1381
+ state != PlaybackState.PAUSED
1382
+ ) {
1383
+ playbackError = null
1384
+ }
1385
+
1097
1386
  val playback = Playback(state, playbackError)
1098
1387
  callbacks?.onPlaybackChanged(playback)
1099
1388
 
1100
- // Emit queue ended event when playback ends on the last track
1101
- // This coupling ensures queue ended events are always triggered consistently with state
1102
- // changes
1103
- if (state == PlaybackState.ENDED && isLastTrack) {
1389
+ // The formatter sees the state, so any transition can change what it renders.
1390
+ nowPlaying.render()
1391
+
1392
+ // A repeat mode never ends the queue, even on an ENDED from a seek to the end.
1393
+ if (state == PlaybackState.ENDED && isLastInPlaybackOrder && repeatMode == RepeatMode.OFF) {
1104
1394
  currentIndex?.let { index ->
1105
1395
  val event =
1106
1396
  PlaybackQueueEndedEvent(track = index.toDouble(), position = position.toSeconds())
1107
1397
  callbacks?.onPlaybackQueueEnded(event)
1108
1398
  }
1109
- // Reset saved position to 0 so resumption starts from beginning (only when not repeating)
1110
- if (repeatMode == RepeatMode.OFF) {
1111
- playbackStateStore.savePositionZero()
1112
- }
1399
+ playbackStateStore.savePositionZero()
1113
1400
  }
1114
1401
 
1115
- progressUpdateManager.onPlaybackStateChanged(state)
1116
- val newPlayingState = PlayingStateFactory.derive(playWhenReady, state)
1117
- if (newPlayingState != playingState) {
1118
- Timber.d(
1119
- "PlayingState changed: playing=${newPlayingState.playing}, buffering=${newPlayingState.buffering}"
1120
- )
1121
- playingState = newPlayingState
1122
- callbacks?.onPlaybackPlayingState(playingState)
1123
- }
1402
+ progressTimer.onPlaybackStateChanged(state)
1403
+ intervalTimer.onPlaybackStateChanged(state)
1404
+ refreshPlayingState()
1124
1405
  }
1125
1406
  }
1126
1407
 
1127
- /**
1128
- * Sets the progress update interval.
1129
- *
1130
- * @param interval The interval in seconds, or null to disable progress updates
1131
- */
1408
+ /** [interval] in seconds; null stops the progress events. */
1132
1409
  fun setProgressUpdateInterval(interval: Double?) {
1133
- progressUpdateManager.setUpdateInterval(interval)
1410
+ progressTimer.setInterval(interval)
1411
+ }
1412
+
1413
+ fun setPlaybackIntervalEnabled(enabled: Boolean) {
1414
+ intervalTimer.setInterval(if (enabled) 1.0 else null)
1134
1415
  }
1135
1416
 
1136
- /**
1137
- * Applies update options with change detection. Only updates properties that have actually
1138
- * changed and emits events accordingly.
1139
- *
1140
- * @param options The new options to apply
1141
- * @param mediaSession The MediaSession to update when capabilities change
1142
- */
1143
1417
  fun applyOptions(options: PlayerUpdateOptions) {
1144
- // Store previous values for change detection
1145
1418
  val previousOptions = this.options
1146
1419
 
1147
- // Update current options
1148
1420
  this.options = options.copy()
1149
1421
 
1150
- // Check what changed
1151
1422
  val skipSilenceChanged = previousOptions.skipSilence != options.skipSilence
1152
- val ratingTypeChanged = previousOptions.ratingType != options.ratingType
1153
- val shuffleChanged = previousOptions.shuffle != options.shuffle
1154
1423
  val progressUpdateEventIntervalChanged =
1155
1424
  previousOptions.progressUpdateEventInterval != options.progressUpdateEventInterval
1156
1425
  val forwardJumpIntervalChanged =
@@ -1158,46 +1427,53 @@ class Player(internal val context: Context) {
1158
1427
  val backwardJumpIntervalChanged =
1159
1428
  previousOptions.backwardJumpInterval != options.backwardJumpInterval
1160
1429
  val capabilitiesChanged = previousOptions.capabilities != options.capabilities
1161
- val notificationButtonsChanged =
1162
- previousOptions.notificationButtons != options.notificationButtons
1430
+ val remoteButtonLayoutChanged =
1431
+ !previousOptions.remoteButtonLayout.sameAs(options.remoteButtonLayout)
1163
1432
  val appKilledPlaybackBehaviorChanged =
1164
1433
  previousOptions.appKilledPlaybackBehavior != options.appKilledPlaybackBehavior
1165
1434
 
1166
1435
  val hasChanged =
1167
1436
  skipSilenceChanged ||
1168
- ratingTypeChanged ||
1169
- shuffleChanged ||
1170
1437
  progressUpdateEventIntervalChanged ||
1171
1438
  forwardJumpIntervalChanged ||
1172
1439
  backwardJumpIntervalChanged ||
1173
1440
  capabilitiesChanged ||
1174
- notificationButtonsChanged ||
1441
+ remoteButtonLayoutChanged ||
1175
1442
  appKilledPlaybackBehaviorChanged
1176
1443
 
1177
- // Apply only changed properties
1178
1444
  if (skipSilenceChanged) {
1179
1445
  skipSilence = options.skipSilence
1180
1446
  }
1181
1447
 
1182
- if (ratingTypeChanged) {
1183
- options.ratingType?.let { ratingType = it }
1184
- }
1185
-
1186
- if (shuffleChanged) {
1187
- shuffleMode = options.shuffle
1448
+ if (capabilitiesChanged) {
1449
+ // The favorite capability is the one favoriting switch; the browser hydrates row hearts from
1450
+ // it.
1451
+ browser?.browserManager?.setFavoriteEnabled(options.capabilities.favoriteEnabled)
1452
+ TrackFactory.favoriteEnabled = options.capabilities.favoriteEnabled
1453
+ if (previousOptions.capabilities.favoriteEnabled != options.capabilities.favoriteEnabled) {
1454
+ restampFavorites()
1455
+ }
1188
1456
  }
1189
1457
 
1190
1458
  if (progressUpdateEventIntervalChanged) {
1191
1459
  setProgressUpdateInterval(options.progressUpdateEventInterval)
1192
1460
  }
1193
1461
 
1194
- if (capabilitiesChanged || notificationButtonsChanged) {
1462
+ // The jump intervals pick the button icons, so a changed interval rebuilds the layout.
1463
+ if (
1464
+ capabilitiesChanged ||
1465
+ remoteButtonLayoutChanged ||
1466
+ forwardJumpIntervalChanged ||
1467
+ backwardJumpIntervalChanged
1468
+ ) {
1195
1469
  val searchAvailable = browser?.browserManager?.config?.hasSearch ?: false
1196
1470
  mediaSessionCallback.updateMediaSession(
1197
1471
  mediaSession,
1198
1472
  options.capabilities,
1199
- options.notificationButtons,
1473
+ options.remoteButtonLayout,
1200
1474
  searchAvailable,
1475
+ options.forwardJumpInterval,
1476
+ options.backwardJumpInterval,
1201
1477
  )
1202
1478
  }
1203
1479
 
@@ -1206,20 +1482,10 @@ class Player(internal val context: Context) {
1206
1482
  }
1207
1483
  }
1208
1484
 
1209
- /**
1210
- * Sets the callbacks for player events.
1211
- *
1212
- * @param callbacks The callbacks to set, or null to clear callbacks
1213
- */
1214
1485
  fun setCallbacks(callbacks: Callbacks?) {
1215
1486
  this.callbacks = callbacks
1216
1487
  }
1217
1488
 
1218
- /**
1219
- * Gets the current callbacks instance.
1220
- *
1221
- * @return The current callbacks, or null if none are set
1222
- */
1223
1489
  fun getCallbacks(): Callbacks? {
1224
1490
  return this.callbacks
1225
1491
  }
@@ -1232,279 +1498,72 @@ class Player(internal val context: Context) {
1232
1498
  return options
1233
1499
  }
1234
1500
 
1235
- /**
1236
- * Gets the current network connectivity state.
1237
- *
1238
- * @return true if device is online, false otherwise
1239
- */
1240
1501
  fun getOnline(): Boolean {
1241
1502
  return networkMonitor.getOnline()
1242
1503
  }
1243
1504
 
1244
- /** Initializes the equalizer with the player's audio session ID. */
1245
- private fun initializeEqualizer() {
1246
- val audioSessionId = exoPlayer.audioSessionId
1247
- if (audioSessionId == C.AUDIO_SESSION_ID_UNSET) {
1248
- Timber.d("Skipping equalizer init - no audio session yet, will init on first playback")
1249
- return
1250
- }
1251
-
1252
- try {
1253
- equalizerManager =
1254
- EqualizerManager(audioSessionId).apply {
1255
- setOnSettingsChanged { settings -> callbacks?.onEqualizerChanged(settings) }
1256
- }
1257
- Timber.d("Equalizer initialized with session ID: $audioSessionId")
1258
- } catch (e: Exception) {
1259
- Timber.e(e, "Failed to initialize equalizer")
1260
- equalizerManager = null
1261
- }
1262
- }
1263
-
1264
- /**
1265
- * Reinitializes the equalizer when the audio session ID changes. Preserves current settings
1266
- * (enabled state, preset, or custom levels). Also handles first-time initialization when the
1267
- * equalizer was skipped at startup due to unset audio session ID.
1268
- */
1269
- internal fun reinitializeEqualizer(newAudioSessionId: Int) {
1270
- val oldManager = equalizerManager
1271
-
1272
- // First-time initialization (skipped at startup because session was unset)
1273
- if (oldManager == null) {
1274
- Timber.d("First-time equalizer initialization with session ID: $newAudioSessionId")
1275
- try {
1276
- equalizerManager =
1277
- EqualizerManager(newAudioSessionId).apply {
1278
- setOnSettingsChanged { settings -> callbacks?.onEqualizerChanged(settings) }
1279
- }
1280
- Timber.d("Equalizer initialized with session ID: $newAudioSessionId")
1281
- } catch (e: Exception) {
1282
- Timber.e(e, "Failed to initialize equalizer")
1283
- equalizerManager = null
1284
- }
1285
- return
1286
- }
1287
-
1288
- // Same session ID, no need to reinitialize
1289
- if (oldManager.audioSessionId == newAudioSessionId) {
1290
- return
1291
- }
1292
-
1293
- try {
1294
- // Capture current settings before releasing old equalizer
1295
- val currentSettings = oldManager.getSettings()
1296
-
1297
- // Release old equalizer
1298
- oldManager.release()
1299
-
1300
- // Create new equalizer with new session ID
1301
- equalizerManager =
1302
- EqualizerManager(newAudioSessionId).apply {
1303
- setOnSettingsChanged { settings -> callbacks?.onEqualizerChanged(settings) }
1304
- }
1305
-
1306
- // Restore previous settings if available
1307
- currentSettings?.let { settings ->
1308
- if (settings.activePreset != null) {
1309
- // Restore preset
1310
- equalizerManager?.setPreset(settings.activePreset)
1311
- } else if (settings.enabled) {
1312
- // Restore custom levels
1313
- equalizerManager?.setLevels(settings.bandLevels)
1314
- }
1315
- // Restore enabled state
1316
- equalizerManager?.setEnabled(settings.enabled)
1317
- }
1318
-
1319
- Timber.d("Equalizer reinitialized for new session ID: $newAudioSessionId")
1320
- } catch (e: Exception) {
1321
- Timber.e(e, "Failed to reinitialize equalizer")
1322
- equalizerManager = null
1323
- }
1324
- }
1325
-
1326
- /**
1327
- * Gets the current equalizer settings.
1328
- *
1329
- * @return Current equalizer settings or null if not available
1330
- */
1331
- fun getEqualizerSettings(): com.margelo.nitro.audiobrowser.EqualizerSettings? {
1332
- return equalizerManager?.getSettings()
1333
- }
1334
-
1335
- /**
1336
- * Enables or disables the equalizer.
1337
- *
1338
- * @param enabled true to enable, false to disable
1339
- */
1340
- fun setEqualizerEnabled(enabled: Boolean) {
1341
- equalizerManager?.setEnabled(enabled)
1342
- }
1343
-
1344
- /**
1345
- * Applies a preset to the equalizer.
1346
- *
1347
- * @param preset Name of the preset to apply
1348
- */
1349
- fun setEqualizerPreset(preset: String) {
1350
- equalizerManager?.setPreset(preset)
1351
- }
1352
-
1353
- /**
1354
- * Sets custom band levels for the equalizer.
1355
- *
1356
- * @param levels Array of level values in millibels for each band
1357
- */
1358
- fun setEqualizerLevels(levels: DoubleArray) {
1359
- equalizerManager?.setLevels(levels)
1360
- }
1361
-
1362
- // MARK: - Sleep Timer
1363
-
1364
- /**
1365
- * Gets the current sleep timer state.
1366
- *
1367
- * @return Sleep timer state or null if no timer is active
1368
- */
1369
- fun getSleepTimer(): NitroSleepTimer {
1370
- return when {
1371
- sleepTimer.time != null -> {
1372
- NitroSleepTimer.create(SleepTimerTime(sleepTimer.time!!))
1373
- }
1374
- sleepTimer.sleepWhenPlayedToEnd -> {
1375
- NitroSleepTimer.create(SleepTimerEndOfTrack(true))
1376
- }
1377
- else -> {
1378
- NitroSleepTimer.create(NullType.NULL)
1379
- }
1380
- }
1381
- }
1382
-
1383
- /**
1384
- * Sets a sleep timer to stop playback after the specified duration.
1385
- *
1386
- * @param seconds Number of seconds until playback stops
1387
- */
1388
- fun setSleepTimer(seconds: Double) {
1389
- sleepTimer.sleepAfter(seconds)
1390
- callbacks?.onSleepTimerChanged(getSleepTimer())
1391
- }
1392
-
1393
- /** Sets a sleep timer to stop playback when the current track finishes playing. */
1394
- fun setSleepTimerToEndOfTrack() {
1395
- sleepTimer.sleepWhenPlayedToEnd()
1396
- callbacks?.onSleepTimerChanged(getSleepTimer())
1397
- }
1398
-
1399
- /**
1400
- * Clears the active sleep timer.
1401
- *
1402
- * @return true if a timer was cleared, false if no timer was active
1403
- */
1404
- fun clearSleepTimer(): Boolean {
1405
- val wasRunning = sleepTimer.clear()
1406
- if (wasRunning) {
1407
- callbacks?.onSleepTimerChanged(NitroSleepTimer.create(NullType.NULL))
1408
- }
1409
- return wasRunning
1410
- }
1411
-
1412
- /**
1413
- * Checks if the sleep timer is set to end on track completion and stops playback if so. Called
1414
- * when a track naturally finishes playing.
1415
- */
1416
- internal fun checkSleepTimerOnTrackEnd() {
1417
- if (sleepTimer.sleepWhenPlayedToEnd) {
1418
- Timber.d("Sleep timer triggered on track end, stopping playback")
1419
- sleepTimer.clear()
1420
- stop()
1421
- callbacks?.onSleepTimerChanged(NitroSleepTimer.create(NullType.NULL))
1422
- }
1423
- }
1424
-
1425
- /**
1426
- * Validates that an index is within bounds [0, trackCount).
1427
- *
1428
- * @param index The index to validate.
1429
- * @throws IllegalArgumentException if index is out of bounds.
1430
- */
1431
1505
  private fun validateIndex(index: Int) {
1432
- if (index < 0 || index >= exoPlayer.mediaItemCount) {
1506
+ if (index < 0 || index >= sessionPlayer.mediaItemCount) {
1433
1507
  throw IllegalArgumentException(
1434
- "Track index $index is out of bounds (size: ${exoPlayer.mediaItemCount})"
1508
+ "Track index $index is out of bounds (size: ${sessionPlayer.mediaItemCount})"
1435
1509
  )
1436
1510
  }
1437
1511
  }
1438
1512
 
1439
- /**
1440
- * Validates that an insertion index is within bounds [0, trackCount] or -1 (append).
1441
- *
1442
- * @param index The index to validate.
1443
- * @throws IllegalArgumentException if index is out of bounds.
1444
- */
1445
1513
  private fun validateInsertIndex(index: Int) {
1446
- if (index < -1 || index > exoPlayer.mediaItemCount) {
1514
+ if (index < -1 || index > sessionPlayer.mediaItemCount) {
1447
1515
  throw IllegalArgumentException(
1448
- "Insert index $index is out of bounds (size: ${exoPlayer.mediaItemCount}, use -1 to append)"
1516
+ "Insert index $index is out of bounds (size: ${sessionPlayer.mediaItemCount}, use -1 to append)"
1449
1517
  )
1450
1518
  }
1451
1519
  }
1452
1520
 
1453
- /**
1454
- * Gets the MediaSessionCallback for this AudioBrowser.
1455
- *
1456
- * @return MediaLibrarySession.Callback instance
1457
- */
1458
1521
  fun getMediaSessionCallback(): MediaLibraryService.MediaLibrarySession.Callback {
1459
1522
  return mediaSessionCallback
1460
1523
  }
1461
1524
 
1462
- /**
1463
- * Notifies external controllers (Android Auto, etc.) that content at the given path has changed.
1464
- * Controllers subscribed to this path will refresh their UI.
1465
- *
1466
- * @param path The path where content has changed
1467
- */
1468
1525
  fun notifyContentChanged(path: String) {
1469
1526
  mediaSessionCallback.notifyContentChanged(path)
1470
1527
  }
1471
1528
 
1472
- /**
1473
- * Returns the recommended artwork size in pixels from the connected media browser (e.g., Android
1474
- * Auto), or null if not provided.
1475
- */
1529
+ fun invalidateAllContent() {
1530
+ mediaSessionCallback.invalidateAllContent()
1531
+ }
1532
+
1533
+ /** From the connected media browser (e.g. Android Auto), when it gives one. */
1476
1534
  val artworkSizeHintPixels: Int?
1477
1535
  get() = mediaSessionCallback.artworkSizeHintPixels
1478
1536
 
1479
- /** Returns true if the current media item is a live stream. */
1480
1537
  val isCurrentItemLive: Boolean
1481
- get() = exoPlayer.isCurrentMediaItemLive
1482
-
1483
- // MARK: - Buffer Configuration
1538
+ get() = sessionPlayer.isCurrentMediaItemLive
1484
1539
 
1485
1540
  /**
1486
- * Updates the buffer configuration at runtime.
1487
- *
1488
- * The new configuration takes effect immediately for future buffering decisions. Already-buffered
1489
- * data is not affected.
1490
- *
1491
- * @param config The new buffer configuration to apply.
1541
+ * [position] to set the queue at again, or [C.TIME_UNSET], where Media3 starts at the default
1542
+ * position: for a live item, for 0, which a live item also reports before it has loaded, and
1543
+ * after the end, so the track plays again.
1492
1544
  */
1545
+ internal val restorablePositionMs: Long
1546
+ get() =
1547
+ position.takeUnless {
1548
+ isCurrentItemLive || it == 0L || sessionPlayer.playbackState == MediaPlayer.STATE_ENDED
1549
+ } ?: C.TIME_UNSET
1550
+
1551
+ // MARK: - Buffer Configuration
1552
+
1553
+ /** Takes effect for future buffering; what is buffered stays. */
1493
1554
  fun updateBufferConfig(config: BufferConfig) {
1494
1555
  loadControl.updateBufferConfig(config)
1495
1556
  }
1496
1557
 
1497
- /**
1498
- * Gets the current buffer configuration.
1499
- *
1500
- * @return The current buffer configuration.
1501
- */
1502
1558
  fun getBufferConfig(): BufferConfig {
1503
1559
  return loadControl.getBufferConfig()
1504
1560
  }
1505
1561
 
1506
- /** Resets the buffer configuration to defaults. */
1507
1562
  fun resetBufferConfig() {
1508
1563
  loadControl.resetToDefaults()
1509
1564
  }
1565
+
1566
+ private companion object {
1567
+ var lastQueueVersion = 0
1568
+ }
1510
1569
  }