Deprecate ControlDispatcher and DefaultControlDispatcher

PiperOrigin-RevId: 386401066

RELEASENOTES.md

@@ -45,6 +45,8 @@
         `Player.EVENT_MEDIA_METADATA_CHANGED` for convenient access to
         `Player.EVENT_MEDIA_METADATA_CHANGED` for convenient access to
         structured metadata, or access the raw static metadata directly from the
         structured metadata, or access the raw static metadata directly from the
         `TrackSelection#getFormat()`.
         `TrackSelection#getFormat()`.
+    *   Deprecate `ControlDispatcher` and `DefaultControlDispatcher`. Use a
+        `ForwardingPlayer` or configure the player to customize operations.
 *   Remove deprecated symbols:
 *   Remove deprecated symbols:
     *   Remove `Player.getPlaybackError`. Use `Player.getPlayerError` instead.
     *   Remove `Player.getPlaybackError`. Use `Player.getPlayerError` instead.
     *   Remove `Player.getCurrentTag`. Use `Player.getCurrentMediaItem` and
     *   Remove `Player.getCurrentTag`. Use `Player.getCurrentMediaItem` and

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

@@ -17,13 +17,8 @@ package com.google.android.exoplayer2;
 
 
 import com.google.android.exoplayer2.Player.RepeatMode;
 import com.google.android.exoplayer2.Player.RepeatMode;
 
 
-/**
- * Dispatches operations to the {@link Player}.
- *
- * <p>Implementations may choose to suppress (e.g. prevent playback from resuming if audio focus is
- * denied) or modify (e.g. change the seek position to prevent a user from seeking past a
- * non-skippable advert) operations.
- */
+/** @deprecated Use a {@link ForwardingPlayer} or configure the player to customize operations. */
+@Deprecated
 public interface ControlDispatcher {
 public interface ControlDispatcher {
 
 
   /**
   /**

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

@@ -18,7 +18,8 @@ package com.google.android.exoplayer2;
 import static java.lang.Math.max;
 import static java.lang.Math.max;
 import static java.lang.Math.min;
 import static java.lang.Math.min;
 
 
-/** Default {@link ControlDispatcher}. */
+/** @deprecated Use a {@link ForwardingPlayer} or configure the player to customize operations. */
+@Deprecated
 public class DefaultControlDispatcher implements ControlDispatcher {
 public class DefaultControlDispatcher implements ControlDispatcher {
 
 
   private final long rewindIncrementMs;
   private final long rewindIncrementMs;