setPlaybackParameters no longer accepts null for DEFAULT

Null was an alias for DEFAULT. Remove this for nullness
safety in the API.

The ExoPlayer implementation still checks for null and
replaces it by DEFAULT, so this is ABI compatible.

PiperOrigin-RevId: 364370017

RELEASENOTES.md

@@ -30,10 +30,12 @@
     *   Reset playback speed when live playback speed control becomes unused
     *   Reset playback speed when live playback speed control becomes unused
         ([#8664](https://github.com/google/ExoPlayer/issues/8664)).
         ([#8664](https://github.com/google/ExoPlayer/issues/8664)).
     *   Fix playback position issue when re-preparing playback after a
     *   Fix playback position issue when re-preparing playback after a
-        BehindLiveWindowException
+        `BehindLiveWindowException`
         ([#8675](https://github.com/google/ExoPlayer/issues/8675)).
         ([#8675](https://github.com/google/ExoPlayer/issues/8675)).
     *   Add a `Listener` interface to receive all player events in a single
     *   Add a `Listener` interface to receive all player events in a single
         object.
         object.
+    *   `Player.setPlaybackParameters` no longer accepts null, use
+        `PlaybackParameters.DEFAULT` instead.
 *   HLS:
 *   HLS:
     *   Fix issue that could cause playback to become stuck if corresponding
     *   Fix issue that could cause playback to become stuck if corresponding
         `EXT-X-DISCONTINUITY` tags in different media playlists occur at
         `EXT-X-DISCONTINUITY` tags in different media playlists occur at

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

@@ -469,7 +469,7 @@ public final class CastPlayer extends BasePlayer {
   }
   }
 
 
   @Override
   @Override
-  public void setPlaybackParameters(@Nullable PlaybackParameters playbackParameters) {
+  public void setPlaybackParameters(PlaybackParameters playbackParameters) {
     // Unsupported by the RemoteMediaClient API. Do nothing.
     // Unsupported by the RemoteMediaClient API. Do nothing.
   }
   }
 
 

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

@@ -1491,16 +1491,16 @@ public interface Player {
   void next();
   void next();
 
 
   /**
   /**
-   * Attempts to set the playback parameters. Passing {@code null} sets the parameters to the
-   * default, {@link PlaybackParameters#DEFAULT}, which means there is no speed or pitch adjustment.
+   * Attempts to set the playback parameters. Passing {@link PlaybackParameters#DEFAULT} resets the
+   * player to the default, which means there is no speed or pitch adjustment.
    *
    *
    * <p>Playback parameters changes may cause the player to buffer. {@link
    * <p>Playback parameters changes may cause the player to buffer. {@link
    * EventListener#onPlaybackParametersChanged(PlaybackParameters)} will be called whenever the
    * EventListener#onPlaybackParametersChanged(PlaybackParameters)} will be called whenever the
    * currently active playback parameters change.
    * currently active playback parameters change.
    *
    *
-   * @param playbackParameters The playback parameters, or {@code null} to use the defaults.
+   * @param playbackParameters The playback parameters.
    */
    */
-  void setPlaybackParameters(@Nullable PlaybackParameters playbackParameters);
+  void setPlaybackParameters(PlaybackParameters playbackParameters);
 
 
   /**
   /**
    * Changes the rate at which playback occurs. The pitch is not changed.
    * Changes the rate at which playback occurs. The pitch is not changed.

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

@@ -669,7 +669,7 @@ import java.util.concurrent.CopyOnWriteArraySet;
   }
   }
 
 
   @Override
   @Override
-  public void setPlaybackParameters(@Nullable PlaybackParameters playbackParameters) {
+  public void setPlaybackParameters(PlaybackParameters playbackParameters) {
     if (playbackParameters == null) {
     if (playbackParameters == null) {
       playbackParameters = PlaybackParameters.DEFAULT;
       playbackParameters = PlaybackParameters.DEFAULT;
     }
     }

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

@@ -1467,7 +1467,7 @@ public class SimpleExoPlayer extends BasePlayer
   }
   }
 
 
   @Override
   @Override
-  public void setPlaybackParameters(@Nullable PlaybackParameters playbackParameters) {
+  public void setPlaybackParameters(PlaybackParameters playbackParameters) {
     verifyApplicationThread();
     verifyApplicationThread();
     player.setPlaybackParameters(playbackParameters);
     player.setPlaybackParameters(playbackParameters);
   }
   }

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

@@ -281,7 +281,7 @@ public abstract class StubExoPlayer extends BasePlayer implements ExoPlayer {
   }
   }
 
 
   @Override
   @Override
-  public void setPlaybackParameters(@Nullable PlaybackParameters playbackParameters) {
+  public void setPlaybackParameters(PlaybackParameters playbackParameters) {
     throw new UnsupportedOperationException();
     throw new UnsupportedOperationException();
   }
   }