此页面由 Cloud Translation API 翻译。

预加载媒体

IMA SDK 支持预加载视频广告素材资源。您可以在 SDK 集成中启用此功能让广告与内容之间更顺畅切换。本指南介绍了在 Google Cloud 控制台中使用 IMA SDK 进行媒体预加载。

前提条件

预加载需要使用 3.17.0 或更高版本的 IMA Android SDK。

启用预加载

如需启用预加载，请使用 AdsRenderingSettings.setEnablePreloading() 将预加载设为 true此操作必须在onAdsManagerLoaded()内完成回调：

@Override
public void onAdsManagerLoaded(AdsManagerLoadedEvent adsManagerLoadedEvent) {
  ...
  AdsRenderingSettings adsRenderingSettings =
      ImaSdkFactory.getInstance().createAdsRenderingSettings();
  adsRenderingSettings.setEnablePreloading(true);
  mAdsManager.init(adsRenderingSettings);
}

支持使用自定义 VideoAdPlayer 进行预加载

我们建议采用 ExoPlayer-IMA 扩展程序代码中使用的 Android BasicExample 应用。集成后，ExoPlayer-IMA 扩展程序会默认启用预加载功能并且包含内置预加载支持。

如果您在不使用 ExoPlayer-IMA 扩展程序的情况下实现预加载，在调用 setEnablePreloading() 后需要进行其他更改。订单视频播放器支持预加载广告，它必须跟踪从 loadAd() 和 playAd() 的调用中传递的 AdMediaInfo 对象；并在 AdPlayerCallback 调用中包含正确的 AdMediaInfo。这可能会需要一个数据结构来管理 AdMediaInfo 对象，因为 loadAd() 而之前的 AdMediaInfo 则会发生AdMediaInfo 。以下示例演示了其中的一些更改您可能需要让应用支持预加载：

// enum for cases of PlayerState.
static enum PlayerState {
  IDLE,
  LOADED,
  PLAYING,
  PAUSED,
}

...

private final List<VideoAdPlayer.VideoAdPlayerCallback> callbacks;
private final ArrayList<AdMediaInfo> mediaInfos = new ArrayList<>();
private PlayerState playerState;
private boolean adCurrentlyLoaded;

...

@Override
public void playAd(AdMediaInfo adMediaInfo) {
  switch (playerState) {
    case LOADED:
      for (VideoAdPlayerCallback callback : callbacks) {
        callback.onPlay(adMediaInfo);
      }
      break;
    case PAUSED:
      for (VideoAdPlayerCallback callback : callbacks) {
        callback.onResume(adMediaInfo);
      }
      break;
    case PLAYING:
      // Intentionally and silently ignore since it is already playing from a prior media item,
      // note that onPlay is triggered by positionDiscontinuity.
      return;
    case IDLE:
      throw new IllegalStateException("Call to playAd when player state is not LOADED.");
  }
  playerState = PlayerState.PLAYING;
  player.setPlayWhenReady(true);
}

@Override
public void loadAd(AdMediaInfo adMediaInfo, AdPodInfo adPodInfo) {
  if (adCurrentlyLoaded == true) {
    mediaInfos.add(adMediaInfo);
    return;
  }
  player.stop();
  player.seekTo(0);
  mediaInfos.clear();
  mediaInfos.add(adMediaInfo);
  player.setPlayWhenReady(false);
  player.loadMedia(adMediaInfo.getUrl());
  playerState = PlayerState.LOADED;
  adCurrentlyLoaded = true;
}

@Override
public void stopAd(AdMediaInfo adMediaInfo) {
  if (allAdsInBreakHavePlayed()) {
    if (isFinalAd(adMediaInfo)) {
      // handle clean up after all ads have played.
    } else {
      seekToNextItem(player);
    }
  } else {
    mediaInfos.remove(adMediaInfo);
  }
}

private boolean allAdsInBreakHavePlayed() {
  // Code to determine if all the ads in the current ad break have completed.
}

private boolean isFinalAd(AdMediaInfo adMediaInfo) {
  // Code to determine if this adMediaInfo is the final ad.
}

private void seekToNextItem(YourPlayerClass player) {
  // Code to seek your player to the next media item.
}

测试自定义预加载实现

对于自定义预加载实现，测试以下极端情况建议验证预加载设置是否正确：

单个广告前贴片广告
3 广告连播前贴片广告
3 个广告连播中贴片广告
在第一个中贴片广告开始预加载但还未播放完毕时，查找第二个中贴片广告
后贴片广告播放

计时

下表总结了预加载时广告加载时间的变化已启用：

事件	带预加载	不使用预加载
请求的广告 VAST	`AdsLoader.requestAds()`	`AdsLoader.requestAds()`
前贴片广告已加载（单个广告）	`AdsManager.init()`	`AdsManager.start()`
前贴片广告加载（VMAP/广告规则）	`AdsManager.init()`	`AdsManager.init()`
已加载中贴片广告或后贴片广告	对于广告插播时间点的第 1 个广告，广告开始时间前 8 秒。对于连续播放的广告，当上一个广告开始播放时。	在广告开始播放时。

常见问题解答

媒体预加载是否会加载整个广告素材？: 不会，当广告开始播放时，广告素材通常未完全加载。预加载旨在最大限度地缩短时间，从而提升用户体验广告加载所需时间它不支持离线广告投放。
是否需要为广告的 VAST 和媒体启用媒体预加载？: 否，无论这种预加载是多少，SDK 始终会预加载广告的 VAST 设置。