Document execution of unavailable command

PiperOrigin-RevId: 365044658

RELEASENOTES.md

@@ -13,6 +13,8 @@
         `onPositionDiscontinuity(int)` callback
         `onPositionDiscontinuity(int)` callback
         ([#6163](https://github.com/google/ExoPlayer/issues/6163),
         ([#6163](https://github.com/google/ExoPlayer/issues/6163),
         [#4768](https://github.com/google/ExoPlayer/issues/4768)).
         [#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.
 *   UI:
 *   UI:
     *   Add builder for `PlayerNotificationManager`.
     *   Add builder for `PlayerNotificationManager`.
     *   Add group setting to `PlayerNotificationManager`.
     *   Add group setting to `PlayerNotificationManager`.

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

@@ -1447,7 +1447,8 @@ public interface Player {
    * <p>This method does not execute the command.
    * <p>This method does not execute the command.
    *
    *
    * <p>Executing a command that is not available (for example, calling {@link #next()} if {@link
    * <p>Executing a command that is not available (for example, calling {@link #next()} if {@link
-   * #COMMAND_SEEK_TO_NEXT_MEDIA_ITEM} is unavailable) is a no-op.
+   * #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}
    * <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}.
    * are unavailable if there is no such {@link MediaItem}.