react-native-audio-browser 0.2.0-next.50 → 0.2.0-next.52

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 (91) hide show
  1. package/android/build.gradle +15 -0
  2. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +215 -0
  3. package/android/src/main/AndroidManifest.xml +11 -0
  4. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +0 -4
  5. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +47 -10
  6. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +12 -3
  7. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +4 -1
  8. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  9. package/android/src/main/java/com/audiobrowser/player/Player.kt +170 -119
  10. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +18 -13
  11. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +10 -13
  12. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +64 -0
  13. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +98 -0
  14. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  15. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +110 -0
  16. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +696 -0
  17. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +113 -0
  18. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  19. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  20. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +92 -0
  21. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +105 -0
  22. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  23. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  24. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +550 -0
  25. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +99 -0
  26. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +201 -0
  27. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  28. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +66 -0
  29. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  30. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +63 -0
  31. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +63 -0
  32. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +68 -0
  33. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +2 -1
  34. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +1 -1
  35. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +18 -0
  36. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +20 -3
  37. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  38. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -0
  39. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +136 -0
  40. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +213 -0
  41. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +275 -0
  42. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  43. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  44. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  45. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +815 -0
  46. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +203 -0
  47. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +90 -0
  48. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +73 -0
  49. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +135 -0
  50. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +170 -0
  51. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +174 -0
  52. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +691 -0
  53. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  54. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +165 -0
  55. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  56. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +204 -0
  57. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +99 -0
  58. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  59. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +12 -10
  60. package/android/src/test/resources/sonos/device_description.xml +78 -0
  61. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  62. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +79 -0
  63. package/lib/commonjs/features/player/setup.js +2 -0
  64. package/lib/commonjs/features/player/setup.js.map +1 -1
  65. package/lib/module/features/player/setup.js +2 -0
  66. package/lib/module/features/player/setup.js.map +1 -1
  67. package/lib/typescript/src/features/player/setup.d.ts +37 -7
  68. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  69. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -3
  70. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  71. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +4 -0
  72. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +7 -5
  73. package/nitrogen/generated/android/c++/JOutputType.hpp +3 -0
  74. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  75. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +3 -3
  76. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -2
  77. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  78. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +18 -0
  79. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +3 -0
  80. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +3 -0
  81. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +5 -12
  82. package/nitrogen/generated/ios/swift/OutputType.swift +4 -0
  83. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  84. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +8 -5
  85. package/nitrogen/generated/shared/c++/OutputType.hpp +6 -2
  86. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  87. package/package.json +3 -2
  88. package/src/features/player/setup.ts +38 -7
  89. package/src/specs/audio-browser.nitro.ts +4 -3
  90. package/website/guide/audio-output.md +185 -4
  91. package/website/guide/configuration.md +6 -0
@@ -0,0 +1,136 @@
1
+ package com.audiobrowser.player
2
+
3
+ import android.os.Looper
4
+ import androidx.media3.common.PlaybackException
5
+ import androidx.media3.common.Player as MediaPlayer
6
+ import com.audiobrowser.Callbacks
7
+ import com.audiobrowser.TestFixtures
8
+ import com.audiobrowser.model.PlayerSetupOptions
9
+ import com.audiobrowser.remote.FakeReceiver
10
+ import com.audiobrowser.remote.FakeRemote
11
+ import com.audiobrowser.util.TrackFactory
12
+ import com.margelo.nitro.audiobrowser.PlaybackState
13
+ import com.margelo.nitro.audiobrowser.RemoteOutputsOptions
14
+ import java.time.Duration
15
+ import org.junit.After
16
+ import org.junit.Assert.assertEquals
17
+ import org.junit.Assert.assertFalse
18
+ import org.junit.Assert.assertTrue
19
+ import org.junit.Assert.fail
20
+ import org.junit.Before
21
+ import org.junit.Test
22
+ import org.junit.runner.RunWith
23
+ import org.mockito.Mockito.mock
24
+ import org.mockito.Mockito.mockingDetails
25
+ import org.robolectric.RobolectricTestRunner
26
+ import org.robolectric.RuntimeEnvironment
27
+ import org.robolectric.Shadows.shadowOf
28
+ import org.robolectric.annotation.Config
29
+
30
+ /** What the player leaves to a remote receiver while one plays: the local-only work steps aside. */
31
+ @RunWith(RobolectricTestRunner::class)
32
+ @Config(sdk = [28])
33
+ class PlayerCastTest {
34
+ private val looper = Looper.getMainLooper()
35
+ private val remote = FakeRemote(looper)
36
+ private val player =
37
+ Player(
38
+ RuntimeEnvironment.getApplication(),
39
+ castRemote = { _, _ -> remote },
40
+ sonosRemote = { _, _ -> FakeRemote(looper) },
41
+ )
42
+ private val receiver: FakeReceiver
43
+ get() = remote.player
44
+
45
+ private val callbacks = mock(Callbacks::class.java)
46
+
47
+ @Before
48
+ fun cast() {
49
+ player.setup(
50
+ PlayerSetupOptions(
51
+ remoteOutputs =
52
+ RemoteOutputsOptions(cast = true, castReceiverApplicationId = null, sonos = null)
53
+ )
54
+ )
55
+ player.setCallbacks(callbacks)
56
+ player.sessionPlayer.setMediaItems(
57
+ listOf(TrackFactory.toMedia3(TestFixtures.track(title = "a", src = "https://s/a.mp3")))
58
+ )
59
+ player.playWhenReady = true
60
+ remote.startSession()
61
+ idleUntil("remote") { !player.localEngine.isActive }
62
+ player.sessionPlayer.prepare()
63
+ idleUntil("the item on the receiver") { receiver.loads.isNotEmpty() }
64
+ }
65
+
66
+ @After fun release() = player.destroy()
67
+
68
+ @Test
69
+ fun `a receiver falling behind the live window is a remote error, not a local restart`() {
70
+ remote.fail(PlaybackException.ERROR_CODE_BEHIND_LIVE_WINDOW)
71
+ idle()
72
+
73
+ assertEquals(PlaybackState.ERROR, player.playbackState)
74
+ assertTrue(calls("onPlaybackError").isNotEmpty())
75
+ assertEquals(MediaPlayer.STATE_IDLE, player.exoPlayer.playbackState)
76
+ }
77
+
78
+ @Test
79
+ fun `a receiver failing to play is an error, not a local restart`() {
80
+ remote.fail()
81
+ idle()
82
+
83
+ assertEquals(PlaybackState.ERROR, player.playbackState)
84
+ assertTrue(calls("onPlaybackError").isNotEmpty())
85
+ assertEquals(MediaPlayer.STATE_IDLE, player.exoPlayer.playbackState)
86
+ }
87
+
88
+ @Test
89
+ fun `a new queue while remote plays its start item on the receiver`() {
90
+ player.setQueue(
91
+ arrayOf(
92
+ TestFixtures.track(title = "b", src = "https://s/b.mp3"),
93
+ TestFixtures.track(title = "c", src = "https://s/c.mp3"),
94
+ ),
95
+ startIndex = 1,
96
+ )
97
+ idleUntil("the start item on the receiver") { receiver.loads.size == 2 }
98
+
99
+ assertEquals("https://s/c.mp3", receiver.loads.last().item.localConfiguration?.uri.toString())
100
+ assertEquals(1, player.currentIndex)
101
+ }
102
+
103
+ @Test
104
+ fun `the volume moves the receiver's volume, not the local one`() {
105
+ player.volume = 0.5f
106
+ idle()
107
+
108
+ assertEquals(FakeReceiver.MAX_VOLUME / 2, receiver.volume)
109
+ assertEquals(1f, player.exoPlayer.volume)
110
+ assertEquals(0.5f, player.volume)
111
+ }
112
+
113
+ @Test
114
+ fun `the sleep timer pauses the receiver without fading its volume`() {
115
+ player.sleepTimer.setAfter(seconds = 2.0, fadeDuration = 2.0)
116
+ shadowOf(looper).idleFor(Duration.ofSeconds(3))
117
+
118
+ assertFalse(receiver.playWhenReady)
119
+ assertEquals(10, receiver.volume)
120
+ }
121
+
122
+ private fun calls(name: String) =
123
+ mockingDetails(callbacks).invocations.filter { it.method.name == name }
124
+
125
+ private fun idle() = shadowOf(looper).idle()
126
+
127
+ /** Casting starts after a resolution on a background thread. */
128
+ private fun idleUntil(what: String, condition: () -> Boolean) {
129
+ repeat(200) {
130
+ idle()
131
+ if (condition()) return
132
+ Thread.sleep(10)
133
+ }
134
+ fail("never $what")
135
+ }
136
+ }
@@ -0,0 +1,213 @@
1
+ package com.audiobrowser.player
2
+
3
+ import android.os.Looper
4
+ import androidx.media3.common.Player as MediaPlayer
5
+ import com.audiobrowser.Callbacks
6
+ import com.audiobrowser.TestFixtures
7
+ import com.audiobrowser.model.PlayerSetupOptions
8
+ import com.audiobrowser.sonos.SonosControl
9
+ import com.audiobrowser.sonos.SonosDevice
10
+ import com.audiobrowser.sonos.SonosOutputs
11
+ import com.audiobrowser.sonos.SonosPosition
12
+ import com.audiobrowser.sonos.SonosRemote
13
+ import com.audiobrowser.sonos.SonosRoom
14
+ import com.audiobrowser.util.TrackFactory
15
+ import com.margelo.nitro.audiobrowser.RemoteOutputsOptions
16
+ import com.margelo.nitro.audiobrowser.TimedMetadata
17
+ import java.time.Duration
18
+ import java.util.concurrent.CopyOnWriteArrayList
19
+ import org.junit.After
20
+ import org.junit.Assert.assertEquals
21
+ import org.junit.Assert.fail
22
+ import org.junit.Before
23
+ import org.junit.Test
24
+ import org.junit.runner.RunWith
25
+ import org.mockito.Mockito.mock
26
+ import org.mockito.Mockito.mockingDetails
27
+ import org.robolectric.RobolectricTestRunner
28
+ import org.robolectric.RuntimeEnvironment
29
+ import org.robolectric.Shadows.shadowOf
30
+ import org.robolectric.annotation.Config
31
+
32
+ /** A Sonos room selected in the Output Switcher, played through the player's remote switch. */
33
+ @RunWith(RobolectricTestRunner::class)
34
+ @Config(sdk = [28])
35
+ class PlayerSonosTest {
36
+ private class FakeRoom : SonosControl {
37
+ val calls = CopyOnWriteArrayList<String>()
38
+ @Volatile var title: String? = null
39
+
40
+ override fun setUri(
41
+ streamUrl: String,
42
+ title: String,
43
+ artist: String?,
44
+ album: String?,
45
+ artworkUri: String?,
46
+ live: Boolean,
47
+ ) {
48
+ calls += "setUri $streamUrl"
49
+ }
50
+
51
+ override fun play() {
52
+ calls += "play"
53
+ }
54
+
55
+ override fun pause() {
56
+ calls += "pause"
57
+ }
58
+
59
+ override fun stop() {
60
+ calls += "stop"
61
+ }
62
+
63
+ override fun seek(positionMs: Long) {
64
+ calls += "seek $positionMs"
65
+ }
66
+
67
+ @Volatile var state = "PLAYING"
68
+
69
+ override fun getTransportState() = state
70
+
71
+ override fun getPosition() = SonosPosition(title, null, null)
72
+
73
+ override fun getMediaUri() = null
74
+
75
+ override fun getVolume() = 0
76
+
77
+ override fun setVolume(volume: Int) {
78
+ calls += "setVolume $volume"
79
+ }
80
+ }
81
+
82
+ private val looper = Looper.getMainLooper()
83
+ private val room = FakeRoom()
84
+ private val player =
85
+ Player(
86
+ RuntimeEnvironment.getApplication(),
87
+ castRemote = { _, _ -> null },
88
+ sonosRemote = { context, scope -> SonosRemote(context, scope, controlOf = { room }) },
89
+ )
90
+ private val callbacks = mock(Callbacks::class.java)
91
+
92
+ @Before
93
+ fun selectRoom() {
94
+ player.setup(
95
+ PlayerSetupOptions(
96
+ remoteOutputs =
97
+ RemoteOutputsOptions(cast = null, castReceiverApplicationId = null, sonos = true)
98
+ )
99
+ )
100
+ player.setCallbacks(callbacks)
101
+ player.sessionPlayer.setMediaItems(
102
+ listOf(TrackFactory.toMedia3(TestFixtures.track(title = "a", src = "https://s/a.mp3")))
103
+ )
104
+ player.playWhenReady = true
105
+ SonosOutputs.select(ROOM)
106
+ idleUntil("the handover") { !player.localEngine.isActive }
107
+ player.sessionPlayer.prepare()
108
+ idleUntil("playing on the speaker") { "play" in room.calls }
109
+ }
110
+
111
+ private var destroyed = false
112
+
113
+ @After
114
+ fun release() {
115
+ SonosOutputs.selected?.let(SonosOutputs::unselect)
116
+ if (!destroyed) player.destroy()
117
+ }
118
+
119
+ @Test
120
+ fun `a play the speaker accepts but never starts is a playback error`() {
121
+ player.playWhenReady = false
122
+ room.state = "PAUSED_PLAYBACK"
123
+ idleUntil("paused on the speaker") { "pause" in room.calls }
124
+ room.state = "TRANSITIONING"
125
+
126
+ player.playWhenReady = true
127
+
128
+ idleUntil("the start timed out", steps = 500) {
129
+ player.playbackState == com.margelo.nitro.audiobrowser.PlaybackState.ERROR
130
+ }
131
+ }
132
+
133
+ @Test
134
+ fun `destroying the player stops the speaker`() {
135
+ player.destroy()
136
+ destroyed = true
137
+
138
+ idleUntil("the speaker stopped") { "stop" in room.calls }
139
+ }
140
+
141
+ @Test
142
+ fun `the selected room plays the queue, and the phone stops`() {
143
+ assertEquals(listOf("setUri https://s/a.mp3", "play"), room.calls)
144
+ assertEquals(false, player.localEngine.isActive)
145
+ assertEquals(MediaPlayer.STATE_IDLE, player.exoPlayer.playbackState)
146
+ }
147
+
148
+ @Test
149
+ fun `a new item plays on the speaker from the position it is set at`() {
150
+ room.calls.clear()
151
+
152
+ player.sessionPlayer.setMediaItem(
153
+ TrackFactory.toMedia3(TestFixtures.track(title = "b", src = "https://s/b.mp3")),
154
+ 60_000,
155
+ )
156
+
157
+ idleUntil("playing on the speaker") { "play" in room.calls }
158
+ assertEquals(listOf("setUri https://s/b.mp3", "seek 60000", "play"), room.calls)
159
+ }
160
+
161
+ @Test
162
+ fun `the speaker's stream title reaches the app as timed metadata`() {
163
+ room.title = "Santana - Smooth"
164
+
165
+ idleUntil("the title") { timedMetadata().isNotEmpty() }
166
+
167
+ assertEquals("Santana - Smooth", timedMetadata().last().title)
168
+ }
169
+
170
+ @Test
171
+ fun `unselecting the room stops the speaker and brings playback back to the phone`() {
172
+ SonosOutputs.unselect(ROOM)
173
+
174
+ idleUntil("the speaker stopped") { "stop" in room.calls }
175
+ assertEquals(true, player.localEngine.isActive)
176
+ assertEquals(true, player.exoPlayer.playWhenReady)
177
+ assertEquals(1, player.exoPlayer.mediaItemCount)
178
+ }
179
+
180
+ private fun timedMetadata() =
181
+ mockingDetails(callbacks)
182
+ .invocations
183
+ .filter { it.method.name == "onTimedMetadata" }
184
+ .map { it.arguments[0] as TimedMetadata }
185
+
186
+ /** Commands run on a background thread, and the speaker is polled every two seconds. */
187
+ private fun idleUntil(what: String, steps: Int = 300, condition: () -> Boolean) {
188
+ repeat(steps) {
189
+ shadowOf(looper).idleFor(Duration.ofMillis(100))
190
+ if (condition()) return
191
+ Thread.sleep(10)
192
+ }
193
+ fail("never $what")
194
+ }
195
+
196
+ private companion object {
197
+ val ROOM =
198
+ SonosRoom(
199
+ id = "RINCON_TEST",
200
+ name = "Test Room",
201
+ device =
202
+ SonosDevice(
203
+ udn = "uuid:RINCON_TEST",
204
+ name = "Test Room",
205
+ baseUrl = "http://192.0.2.1:1400",
206
+ avTransportControlUrl = "http://192.0.2.1:1400/MediaRenderer/AVTransport/Control",
207
+ groupRenderingControlUrl =
208
+ "http://192.0.2.1:1400/MediaRenderer/GroupRenderingControl/Control",
209
+ zoneGroupTopologyControlUrl = null,
210
+ ),
211
+ )
212
+ }
213
+ }
@@ -0,0 +1,275 @@
1
+ package com.audiobrowser.remote
2
+
3
+ import android.os.Looper
4
+ import androidx.media3.common.C
5
+ import androidx.media3.common.DeviceInfo
6
+ import androidx.media3.common.MediaItem
7
+ import androidx.media3.common.PlaybackException
8
+ import androidx.media3.common.PlaybackParameters
9
+ import androidx.media3.common.Player as MediaPlayer
10
+ import androidx.media3.common.SimpleBasePlayer
11
+ import androidx.media3.common.TrackSelectionParameters
12
+ import com.google.common.util.concurrent.Futures
13
+ import com.google.common.util.concurrent.ListenableFuture
14
+
15
+ /** A local player that keeps the queue it is told. */
16
+ internal class FakeLocalPlayer(looper: Looper) : SimpleBasePlayer(looper) {
17
+ val items = mutableListOf<MediaItem>()
18
+ var index = C.INDEX_UNSET
19
+ var positionMs = 0L
20
+ var stops = 0
21
+ var prepares = 0
22
+ private var intent = false
23
+ private var readiness = STATE_IDLE
24
+ private var repeat = REPEAT_MODE_OFF
25
+ private var shuffle = false
26
+ private val uids = mutableListOf<Any>()
27
+
28
+ override fun getState(): State =
29
+ State.Builder()
30
+ .setAvailableCommands(MediaPlayer.Commands.Builder().addAllCommands().build())
31
+ .setPlaylist(
32
+ items.mapIndexed { i, item -> MediaItemData.Builder(uids[i]).setMediaItem(item).build() }
33
+ )
34
+ .setCurrentMediaItemIndex(if (items.isEmpty()) C.INDEX_UNSET else index)
35
+ .setContentPositionMs(positionMs)
36
+ .setPlayWhenReady(intent, PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST)
37
+ .setPlaybackState(if (items.isEmpty()) STATE_IDLE else readiness)
38
+ .setRepeatMode(repeat)
39
+ .setShuffleModeEnabled(shuffle)
40
+ .build()
41
+
42
+ /** Moves to [index] as the phone does at an item's end. */
43
+ fun moveTo(index: Int) {
44
+ this.index = index
45
+ invalidateState()
46
+ }
47
+
48
+ override fun handleSetMediaItems(
49
+ mediaItems: List<MediaItem>,
50
+ startIndex: Int,
51
+ startPositionMs: Long,
52
+ ): ListenableFuture<*> {
53
+ items.clear()
54
+ uids.clear()
55
+ items.addAll(mediaItems)
56
+ uids.addAll(mediaItems.map { Any() })
57
+ index = if (startIndex == C.INDEX_UNSET) 0 else startIndex
58
+ positionMs = if (startPositionMs == C.TIME_UNSET) 0 else startPositionMs
59
+ return done()
60
+ }
61
+
62
+ override fun handleRemoveMediaItems(fromIndex: Int, toIndex: Int): ListenableFuture<*> {
63
+ items.subList(fromIndex, toIndex).clear()
64
+ uids.subList(fromIndex, toIndex).clear()
65
+ if (items.isEmpty()) index = C.INDEX_UNSET
66
+ return done()
67
+ }
68
+
69
+ override fun handleSetPlayWhenReady(playWhenReady: Boolean): ListenableFuture<*> {
70
+ intent = playWhenReady
71
+ return done()
72
+ }
73
+
74
+ override fun handlePrepare(): ListenableFuture<*> {
75
+ readiness = STATE_READY
76
+ prepares++
77
+ return done()
78
+ }
79
+
80
+ override fun handleStop(): ListenableFuture<*> {
81
+ readiness = STATE_IDLE
82
+ stops++
83
+ return done()
84
+ }
85
+
86
+ override fun handleSeek(
87
+ mediaItemIndex: Int,
88
+ positionMs: Long,
89
+ seekCommand: Int,
90
+ ): ListenableFuture<*> {
91
+ if (mediaItemIndex != C.INDEX_UNSET) index = mediaItemIndex
92
+ this.positionMs = if (positionMs == C.TIME_UNSET) 0 else positionMs
93
+ return done()
94
+ }
95
+
96
+ override fun handleSetRepeatMode(repeatMode: Int): ListenableFuture<*> {
97
+ repeat = repeatMode
98
+ return done()
99
+ }
100
+
101
+ override fun handleSetShuffleModeEnabled(shuffleModeEnabled: Boolean): ListenableFuture<*> {
102
+ shuffle = shuffleModeEnabled
103
+ return done()
104
+ }
105
+
106
+ override fun handleSetPlaybackParameters(
107
+ playbackParameters: PlaybackParameters
108
+ ): ListenableFuture<*> = done()
109
+
110
+ override fun handleSetTrackSelectionParameters(
111
+ trackSelectionParameters: TrackSelectionParameters
112
+ ): ListenableFuture<*> = done()
113
+
114
+ override fun handleRelease(): ListenableFuture<*> = done()
115
+ }
116
+
117
+ /** One load a receiver was sent: the item, where it starts, and whether it autoplays. */
118
+ internal data class SentLoad(val item: MediaItem, val positionMs: Long, val autoplay: Boolean)
119
+
120
+ /** A receiver that plays one item at a time, as [RemotePlayback.player] does. */
121
+ internal class FakeReceiver(looper: Looper) : SimpleBasePlayer(looper) {
122
+ var item: MediaItem? = null
123
+ var positionMs = 0L
124
+ var intent = false
125
+ var readiness = STATE_IDLE
126
+ var volume = 10
127
+ var stops = 0
128
+ var released = false
129
+ val loads = mutableListOf<SentLoad>()
130
+ val seeks = mutableListOf<Long>()
131
+ val intents = mutableListOf<Boolean>()
132
+
133
+ /** While set, a load is held back from the reported state until [catchUp], as a receiver lags. */
134
+ var lagging = false
135
+ private var held: MediaItem? = null
136
+ private var uid = Any()
137
+
138
+ fun catchUp() {
139
+ held?.let { item = it }
140
+ held = null
141
+ invalidateState()
142
+ }
143
+
144
+ /** The receiver is paused or played from elsewhere. */
145
+ fun setIntentFromElsewhere(playWhenReady: Boolean) {
146
+ intent = playWhenReady
147
+ invalidateState()
148
+ }
149
+
150
+ fun update() = invalidateState()
151
+
152
+ override fun getState(): State =
153
+ State.Builder()
154
+ .setAvailableCommands(MediaPlayer.Commands.Builder().addAllCommands().build())
155
+ .setPlaylist(listOfNotNull(item).map { MediaItemData.Builder(uid).setMediaItem(it).build() })
156
+ .setCurrentMediaItemIndex(if (item == null) C.INDEX_UNSET else 0)
157
+ .setContentPositionMs(positionMs)
158
+ .setPlayWhenReady(intent, PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST)
159
+ .setPlaybackState(if (item == null) STATE_IDLE else readiness)
160
+ .setDeviceInfo(DEVICE_INFO)
161
+ .setDeviceVolume(volume)
162
+ .build()
163
+
164
+ override fun handleSetMediaItems(
165
+ mediaItems: List<MediaItem>,
166
+ startIndex: Int,
167
+ startPositionMs: Long,
168
+ ): ListenableFuture<*> {
169
+ val loaded = mediaItems.single()
170
+ loads += SentLoad(loaded, startPositionMs, intent)
171
+ uid = Any()
172
+ positionMs = if (startPositionMs == C.TIME_UNSET) 0 else startPositionMs
173
+ readiness = STATE_READY
174
+ if (lagging) held = loaded else item = loaded
175
+ return done()
176
+ }
177
+
178
+ override fun handleSetPlayWhenReady(playWhenReady: Boolean): ListenableFuture<*> {
179
+ intent = playWhenReady
180
+ intents += playWhenReady
181
+ return done()
182
+ }
183
+
184
+ override fun handlePrepare(): ListenableFuture<*> = done()
185
+
186
+ override fun handleStop(): ListenableFuture<*> {
187
+ readiness = STATE_IDLE
188
+ stops++
189
+ return done()
190
+ }
191
+
192
+ override fun handleSeek(
193
+ mediaItemIndex: Int,
194
+ positionMs: Long,
195
+ seekCommand: Int,
196
+ ): ListenableFuture<*> {
197
+ seeks += positionMs
198
+ this.positionMs = positionMs
199
+ return done()
200
+ }
201
+
202
+ override fun handleSetDeviceVolume(deviceVolume: Int, flags: Int): ListenableFuture<*> {
203
+ volume = deviceVolume
204
+ return done()
205
+ }
206
+
207
+ override fun handleRelease(): ListenableFuture<*> {
208
+ released = true
209
+ return done()
210
+ }
211
+
212
+ companion object {
213
+ const val MAX_VOLUME = 20
214
+ val DEVICE_INFO: DeviceInfo =
215
+ DeviceInfo.Builder(DeviceInfo.PLAYBACK_TYPE_REMOTE).setMaxVolume(MAX_VOLUME).build()
216
+ }
217
+ }
218
+
219
+ /** A remote whose sessions the test starts and ends, each with a receiver of its own. */
220
+ internal class FakeRemote(private val looper: Looper) : RemotePlayback {
221
+ private var receiver: FakeReceiver? = null
222
+ private var listener: RemotePlayback.Listener? = null
223
+ var released = false
224
+
225
+ override val player: FakeReceiver
226
+ get() = checkNotNull(receiver) { "No session" }
227
+
228
+ override val isSessionAvailable: Boolean
229
+ get() = receiver != null
230
+
231
+ override fun setListener(listener: RemotePlayback.Listener?) {
232
+ this.listener = listener
233
+ }
234
+
235
+ /** A session already up, as one the Cast framework resumes, without telling the listener. */
236
+ fun sessionUp() {
237
+ receiver = FakeReceiver(looper)
238
+ }
239
+
240
+ /** Starts a session, or another in place of the one up, as selecting another room does. */
241
+ fun startSession() {
242
+ val ended = receiver
243
+ receiver = FakeReceiver(looper)
244
+ listener?.onSessionChanged()
245
+ ended?.release()
246
+ }
247
+
248
+ fun endSession() {
249
+ receiver = null
250
+ listener?.onSessionChanged()
251
+ }
252
+
253
+ /** The receiver reports its item playing. */
254
+ fun playing() {
255
+ listener?.onPlaying()
256
+ }
257
+
258
+ /** The receiver played its item to the end. */
259
+ fun end() {
260
+ player.readiness = MediaPlayer.STATE_ENDED
261
+ player.update()
262
+ listener?.onEnded()
263
+ }
264
+
265
+ /** The receiver failed to play its item. */
266
+ fun fail(code: Int = PlaybackException.ERROR_CODE_REMOTE_ERROR) {
267
+ listener?.onFailed(PlaybackException("receiver failed", null, code))
268
+ }
269
+
270
+ override fun release() {
271
+ released = true
272
+ }
273
+ }
274
+
275
+ private fun done(): ListenableFuture<*> = Futures.immediateVoidFuture()
@@ -0,0 +1,61 @@
1
+ package com.audiobrowser.remote
2
+
3
+ import androidx.media3.common.MediaItem
4
+ import androidx.media3.common.MediaMetadata
5
+ import androidx.media3.common.MimeTypes
6
+ import org.junit.Assert.assertEquals
7
+ import org.junit.Assert.assertFalse
8
+ import org.junit.Assert.assertNull
9
+ import org.junit.Assert.assertTrue
10
+ import org.junit.Test
11
+ import org.junit.runner.RunWith
12
+ import org.robolectric.RobolectricTestRunner
13
+
14
+ @RunWith(RobolectricTestRunner::class)
15
+ class RemoteItemTest {
16
+ private val item =
17
+ MediaItem.Builder()
18
+ .setMediaId("a")
19
+ .setUri("https://local/a")
20
+ .setMediaMetadata(
21
+ MediaMetadata.Builder()
22
+ .setTitle("A")
23
+ .setArtworkUri(android.net.Uri.parse("content://art/a"))
24
+ .build()
25
+ )
26
+ .build()
27
+
28
+ @Test
29
+ fun `a live item loads at its live edge as a radio station`() {
30
+ val remote = remoteItemOf(item, "https://cdn/a", null, live = true)
31
+
32
+ assertTrue(remote.isRemoteLive)
33
+ assertEquals(MediaMetadata.MEDIA_TYPE_RADIO_STATION, remote.mediaMetadata.mediaType)
34
+ assertEquals("https://cdn/a", remote.localConfiguration?.uri.toString())
35
+ assertEquals("a", remote.mediaId)
36
+ }
37
+
38
+ @Test
39
+ fun `a track is not live`() {
40
+ assertFalse(remoteItemOf(item, "https://cdn/a.mp3", null, live = false).isRemoteLive)
41
+ }
42
+
43
+ @Test
44
+ fun `artwork the receiver can't fetch is left out`() {
45
+ assertNull(remoteItemOf(item, "https://cdn/a", null, live = false).mediaMetadata.artworkUri)
46
+ assertEquals(
47
+ "https://img/a.jpg",
48
+ remoteItemOf(item, "https://cdn/a", "https://img/a.jpg", live = false)
49
+ .mediaMetadata
50
+ .artworkUri
51
+ .toString(),
52
+ )
53
+ }
54
+
55
+ @Test
56
+ fun `the MIME type is the declared one, else inferred, else MPEG audio`() {
57
+ assertEquals("audio/aac", remoteMimeType("https://cdn/a.mp3", "audio/aac"))
58
+ assertEquals(MimeTypes.APPLICATION_M3U8, remoteMimeType("https://cdn/a.m3u8", null))
59
+ assertEquals(MimeTypes.AUDIO_MPEG, remoteMimeType("https://cdn/stream", null))
60
+ }
61
+ }