react-native-audio-browser 1.0.0-next.3 → 1.0.0-next.4

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 (50) hide show
  1. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +37 -14
  2. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +19 -8
  3. package/android/src/main/java/com/audiobrowser/Service.kt +6 -41
  4. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +12 -27
  5. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +6 -5
  6. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +12 -7
  7. package/android/src/main/java/com/audiobrowser/extension/QueueIndex.kt +19 -0
  8. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +2 -1
  9. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +24 -8
  10. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +5 -1
  11. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +28 -21
  12. package/android/src/main/java/com/audiobrowser/player/Player.kt +33 -27
  13. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +4 -0
  14. package/android/src/main/java/com/audiobrowser/player/ResolvingOnReloadSource.kt +38 -0
  15. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +34 -19
  16. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +10 -1
  17. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +48 -4
  18. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +32 -34
  19. package/android/src/main/java/com/audiobrowser/util/SearchParamsFactory.kt +64 -0
  20. package/android/src/test/java/com/audiobrowser/NavigateTrackTest.kt +116 -0
  21. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +41 -0
  22. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +21 -4
  23. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +49 -0
  24. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerPageShapeTest.kt +93 -0
  25. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +12 -0
  26. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +7 -1
  27. package/android/src/test/java/com/audiobrowser/browser/JsonFavoritedTest.kt +34 -0
  28. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +6 -6
  29. package/android/src/test/java/com/audiobrowser/extension/QueueIndexTest.kt +44 -0
  30. package/android/src/test/java/com/audiobrowser/http/HttpClientTest.kt +34 -0
  31. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +64 -7
  32. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +41 -0
  33. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +39 -0
  34. package/android/src/test/java/com/audiobrowser/player/MediaUrlReloadTest.kt +212 -0
  35. package/android/src/test/java/com/audiobrowser/player/PlayerSeekSnapshotTest.kt +45 -0
  36. package/android/src/test/java/com/audiobrowser/player/SessionVoiceSearchTest.kt +173 -0
  37. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +127 -1
  38. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +28 -0
  39. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +116 -0
  40. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +44 -0
  41. package/android/src/testCast/java/com/audiobrowser/cast/SdkCastRemoteTest.kt +188 -0
  42. package/lib/commonjs/features/playback/controls.js +1 -2
  43. package/lib/commonjs/features/playback/controls.js.map +1 -1
  44. package/lib/module/features/playback/controls.js +1 -2
  45. package/lib/module/features/playback/controls.js.map +1 -1
  46. package/lib/typescript/src/features/playback/controls.d.ts +1 -2
  47. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  48. package/package.json +1 -1
  49. package/src/features/playback/controls.ts +1 -2
  50. package/website/guide/live-streams.md +22 -20
@@ -92,23 +92,26 @@ neither ICY nor HLS ID3. Every web error is terminal.
92
92
 
93
93
  If your stream URLs are signed or short-lived, build them in
94
94
  [`media.resolve`](/guide/browser#media-and-artwork) — the per-track layer of
95
- the stream request. When a reconnect re-runs it depends on the platform:
96
-
97
- - **iOS** re-runs it on every reload: automatic retry, network restore,
98
- play-from-`'error'` and a live-edge reconnect. A URL that expired during
99
- the outage is re-signed instead of re-failing.
100
- - **Android** reuses the URL it resolved, and re-runs `media.resolve` only
101
- after an attempt to open that URL has failed. A URL that expired
102
- mid-stream therefore costs one failed attempt.
103
-
104
- With `retry` on, a status that retrying can't fix (a 401 or 403, say; see
105
- [which failures qualify](/guide/errors#automatic-retry)) puts playback in
106
- `'error'`, and the next [`retry()`](/guide/errors#manual-retry) or play
107
- command re-resolves. With `retry` off, ExoPlayer's own few retries cover any
108
- status, and the first of them re-resolves.
109
-
110
- - **Web** re-runs it on every reload: play-from-`'error'` or after a stop,
111
- `retry()` and a live-edge reconnect. Web has no automatic retry.
95
+ the stream request. Every reload of the track re-runs it, so a URL that
96
+ expired while the track was paused or during an outage is re-signed instead
97
+ of re-failing:
98
+
99
+ - a play after a stop, from `'error'`, or after a pause that closed a live
100
+ stream's connection (see [Pausing a live stream](#pausing-a-live-stream));
101
+ - a skip or a repeat that comes back to the track;
102
+ - [`retry()`](/guide/errors#manual-retry), and a
103
+ [live-edge reconnect](#the-live-edge);
104
+ - on iOS and Android, each reconnect of the
105
+ [automatic retry](/guide/errors#automatic-retry). Web has no automatic
106
+ retry.
107
+
108
+ A seek within the open stream doesn't re-run it. On Android, the automatic
109
+ retry of an HLS stream, and a skip or a repeat back to one, reload its
110
+ playlists and segments with the URL and headers already resolved; they re-run
111
+ `media.resolve` only when they request the stream's own URL again (a `src`
112
+ that is itself a media playlist, at its next refresh), or after such a request
113
+ fails. If your resolver calls your backend, each of these
114
+ reconnects waits on that call.
112
115
 
113
116
  ```ts
114
117
  import { configureBrowser } from 'react-native-audio-browser'
@@ -139,9 +142,8 @@ On a stream with a seekable live window (HLS with a sliding window) it seeks
139
142
  to the window's edge; on a non-seekable one (typical ICY radio) it
140
143
  reconnects instead — a fresh connection _is_ the live edge.
141
144
 
142
- On iOS and web the reconnect re-runs `media.resolve`. On Android it reuses the
143
- resolved URL, so an expired one re-resolves only after that first attempt
144
- fails (see [Fresh URLs on reconnect](#fresh-urls-on-reconnect)).
145
+ The reconnect re-runs `media.resolve` (see
146
+ [Fresh URLs on reconnect](#fresh-urls-on-reconnect)).
145
147
  General seeking is in [Playback](/guide/playback).
146
148
 
147
149
  ## Pausing a live stream