---
metadata:
  - name: generator
    content: Diplodoc Platform v5.34.3
alternate:
  - https://yandex.com/dev/video-sdk/doc/en/sdk-html5/AdPlaybackController-class.md
  - https://yandex.com/dev/video-sdk/doc/ru/sdk-html5/AdPlaybackController-class.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/video-sdk/doc/ru/llms.txt

# AdPlaybackController

Объект предоставляет API для контроля над воспроизведением рекламы. Позволяет проиграть рекламу один раз. Для повторного проигрывания необходимо создать новый экземпляр AdPlaybackController.

[Методы](#methods)

## Методы {#methods}

#|
|| **Имя** | **Тип (Возвр.)** | **Описание** ||
|| `getAdContentSize ()` | [PublicAdContentSize](https://yandex.com/dev/video-sdk/doc/ru/sdk-html5/PublicAdContentSize.md) | Возвращает текущие размеры рекламы. ||
|| `getAdPlayingState ()` | [PublicAdPlayingState](https://yandex.com/dev/video-sdk/doc/ru/sdk-html5/PublicAdPlayingState.md) | Возвращает текущее состояние проигрывания рекламы. ||
|| `getAdSkippableState ()` | boolean | Возможность пропуска креатива. ||
|| `pauseAd ()` | void | Приостанавливает проигрывание рекламы. ||
|| `playAd ()` | void
|
Запускает проигрывание рекламы.

{% note warning %}

Метод может вызываться только один раз, все последующие вызовы будут проигнорированы.

{% endnote %}||
|| `resumeAd ()` | void | Продолжает проигрывание рекламы. ||
|| `skipAd ()` | void | Пропускает всю рекламу сразу (все AdPod). Перед вызовом метода плееру необходимо убедиться, что метод `getAdSkippableState` возвращает значение `true`. ||
|| `stopAd ()` | void | Останавливает проигрывание рекламы. ||
||`subscribe` 
([`AdPlaybackControllerSubscribeMethod`](https://yandex.com/dev/video-sdk/doc/ru/sdk-html5/AdPlaybackControllerSubscribeMethod-function.md))
|  
| Подписывает на рекламное событие.||
||`getAdVolume` | number | Возвращает текущую громкость в диапазоне [0; 1]. Реальная громкость будет возвращаться только после вызова метода `playAd ()` и до уничтожения объекта. В любое другое время возвращается `0`.||
||`setAdVolume` | void
|
Устанавливает громкость в диапазоне [0; 1]. Установка громкости доступна только после старта рекламы (метод `playAd ()`) и до ее окончания (событие `AdStopped`).

{% note alert %}

Установка ненулевой громкости может привести к постановке видео на паузу, если видеоэлемент не активирован. Это связано с политиками автоматического воспроизведения в браузерах. Рекомендуется включать звук только по пользовательскому действию.

{% endnote %}||
|| `getAdVolumeAvailabilityState` | boolean 
|
Статус доступности регулировки громкости рекламы. Допустимые значения:
* `true` — регулировка доступна;
* `false` — регулировка недоступна.

Реальный статус доступен сразу после вызова метода `playAd ()` и до уничтожения объекта. В любое другое время возвращается `false`.

{% note info %}

Статус возвращается независимо от видимости элементов регулировки громкости.

{% endnote %}||
|| `getAdPodTimeToSkip` |   | Возвращает время до возможности пропуска креатива. ||
|| `getAdRemainingTime ` |   | Возвращает оставшееся время воспроизведения всего блока рекламы. ||
|| `getAdPodRemainingTime ` |   | Возвращает оставшееся время воспроизведения текущего рекламного креатива. ||
|| `getAdDuration ` |   | Возвращает длительность всего блока рекламы. ||
|| `getAdPodDuration ` |   | Возвращает длительность текущего рекламного креатива. ||
|#