Add Player.getAvailableCommands()

Add method getAvailableCommands() in Player interface to return
the available commands. Method isCommandAvailable() moved to
BasePlayer since it can be implelented by calling
getAvailableCommands().

PiperOrigin-RevId: 370059328

RELEASENOTES.md

@@ -18,8 +18,9 @@
         `onPositionDiscontinuity(int)` callback
         ([#6163](https://github.com/google/ExoPlayer/issues/6163),
         [#4768](https://github.com/google/ExoPlayer/issues/4768)).
-    *   Add `isCommandAvailable` method and `onAvailableCommandsChanged`
-        listener to query the commands that can be executed on the player.
+    *   Add methods `Player.getAvailableCommands`, `PLayer.isCommandAvailable`
+        and `EventListener.onAvailableCommandsChanged` to query the commands
+        that can be executed on the player.
     *   `AdsLoader.AdViewProvider` and `AdsLoader.OverlayInfo` have been renamed
         `com.google.android.exoplayer2.ui.AdViewProvider` and
         `com.google.android.exoplayer2.ui.AdOverlayInfo` respectively.

extensions/cast/src/main/java/com/google/android/exoplayer2/ext/cast/CastPlayer.java

@@ -367,8 +367,8 @@ public final class CastPlayer extends BasePlayer {
   }
 
   @Override
-  public boolean isCommandAvailable(@Command int command) {
-    return availableCommands.contains(command);
+  public Commands getAvailableCommands() {
+    return availableCommands;
   }
 
   @Override

extensions/ima/src/test/java/com/google/android/exoplayer2/ext/ima/FakePlayer.java

@@ -195,14 +195,8 @@ import com.google.android.exoplayer2.util.ListenerSet;
   }
 
   @Override
-  public boolean isCommandAvailable(@Command int command) {
-    // Only support querrying the minimal set of command for testing.
-    switch (command) {
-      case COMMAND_GET_VOLUME:
-        return false;
-      default:
-        throw new UnsupportedOperationException();
-    }
+  public Commands getAvailableCommands() {
+    return Commands.EMPTY;
   }
 
   @Override

library/common/src/main/java/com/google/android/exoplayer2/BasePlayer.java

@@ -81,6 +81,11 @@ public abstract class BasePlayer implements Player {
     removeMediaItems(/* fromIndex= */ 0, /* toIndex= */ Integer.MAX_VALUE);
   }
 
+  @Override
+  public final boolean isCommandAvailable(@Command int command) {
+    return getAvailableCommands().contains(command);
+  }
+
   /** @deprecated Use {@link #getPlayerError()} instead. */
   @Deprecated
   @Override

library/common/src/main/java/com/google/android/exoplayer2/Player.java

@@ -1207,6 +1207,25 @@ public interface Player {
    */
   boolean isCommandAvailable(@Command int command);
 
+  /**
+   * Returns the player's currently available {@link Commands}.
+   *
+   * <p>The returned {@link Commands} are not updated when available commands change. Use {@link
+   * EventListener#onAvailableCommandsChanged(Commands)} to get an update when the available
+   * commands change.
+   *
+   * <p>Executing a command that is not available (for example, calling {@link #next()} if {@link
+   * #COMMAND_SEEK_TO_NEXT_MEDIA_ITEM} is unavailable) will neither throw an exception nor generate
+   * a {@link #getPlayerError()} player error}.
+   *
+   * <p>{@link #COMMAND_SEEK_TO_NEXT_MEDIA_ITEM} and {@link #COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM}
+   * are unavailable if there is no such {@link MediaItem}.
+   *
+   * @return The currently available {@link Commands}.
+   * @see EventListener#onAvailableCommandsChanged
+   */
+  Commands getAvailableCommands();
+
   /** Prepares the player. */
   void prepare();
 

library/core/src/main/java/com/google/android/exoplayer2/ExoPlayerImpl.java

@@ -340,8 +340,8 @@ import java.util.concurrent.CopyOnWriteArraySet;
   }
 
   @Override
-  public boolean isCommandAvailable(@Command int command) {
-    return availableCommands.contains(command);
+  public Commands getAvailableCommands() {
+    return availableCommands;
   }
 
   @Override

library/core/src/main/java/com/google/android/exoplayer2/SimpleExoPlayer.java

@@ -1349,9 +1349,9 @@ public class SimpleExoPlayer extends BasePlayer
   }
 
   @Override
-  public boolean isCommandAvailable(@Command int command) {
+  public Commands getAvailableCommands() {
     verifyApplicationThread();
-    return player.isCommandAvailable(command);
+    return player.getAvailableCommands();
   }
 
   @Override

testutils/src/main/java/com/google/android/exoplayer2/testutil/StubExoPlayer.java

@@ -249,7 +249,7 @@ public class StubExoPlayer extends BasePlayer implements ExoPlayer {
   }
 
   @Override
-  public boolean isCommandAvailable(int command) {
+  public Commands getAvailableCommands() {
     throw new UnsupportedOperationException();
   }