---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ads.yandex.com/helpcenter/en/dev/android7/instream-based.md
  - https://ads.yandex.com/helpcenter/ru/dev/android7/instream-based.md
  - href: ru/dev/android7/instream-based.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/ru/llms.txt

<!--
Используется в Boost: boost/ru/ad-monetization/dev/android
-->

# Базовая интеграция (ExoPlayer AdsLoader API)

**YandexAdsLoader** — упрощенный API для интеграции InStream-рекламы через Media3 и ExoPlayer. YandexAdsLoader поддерживает воспроизведение рекламных вставок с типом Pre-roll, Mid-roll, Post-roll.

Этот тип интеграции подходит для приложений, которым не нужны расширенные возможности InStream API.

## Подключение с использованием Gradle {#enable-using-gradle}

В файл build.gradle добавьте следующие зависимости на уровне приложения:

{% list tabs %}

  - Media3

    ```gradle
    dependencies {
	          ...
	          implementation 'com.yandex.android:mobileads:7.18.7'
	          implementation 'androidx.media3:media3-exoplayer:1.4.1'
	          implementation 'androidx.media3:media3-ui:1.4.1'
    }
    ```

  - ExoPlayer2

    ```gradle
    dependencies {
	          ...
	          implementation 'com.yandex.android:mobileads:7.18.7'
	          implementation 'com.google.android.exoplayer:exoplayer-core:2.18.1'
    }
    ```

{% endlist %}

## Показ рекламных объявлений {#rendering-ads}

1. Добавьте в layout приложения PlayerView:

   {% list tabs %}

     - Media3

       ```xml
       <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
           android:layout_width="match_parent"
           android:layout_height="match_parent"
           android:orientation="vertical">

           <androidx.media3.ui.PlayerView
               android:id="@+id/player_view"
               android:layout_width="match_parent"
               android:layout_height="wrap_content"
               android:layout_gravity="center" />

       </FrameLayout>
       ```

     - ExoPlayer2

       ```xml
       <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
           android:layout_width="match_parent"
           android:layout_height="match_parent"
           android:orientation="vertical">

           <com.google.android.exoplayer2.ui.PlayerView
               android:id="@+id/player_view"
               android:layout_width="match_parent"
               android:layout_height="wrap_content"
               android:layout_gravity="center" />

       </FrameLayout>
       ```

   {% endlist %}

1. Создайте конфигурацию запроса `instreamAdRequestConfiguration` с помощью класса `InstreamAdRequestConfiguration.Builder`. В качестве параметров запроса передайте идентификатор страницы (`PAGE_ID`) из интерфейса Рекламной сети Яндекса.

   {% list tabs %}

     - Kotlin

       ```kotlin
       val configuration = InstreamAdRequestConfiguration
                   .Builder(PAGE_ID)
                   .build()
       ```

     - Java

       ```java
       InstreamAdRequestConfiguration configuration = new InstreamAdRequestConfiguration
                   .Builder(PAGE_ID)
                   .build();
       ```

   {% endlist %}

1. Создайте экземпляр класса `YandexAdsLoader` в `onCreate()` методе цикла `Activity` для показа и загрузки InStream-рекламы.

   {% note info %}

   Для использования `YandexAdsLoader` с `Media3` стоит импортировать его из пакета `com.yandex.mobile.ads.instream.media3`, для использования с `ExoPlayer2` — из пакета `com.yandex.mobile.ads.instream.exoplayer`.

   {% endnote %}

   {% list tabs %}

     - Kotlin

       ```kotlin
       yandexAdsLoader = YandexAdsLoader(context, configuration)
       ```

     - Java

       ```java
       yandexAdsLoader = new YandexAdsLoader(context, configuration);
       ```

   {% endlist %}

1. Добавьте функцию для создания `ExoPlayer`, в которой создайте экземпляр класса `DefaultMediaSourceFactory`, установив в него созданный экземпляр `YandexAdsLoader` и `PlayerView`.

   {% list tabs %}

     - Kotlin

       ```kotlin
       private fun createPlayer(): Player {
           val mediaSourceFactory = DefaultMediaSourceFactory(context)
               .setLocalAdInsertionComponents({ yandexAdsLoader }, playerView)

           val player = ExoPlayer.Builder(context)
               .setMediaSourceFactory(mediaSourceFactory)
               .build()

           return player
       }
       ```

     - Java

       ```java
       private YandexAdsLoader yandexAdsLoader;

       ...

       private class YandexAdsLoaderProvider implements AdsLoader.Provider {
           @Nullable
           @Override
           public AdsLoader getAdsLoader(@NonNull MediaItem.AdsConfiguration adsConfiguration) {
               return yandexAdsLoader;
           }
       }

       private Player createPlayer() {
           AdsLoader.Provider yandexAdsLoaderProvider = new YandexAdsLoaderProvider();
           DefaultMediaSourceFactory mediaSourceFactory = new DefaultMediaSourceFactory(context)
                   .setLocalAdInsertionComponents(yandexAdsLoaderProvider, playerView);

           Player player = new ExoPlayer.Builder(context)
                   .setMediaSourceFactory(mediaSourceFactory)
                   .build();

           return player;
       }
       ```

   {% endlist %}

1. Добавьте функцию для создания `MediaItem`.

   {% list tabs %}

     - Kotlin

       ```kotlin
       private fun getMediaItem(): MediaItem {
           val contentVideoUrl = CONTENT_URL
           val adTagUri = Uri.parse(YandexAdsLoader.AD_TAG_URI)
           val mediaItem = MediaItem.Builder()
               .setUri(contentVideoUrl)
               .setAdsConfiguration(MediaItem.AdsConfiguration.Builder(adTagUri).build())
               .build()
           return mediaItem
       }
       ```

     - Java

       ```java
       private MediaItem getMediaItem() {
           String contentVideoUrl = CONTENT_URL;
           Uri adTagUri = Uri.parse(YandexAdsLoader.AD_TAG_URI);
           MediaItem mediaItem = new MediaItem.Builder()
                   .setUri(contentVideoUrl)
                   .setAdsConfiguration(new MediaItem.AdsConfiguration.Builder(adTagUri).build())
                   .build();
           return mediaItem;
       }
       ```

   {% endlist %}

1. Добавьте функцию для инициализации `ExoPlayer` и восстановления состояния.

   {% list tabs %}

     - Kotlin

       ```kotlin
       private var rememberedPlayerPosition = 0L
       private var rememberedPlayWhenReady = false
       private var player: Player? = null

       ...

       private fun initPlayer() {
           val mediaItem = getMediaItem()
           player = createPlayer().also {
               playerView.player = it
               yandexAdsLoader.setPlayer(it)
               it.setMediaItem(mediaItem)
               it.playWhenReady = rememberedPlayWhenReady
               it.seekTo(rememberedPlayerPosition)
               it.prepare()
           }
       }
       ```

     - Java

       ```java
       private Long rememberedPlayerPosition = 0L;
       private Boolean rememberedPlayWhenReady = false;
       private Player player = null;

       ...

       private void initPlayer() {
           MediaItem mediaItem = getMediaItem();
           Player player = createPlayer();
           playerView.setPlayer(player);
           yandexAdsLoader.setPlayer(player);
           player.setMediaItem(mediaItem);
           player.setPlayWhenReady(rememberedPlayWhenReady);
           player.seekTo(rememberedPlayerPosition);
           player.prepare();
           this.player = player;
       }
       ```

   {% endlist %}

1. Добавьте функцию для вызова метода `release()` и сохранения состояния `ExoPlayer`.

   {% list tabs %}

     - Kotlin

       ```kotlin
       private var rememberedPlayerPosition = 0L
       private var rememberedPlayWhenReady = false
       private var player: Player? = null

       ...

       private fun releasePlayer() {
           yandexAdsLoader.setPlayer(null)
           playerView.player = null
           player?.also {
               rememberedPlayerPosition = it.contentPosition
               rememberedPlayWhenReady = it.playWhenReady
               it.release()
           }
           player = null
       }
       ```

     - Java

       ```java
       private Long rememberedPlayerPosition = 0L;
       private Boolean rememberedPlayWhenReady = false;
       private Player player = null;

       ...

       private void releasePlayer() {
           yandexAdsLoader.setPlayer(null);
           playerView.setPlayer(null);
           Player player = this.player;
           if (player != null) {
               rememberedPlayerPosition = player.getContentPosition();
               rememberedPlayWhenReady = player.getPlayWhenReady();
              player.release();
           }
           this.player = null;
       }
       ```

   {% endlist %}

1. Перепишите методы `onStart()`, `onResume()`, `onPause()` и `onStop()`, используя созданные функции. Для `API` версии 23 и ниже вызывайте созданные функции в `onPause()` и `onResume()`, в более новых версиях `API` — в методах `onStop()` и `onStart()`.

   {% list tabs %}

     - Kotlin

       ```kotlin
       override fun onStart() {
           super.onStart()
           if (Build.VERSION.SDK_INT > 23) {
               initPlayer()
               playerView.onResume()
           }
       }

       override fun onStop() {
           super.onStop()
           if (Build.VERSION.SDK_INT > 23) {
               playerView.onPause()
               releasePlayer()
           }
       }

       override fun onResume() {
           super.onResume()
           if (Build.VERSION.SDK_INT <= 23) {
               initPlayer()
               playerView.onResume()
           }
       }

       override fun onPause() {
           super.onPause()
           if (Build.VERSION.SDK_INT <= 23) {
               playerView.onPause()
               releasePlayer()
           }
       }
       ```

     - Java

       ```java
       @Override
       protected void onStart() {
           super.onStart();
           if (Build.VERSION.SDK_INT > 23) {
               initPlayer();
               playerView.onResume();
           }
       }

       @Override
       protected void onStop() {
           super.onStop();
           if (Build.VERSION.SDK_INT > 23) {
               playerView.onPause();
               releasePlayer();
           }
       }

       @Override
       protected void onResume() {
           super.onResume();
           if (Build.VERSION.SDK_INT <= 23) {
               initPlayer();
               playerView.onResume();
           }
       }

       @Override
       protected void onPause() {
           super.onPause();
           if (Build.VERSION.SDK_INT <= 23) {
               playerView.onPause();
               releasePlayer();
           }
       }
       ```

   {% endlist %}


1. Вызовите метод `release()` у `YandexAdsLoader`, когда он больше не нужен.

   {% list tabs %}

     - Kotlin

       ```kotlin
       override fun onDestroy() {
           releasePlayer()
           yandexAdsLoader.release()
           super.onDestroy()
       }
       ```

     - Java

       ```java
       @Override
       protected void onDestroy() {
           releasePlayer();
           yandexAdsLoader.release();
           super.onDestroy();
       }
       ```

   {% endlist %}