Add DefaultMediaSourceFactory.{set,clear}LocalAdInsertionConfig

Deprecate the setAdsLoaderProvider and setAdViewProvider methods these
replace.

PiperOrigin-RevId: 448251423

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

@@ -311,8 +311,8 @@ public class PlayerActivity extends AppCompatActivity
             serverSideAdsLoader, new DefaultMediaSourceFactory(dataSourceFactory));
     return new DefaultMediaSourceFactory(dataSourceFactory)
         .setDrmSessionManagerProvider(drmSessionManagerProvider)
-        .setAdsLoaderProvider(this::getClientSideAdsLoader)
-        .setAdViewProvider(playerView)
+        .setLocalAdInsertionComponents(
+            this::getClientSideAdsLoader, /* adViewProvider= */ playerView)
         .setServerSideAdInsertionMediaSourceFactory(imaServerSideAdInsertionMediaSourceFactory);
   }
 

docs/ad-insertion.md

@@ -51,8 +51,8 @@ build and inject a `DefaultMediaSourceFactory` configured with an
 ~~~
 MediaSource.Factory mediaSourceFactory =
     new DefaultMediaSourceFactory(context)
-        .setAdsLoaderProvider(adsLoaderProvider)
-        .setAdViewProvider(playerView);
+        .setLocalAdInsertionComponents(
+            adsLoaderProvider, /* adViewProvider= */ playerView);
 ExoPlayer player = new ExoPlayer.Builder(context)
     .setMediaSourceFactory(mediaSourceFactory)
     .build();

docs/media-sources.md

@@ -35,8 +35,8 @@ these requirements and injected during player construction:
 ~~~
 MediaSource.Factory mediaSourceFactory =
     new DefaultMediaSourceFactory(cacheDataSourceFactory)
-        .setAdsLoaderProvider(adsLoaderProvider)
-        .setAdViewProvider(playerView);
+        .setLocalAdInsertionComponents(
+             adsLoaderProvider, /* adViewProvider= */ playerView);
 ExoPlayer player = new ExoPlayer.Builder(context)
     .setMediaSourceFactory(mediaSourceFactory)
     .build();

library/core/src/main/java/com/google/android/exoplayer2/source/DefaultMediaSourceFactory.java

@@ -188,9 +188,15 @@ public final class DefaultMediaSourceFactory implements MediaSourceFactory {
    * Sets the {@link AdsLoader.Provider} that provides {@link AdsLoader} instances for media items
    * that have {@link MediaItem.LocalConfiguration#adsConfiguration ads configurations}.
    *
+   * <p>This will override or clear the {@link AdsLoader.Provider} set by {@link
+   * #setLocalAdInsertionComponents(AdsLoader.Provider, AdViewProvider)}.
+   *
    * @param adsLoaderProvider A provider for {@link AdsLoader} instances.
    * @return This factory, for convenience.
+   * @deprecated Use {@link #setLocalAdInsertionComponents(AdsLoader.Provider, AdViewProvider)}
+   *     instead.
    */
+  @Deprecated
   public DefaultMediaSourceFactory setAdsLoaderProvider(
       @Nullable AdsLoader.Provider adsLoaderProvider) {
     this.adsLoaderProvider = adsLoaderProvider;
@@ -200,15 +206,54 @@ public final class DefaultMediaSourceFactory implements MediaSourceFactory {
   /**
    * Sets the {@link AdViewProvider} that provides information about views for the ad playback UI.
    *
-   * @param adViewProvider A provider for {@link AdsLoader} instances.
+   * <p>This will override or clear the {@link AdViewProvider} set by {@link
+   * #setLocalAdInsertionComponents(AdsLoader.Provider, AdViewProvider)}.
+   *
+   * @param adViewProvider A provider for information about views for the ad playback UI.
    * @return This factory, for convenience.
+   * @deprecated Use {@link #setLocalAdInsertionComponents(AdsLoader.Provider, AdViewProvider)}
+   *     instead.
    */
+  @Deprecated
   public DefaultMediaSourceFactory setAdViewProvider(@Nullable AdViewProvider adViewProvider) {
     this.adViewProvider = adViewProvider;
     return this;
   }
 
   /**
+   * Sets the components required for local ad insertion for media items that have {@link
+   * MediaItem.LocalConfiguration#adsConfiguration ads configurations}
+   *
+   * <p>This will override the values set by {@link #setAdsLoaderProvider(AdsLoader.Provider)} and
+   * {@link #setAdViewProvider(AdViewProvider)}.
+   *
+   * @param adsLoaderProvider A provider for {@link AdsLoader} instances.
+   * @param adViewProvider A provider for information about views for the ad playback UI.
+   * @return This factory, for convenience.
+   */
+  public DefaultMediaSourceFactory setLocalAdInsertionComponents(
+      AdsLoader.Provider adsLoaderProvider, AdViewProvider adViewProvider) {
+    this.adsLoaderProvider = checkNotNull(adsLoaderProvider);
+    this.adViewProvider = checkNotNull(adViewProvider);
+    return this;
+  }
+
+  /**
+   * Clear any values set via {@link #setLocalAdInsertionComponents(AdsLoader.Provider,
+   * AdViewProvider)}.
+   *
+   * <p>This will also clear any values set by {@link #setAdsLoaderProvider(AdsLoader.Provider)} and
+   * {@link #setAdViewProvider(AdViewProvider)}.
+   *
+   * @return This factory, for convenience.
+   */
+  public DefaultMediaSourceFactory clearLocalAdInsertionComponents() {
+    this.adsLoaderProvider = null;
+    this.adViewProvider = null;
+    return this;
+  }
+
+  /**
    * Sets the {@link MediaSource.Factory} used to handle {@link MediaItem} instances containing a
    * {@link Uri} identified as resolving to content with server side ad insertion (SSAI).
    *

library/core/src/test/java/com/google/android/exoplayer2/source/DefaultMediaSourceFactoryTest.java

@@ -191,8 +191,9 @@ public final class DefaultMediaSourceFactoryTest {
     assertThat(supportedTypes).asList().containsExactly(C.CONTENT_TYPE_OTHER);
   }
 
+  @SuppressWarnings("deprecation") // Testing deprecated setters.
   @Test
-  public void createMediaSource_withAdsConfiguration_callsAdsLoader() {
+  public void createMediaSource_withDeprecatedAdsConfiguration_callsAdsLoader() {
     Uri adTagUri = Uri.parse(URI_MEDIA);
     MediaItem mediaItem =
         new MediaItem.Builder()
@@ -210,6 +211,24 @@ public final class DefaultMediaSourceFactoryTest {
   }
 
   @Test
+  public void createMediaSource_withAdsConfiguration_callsAdsLoader() {
+    Uri adTagUri = Uri.parse(URI_MEDIA);
+    MediaItem mediaItem =
+        new MediaItem.Builder()
+            .setUri(URI_MEDIA)
+            .setAdsConfiguration(new MediaItem.AdsConfiguration.Builder(adTagUri).build())
+            .build();
+    DefaultMediaSourceFactory defaultMediaSourceFactory =
+        new DefaultMediaSourceFactory((Context) ApplicationProvider.getApplicationContext())
+            .setLocalAdInsertionComponents(
+                ignoredAdsConfiguration -> mock(AdsLoader.class), mock(AdViewProvider.class));
+
+    MediaSource mediaSource = defaultMediaSourceFactory.createMediaSource(mediaItem);
+
+    assertThat(mediaSource).isInstanceOf(AdsMediaSource.class);
+  }
+
+  @Test
   public void createMediaSource_withAdsConfiguration_adProvidersNotSet_playsWithoutAdNoException() {
     MediaItem mediaItem =
         new MediaItem.Builder()