Run MediaSessionStub commands in order

Some commands are run asynchronously and subsequent commands need
to wait until the previous one finished. This can be supported
by returning a Future for each command and using the existing
command execution logic to wait for each Future to complete.

As some MediaSessionStub code is now executed delayed to when it
was originally created, we also need to check if the session is
not released before triggering any actions or sending result codes.

Issue: #85
PiperOrigin-RevId: 462101136
(cherry picked from commit 7cb7636)

RELEASENOTES.md

@@ -2,34 +2,48 @@
 
 ### Unreleased changes
 
+*   Core library:
+    *   Add `ExoPlayer.isTunnelingEnabled` to check if tunneling is enabled for
+        the currently selected tracks
+        ([#2518](https://github.com/google/ExoPlayer/issues/2518)).
+    *   Use `SingleThreadExecutor` for releasing `AudioTrack` instances to avoid
+        OutOfMemory errors when releasing multiple players at the same time
+        ([#10057](https://github.com/google/ExoPlayer/issues/10057)).
+*   Metadata:
+    *   `MetadataRenderer` can now be configured to render metadata as soon as
+        they are available. Create an instance with
+        `MetadataRenderer(MetadataOutput, Looper, MetadataDecoderFactory,
+        boolean)` to specify whether the renderer will output metadata early or
+        in sync with the player position.
+*   Session:
+    *   Ensure commands are always executed in the correct order even if some
+        require asynchronous resolution
+        ([#85](https://github.com/androidx/media/issues/85)).
+
+### 1.0.0-beta02 (2022-07-15)
+
+This release corresponds to the
+[ExoPlayer 2.18.1 release](https://github.com/google/ExoPlayer/releases/tag/r2.18.1).
+
 *   Core library:
     *   Ensure that changing the `ShuffleOrder` with `ExoPlayer.setShuffleOrder`
         results in a call to `Player.Listener#onTimelineChanged` with
         `reason=Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED`
         ([#9889](https://github.com/google/ExoPlayer/issues/9889)).
     *   For progressive media, only include selected tracks in buffered position
         ([#10361](https://github.com/google/ExoPlayer/issues/10361)).
-    *   Add `ExoPlayer.isTunnelingEnabled` to check if tunneling is enabled for
-        the currently selected tracks
-        ([#2518](https://github.com/google/ExoPlayer/issues/2518)).
     *   Allow custom logger for all ExoPlayer log output
         ([#9752](https://github.com/google/ExoPlayer/issues/9752)).
-    *   Use `SingleThreadExecutor` for releasing `AudioTrack` instances to avoid
-        OutOfMemory errors when releasing multiple players at the same time
-        ([#10057](https://github.com/google/ExoPlayer/issues/10057)).
+    *   Fix implementation of `setDataSourceFactory` in
+        `DefaultMediaSourceFactory`, which was non-functional in some cases
+        ([#116](https://github.com/androidx/media/issues/116)).
 *   Extractors:
     *   Add support for AVI
         ([#2092](https://github.com/google/ExoPlayer/issues/2092)).
     *   Fix parsing of H265 short term reference picture sets
         ([#10316](https://github.com/google/ExoPlayer/issues/10316)).
     *   Fix parsing of bitrates from `esds` boxes
         ([#10381](https://github.com/google/ExoPlayer/issues/10381)).
-*   Metadata:
-    *   `MetadataRenderer` can now be configured to render metadata as soon as
-        they are available. Create an instance with
-        `MetadataRenderer(MetadataOutput, Looper, MetadataDecoderFactory,
-        boolean)` to specify whether the renderer will output metadata early or
-        in sync with the player position.
 *   DASH:
     *   Parse ClearKey license URL from manifests
         ([#10246](https://github.com/google/ExoPlayer/issues/10246)).

libraries/session/src/main/java/androidx/media3/session/ConnectedControllersManager.java

@@ -24,7 +24,6 @@
 import androidx.media3.common.Player;
 import androidx.media3.session.MediaSession.ControllerInfo;
 import com.google.common.collect.ImmutableList;
-import com.google.common.util.concurrent.Futures;
 import com.google.common.util.concurrent.ListenableFuture;
 import com.google.common.util.concurrent.MoreExecutors;
 import java.util.ArrayDeque;
@@ -227,15 +226,11 @@ public ControllerInfo getController(T controllerKey) {
     }
   }
 
-  public void addToCommandQueue(ControllerInfo controllerInfo, Runnable commandRunnable) {
+  public void addToCommandQueue(ControllerInfo controllerInfo, AsyncCommand asyncCommand) {
     synchronized (lock) {
       @Nullable ConnectedControllerRecord<T> info = controllerRecords.get(controllerInfo);
       if (info != null) {
-        info.commandQueue.add(
-            () -> {
-              commandRunnable.run();
-              return Futures.immediateVoidFuture();
-            });
+        info.commandQueue.add(asyncCommand);
       }
     }
   }