Revert "Playlist API: Add setMediaItem() and prepare()"

This reverts commit cd2c1f2f.

demos/main/src/main/java/com/google/android/exoplayer2/demo/PlayerActivity.java

@@ -394,8 +394,7 @@ public class PlayerActivity extends AppCompatActivity
     if (haveStartPosition) {
       player.seekTo(startWindow, startPosition);
     }
-    player.setMediaItem(mediaSource);
-    player.prepare();
+    player.prepare(mediaSource, !haveStartPosition, false);
     updateButtonVisibility();
   }
 

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

@@ -331,50 +331,25 @@ public interface ExoPlayer extends Player {
    */
   void retry();
 
-  /** Prepares the player. */
-  void prepare();
-
   /**
-   * @deprecated Use {@code setMediaItem(mediaSource, C.TIME_UNSET)} and {@link #prepare()} instead.
+   * Prepares the player to play the provided {@link MediaSource}. Equivalent to {@code
+   * prepare(mediaSource, true, true)}.
    */
-  @Deprecated
   void prepare(MediaSource mediaSource);
 
-  /** @deprecated Use {@link #setMediaItem(MediaSource, long)} and {@link #prepare()} instead. */
-  @Deprecated
-  void prepare(MediaSource mediaSource, boolean resetPosition, boolean resetState);
-
-  /**
-   * Sets the specified {@link MediaSource}.
-   *
-   * <p>Note: This is an intermediate implementation towards a larger change. Until then {@link
-   * #prepare()} has to be called immediately after calling this method.
-   *
-   * @param mediaItem The new {@link MediaSource}.
-   */
-  void setMediaItem(MediaSource mediaItem);
-
   /**
-   * Sets the specified {@link MediaSource}.
-   *
-   * <p>Note: This is an intermediate implementation towards a larger change. Until then {@link
-   * #prepare()} has to be called immediately after calling this method.
+   * Prepares the player to play the provided {@link MediaSource}, optionally resetting the playback
+   * position the default position in the first {@link Timeline.Window}.
    *
-   * <p>This intermediate implementation calls {@code stop(true)} before seeking to avoid seeking in
-   * a media item that has been set previously. It is equivalent with calling
-   *
-   * <pre><code>
-   *   if (!getCurrentTimeline().isEmpty()) {
-   *     player.stop(true);
-   *   }
-   *   player.seekTo(0, startPositionMs);
-   *   player.setMediaItem(mediaItem);
-   * </code></pre>
-   *
-   * @param mediaItem The new {@link MediaSource}.
-   * @param startPositionMs The position in milliseconds to start playback from.
+   * @param mediaSource The {@link MediaSource} to play.
+   * @param resetPosition Whether the playback position should be reset to the default position in
+   *     the first {@link Timeline.Window}. If false, playback will start from the position defined
+   *     by {@link #getCurrentWindowIndex()} and {@link #getCurrentPosition()}.
+   * @param resetState Whether the timeline, manifest, tracks and track selections should be reset.
+   *     Should be true unless the player is being prepared to play the same media as it was playing
+   *     previously (e.g. if playback failed and is being retried).
    */
-  void setMediaItem(MediaSource mediaItem, long startPositionMs);
+  void prepare(MediaSource mediaSource, boolean resetPosition, boolean resetState);
 
   /**
    * Creates a message that can be sent to a {@link PlayerMessage.Target}. By default, the message

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

@@ -62,7 +62,7 @@ import java.util.concurrent.CopyOnWriteArrayList;
   private final Timeline.Period period;
   private final ArrayDeque<Runnable> pendingListenerNotifications;
 
-  @Nullable private MediaSource mediaSource;
+  private MediaSource mediaSource;
   private boolean playWhenReady;
   @PlaybackSuppressionReason private int playbackSuppressionReason;
   @RepeatMode private int repeatMode;
@@ -219,38 +219,34 @@ import java.util.concurrent.CopyOnWriteArrayList;
   }
 
   @Override
-  @Deprecated
   public void prepare(MediaSource mediaSource) {
-    setMediaItem(mediaSource);
-    prepareInternal(/* resetPosition= */ true, /* resetState= */ true);
+    prepare(mediaSource, /* resetPosition= */ true, /* resetState= */ true);
   }
 
   @Override
-  @Deprecated
   public void prepare(MediaSource mediaSource, boolean resetPosition, boolean resetState) {
-    setMediaItem(mediaSource);
-    prepareInternal(resetPosition, resetState);
-  }
-
-  @Override
-  public void prepare() {
-    Assertions.checkNotNull(mediaSource);
-    prepareInternal(/* resetPosition= */ false, /* resetState= */ true);
-  }
-
-  @Override
-  public void setMediaItem(MediaSource mediaItem, long startPositionMs) {
-    if (!getCurrentTimeline().isEmpty()) {
-      stop(/* reset= */ true);
-    }
-    seekTo(/* windowIndex= */ 0, startPositionMs);
-    setMediaItem(mediaItem);
+    this.mediaSource = mediaSource;
+    PlaybackInfo playbackInfo =
+        getResetPlaybackInfo(
+            resetPosition,
+            resetState,
+            /* resetError= */ true,
+            /* playbackState= */ Player.STATE_BUFFERING);
+    // Trigger internal prepare first before updating the playback info and notifying external
+    // listeners to ensure that new operations issued in the listener notifications reach the
+    // player after this prepare. The internal player can't change the playback info immediately
+    // because it uses a callback.
+    hasPendingPrepare = true;
+    pendingOperationAcks++;
+    internalPlayer.prepare(mediaSource, resetPosition, resetState);
+    updatePlaybackInfo(
+        playbackInfo,
+        /* positionDiscontinuity= */ false,
+        /* ignored */ DISCONTINUITY_REASON_INTERNAL,
+        TIMELINE_CHANGE_REASON_RESET,
+        /* seekProcessed= */ false);
   }
 
-  @Override
-  public void setMediaItem(MediaSource mediaItem) {
-    mediaSource = mediaItem;
-  }
 
   @Override
   public void setPlayWhenReady(boolean playWhenReady) {
@@ -610,29 +606,6 @@ import java.util.concurrent.CopyOnWriteArrayList;
     }
   }
 
-  /* package */ void prepareInternal(boolean resetPosition, boolean resetState) {
-    Assertions.checkNotNull(mediaSource);
-    PlaybackInfo playbackInfo =
-        getResetPlaybackInfo(
-            resetPosition,
-            resetState,
-            /* resetError= */ true,
-            /* playbackState= */ Player.STATE_BUFFERING);
-    // Trigger internal prepare first before updating the playback info and notifying external
-    // listeners to ensure that new operations issued in the listener notifications reach the
-    // player after this prepare. The internal player can't change the playback info immediately
-    // because it uses a callback.
-    hasPendingPrepare = true;
-    pendingOperationAcks++;
-    internalPlayer.prepare(mediaSource, resetPosition, resetState);
-    updatePlaybackInfo(
-        playbackInfo,
-        /* positionDiscontinuity= */ false,
-        /* ignored */ DISCONTINUITY_REASON_INTERNAL,
-        TIMELINE_CHANGE_REASON_RESET,
-        /* seekProcessed= */ false);
-  }
-
   private void handlePlaybackParameters(
       PlaybackParameters playbackParameters, boolean operationAck) {
     if (operationAck) {

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

@@ -1162,7 +1162,6 @@ public class SimpleExoPlayer extends BasePlayer
   }
 
   @Override
-  @SuppressWarnings("deprecation")
   public void retry() {
     verifyApplicationThread();
     if (mediaSource != null
@@ -1172,38 +1171,23 @@ public class SimpleExoPlayer extends BasePlayer
   }
 
   @Override
-  @Deprecated
-  @SuppressWarnings("deprecation")
   public void prepare(MediaSource mediaSource) {
     prepare(mediaSource, /* resetPosition= */ true, /* resetState= */ true);
   }
 
   @Override
-  @Deprecated
   public void prepare(MediaSource mediaSource, boolean resetPosition, boolean resetState) {
     verifyApplicationThread();
-    setMediaItem(mediaSource);
-    prepareInternal(resetPosition, resetState);
-  }
-
-  @Override
-  public void prepare() {
-    verifyApplicationThread();
-    prepareInternal(/* resetPosition= */ false, /* resetState= */ true);
-  }
-
-  @Override
-  public void setMediaItem(MediaSource mediaItem, long startPositionMs) {
-    verifyApplicationThread();
-    setMediaItemInternal(mediaItem);
-    player.setMediaItem(mediaItem, startPositionMs);
-  }
-
-  @Override
-  public void setMediaItem(MediaSource mediaItem) {
-    verifyApplicationThread();
-    setMediaItemInternal(mediaItem);
-    player.setMediaItem(mediaItem);
+    if (this.mediaSource != null) {
+      this.mediaSource.removeEventListener(analyticsCollector);
+      analyticsCollector.resetForNewMediaSource();
+    }
+    this.mediaSource = mediaSource;
+    mediaSource.addEventListener(eventHandler, analyticsCollector);
+    @AudioFocusManager.PlayerCommand
+    int playerCommand = audioFocusManager.handlePrepare(getPlayWhenReady());
+    updatePlayWhenReady(getPlayWhenReady(), playerCommand);
+    player.prepare(mediaSource, resetPosition, resetState);
   }
 
   @Override
@@ -1448,23 +1432,6 @@ public class SimpleExoPlayer extends BasePlayer
 
   // Internal methods.
 
-  private void prepareInternal(boolean resetPosition, boolean resetState) {
-    Assertions.checkNotNull(mediaSource);
-    @AudioFocusManager.PlayerCommand
-    int playerCommand = audioFocusManager.handlePrepare(getPlayWhenReady());
-    updatePlayWhenReady(getPlayWhenReady(), playerCommand);
-    player.prepareInternal(resetPosition, resetState);
-  }
-
-  private void setMediaItemInternal(MediaSource mediaItem) {
-    if (mediaSource != null) {
-      mediaSource.removeEventListener(analyticsCollector);
-      analyticsCollector.resetForNewMediaSource();
-    }
-    mediaSource = mediaItem;
-    mediaSource.addEventListener(eventHandler, analyticsCollector);
-  }
-
   private void removeSurfaceCallbacks() {
     if (textureView != null) {
       if (textureView.getSurfaceTextureListener() != componentListener) {

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

@@ -431,8 +431,7 @@ public final class ExoPlayerTestRunner implements Player.EventListener, ActionSc
             if (actionSchedule != null) {
               actionSchedule.start(player, trackSelector, null, handler, ExoPlayerTestRunner.this);
             }
-            player.setMediaItem(mediaSource);
-            player.prepare();
+            player.prepare(mediaSource, /* resetPosition= */ false, /* resetState= */ false);
           } catch (Exception e) {
             handleException(e);
           }

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

@@ -97,11 +97,6 @@ public abstract class StubExoPlayer extends BasePlayer implements ExoPlayer {
   }
 
   @Override
-  public void prepare() {
-    throw new UnsupportedOperationException();
-  }
-
-  @Override
   public void prepare(MediaSource mediaSource) {
     throw new UnsupportedOperationException();
   }
@@ -112,16 +107,6 @@ public abstract class StubExoPlayer extends BasePlayer implements ExoPlayer {
   }
 
   @Override
-  public void setMediaItem(MediaSource mediaItem) {
-    throw new UnsupportedOperationException();
-  }
-
-  @Override
-  public void setMediaItem(MediaSource mediaItem, long startPositionMs) {
-    throw new UnsupportedOperationException();
-  }
-
-  @Override
   public void setPlayWhenReady(boolean playWhenReady) {
     throw new UnsupportedOperationException();
   }