手动广告插播时间点

本指南介绍了如何替换默认的广告插播安排以及配置您自己的广告插播时间点播放时间。如果实现了手动广告插播时间点播放,SDK 会在广告插播时间点已加载时触发 AD_BREAK_READY 事件,并等待您开始播放广告插播时间点。

前提条件

  • 已实现 IMA SDK 的 Android 应用。

配置手动广告插播时间点播放

如需配置手动广告插播播放,请执行以下操作:

  1. 告知 SDK 您要控制广告插播的播放。
  2. 监听 AD_BREAK_READY 事件。
  3. 准备好后,告知 SDK 播放广告。

以下代码段展示了实现手动广告插播所需对高级示例进行的修改。

public VideoPlayerController(
      Context context,
      VideoPlayerWithAdPlayback videoPlayerWithAdPlayback,
      View playButton,
      View playPauseToggle,
      String language,
      ViewGroup companionViewGroup,
      Logger log) {
  ...
  
  sdkFactory = ImaSdkFactory.getInstance();
  ImaSdkSettings imaSdkSettings = sdkFactory.createImaSdkSettings();
  imaSdkSettings.setLanguage(language);
  // Tell the SDK you want to control ad break playback.
  imaSdkSettings.setAutoPlayAdBreaks(false);
  
  ...
}
...
@Override
public void onAdEvent(AdEvent adEvent) {
    ...
    switch (adEvent.getType()) {
      // Listen for the AD_BREAK_READY event.
      case AD_BREAK_READY:
        // Tell the SDK to play ads when you're ready. To skip this ad break,
        // simply return from this handler without calling adsManager.start().
        adsManager.start();
        break;
      ...
}

常见问题解答

是否需要手动播放广告才能实现 IMA SDK?
否。对于不希望 IMA SDK 按照广告规则或 VMAP 响应的时间安排自动播放广告插播的发布商,手动广告播放是一项可选功能。