此页面由 Cloud Translation API 翻译。

开始使用 IMA DAI SDK

IMA SDK 可让您轻松地将多媒体广告集成到您的网站和应用中。IMA SDK 可从任何符合 VAST 标准的广告服务器请求广告，并管理您应用中的广告播放。使用 IMA DAI SDK 时，应用会针对广告和内容视频（VOD 或直播内容）发出视频流请求。然后，SDK 会返回组合的视频流，因此您无需在应用中管理广告与内容视频之间的切换。

选择您感兴趣的 DAI 解决方案

广告连播投放 DAI

本指南演示了如何结合使用 IMA DAI SDK 和一个简单的视频播放器来播放 DAI Pod Serving 视频流，以便播放直播和 VOD 视频流。如果您想查看或了解已完成的示例集成，请下载 pod 传送示例。

IMA DAI Pod Serving 概览

StreamRequest：用于定义向 Google 广告服务器的数据流请求的对象。必须使用 ImaSdkFactory.createPodStreamRequest() 或 ImaSdkFactory.createPodVodStreamRequest() 创建，才能启用 Pod 传送。这些方法需要广告联盟代码，createPodStreamRequest 还需要自定义资产密钥和可选的 API 密钥。两者均包含其他可选参数。
StreamManager：用于处理视频流与 IMA DAI SDK 之间的通信的对象，例如触发跟踪 ping 以及将视频流事件转发给发布商。

前提条件

已设置 IMA DAI SDK 的 Android 应用可播放包含 DAI 广告的视频流。如果您还没有此类应用，我们建议您从 Android DAI BasicExample 入手。BasicExample 包含本指南中引用的代码库。
您的应用必须使用 VideoStreamPlayerCallback.onUserTextReceived() 发送 ID3 事件，以便 IMA DAI 正常运行。请参阅此全服务 DAI 代码段示例。

设置 Pod 服务变量

广告连播投放所需的所有更改都在 SampleAdsWrapper.java 中完成。第一步是更新常量变量。

以下是要添加的广告连播视频流请求常量：

STREAM_URL：仅用于直播 - 由清单操纵器或使用 Pod 传送的第三方合作伙伴提供的视频流网址。在您发出请求之前，它应该要求您插入由 IMA DAI SDK 提供的视频流 ID。在这种情况下，数据流网址包含一个占位符 "[[STREAMID]]"，它在发出请求之前会被替换为数据流 ID。
NETWORK_CODE：您的 Ad Manager 360 帐号的广告资源网代码。
CUSTOM_ASSET_KEY：仅用于直播活动 - 用于标识 Ad Manager 360 中的广告连播投放事件的自定义素材资源键。这可以由您的清单操纵器或第三方 Pod 服务合作伙伴创建。
API_KEY：仅用于直播活动 - 从 IMA DAI SDK 检索视频流 ID 时需要使用的可选 API 密钥。

Android DAI BasicExample 旨在播放各种不同类型的视频流，但对于 Pod 传送，它设置为仅播放单个视频流。更改示例的变量部分以匹配以下内容：

/** This class adds ad-serving support to Sample HlsVideoPlayer */
public class SampleAdsWrapper
        implements AdEvent.AdEventListener, AdErrorEvent.AdErrorListener, AdsLoader.AdsLoadedListener {

  // Podserving Stream Constants.
  private static final String STREAM_URL =
          "https://encodersim.sandbox.google.com/masterPlaylist/9c654d63-5373-4673-8c8d-6d92b66b9d46/" +
          "master.m3u8?gen-seg-redirect=true&amp;network=51636543&amp;event=google-sample" +
          "&amp;pids=devrel4628000,devrel896000,devrel3528000,devrel1428000,devrel2628000,devrel1928000" +
          "&amp;seg-host=dai.google.com&amp;stream_id=[[STREAMID]]";
  private static final String NETWORK_CODE = "51636543";
  private static final String CUSTOM_ASSET_KEY = "google-sample";
  private static final String API_KEY = "";

  private static final String PLAYER_TYPE = "DAISamplePlayer";

  /** Log interface, so we can output the log commands to the UI or similar. */
  public interface Logger {

...

创建直播或 VOD 广告连播视频流请求以启用广告连播传送

直播广告连播投放

移除了 buildStreamRequest() 方法，该方法过去用于在构建各种流类型之间进行切换。然后，将 requestAndPlayAds() 更改为调用 ImaSdkFactory.createPodStreamRequest()，以创建实时广告连播广告投放广告请求。最后，使用 AdsLoader.requestStream() 请求该数据流。

public void requestAndPlayAds() {
  StreamRequest request =
      sdkFactory.createPodStreamRequest(NETWORK_CODE, CUSTOM_ASSET_KEY, API_KEY);
  request.setFormat(StreamFormat.HLS);

  adsLoader.addAdErrorListener(this);
  adsLoader.addAdsLoadedListener(this);
  adsLoader.requestStream(request);
}

VOD 视频流广告连播投放

移除了 buildStreamRequest() 方法，该方法过去用于在构建各种流类型之间进行切换。然后，将 requestAndPlayAds() 更改为调用 ImaSdkFactory.createPodVodStreamRequest()，以创建 VOD 广告连播投放广告请求。最后，使用 AdsLoader.requestStream() 请求该数据流。

public void requestAndPlayAds() {
  StreamRequest request =
      sdkFactory.createPodVodStreamRequest(NETWORK_CODE);
  request.setFormat(StreamFormat.HLS);

  adsLoader.addAdErrorListener(this);
  adsLoader.addAdsLoadedListener(this);
  adsLoader.requestStream(request);
}

修改并设置直播网址

直播广告连播投放

调用 StreamManager.getStreamId() 即可获取数据流 ID。然后，需要将其插入 STEAM_URL 以替换 "[[STREAMID]]"。进行此更改后，可以使用 videoPlayer.setStreamUrl() 设置新的直播网址。

@Override
public void onAdsManagerLoaded(AdsManagerLoadedEvent event) {
  streamManager = event.getStreamManager();
  streamManager.addAdErrorListener(this);
  streamManager.addAdEventListener(this);

  // To enable streams
  String streamID = streamManager.getStreamId();
  String streamUrl = STREAM_URL.replace("[[STREAMID]]", streamID);

  streamManager.init();

  videoPlayer.setStreamUrl(streamUrl);
  videoPlayer.play();
}

VOD 视频流广告连播投放

调用 StreamManager.getStreamId() 即可获取数据流 ID。然后，向您的视频技术合作伙伴 (VTP) 请求直播网址。然后调用 StreamManager.loadThirdPartyStream()，让 IMA 加载直播网址以及您的 TVP 返回的所有字幕。

@Override
public void onAdsManagerLoaded(AdsManagerLoadedEvent event) {
  streamManager = event.getStreamManager();
  streamManager.addAdErrorListener(this);
  streamManager.addAdEventListener(this);

  // To enable streams
  String streamID = streamManager.getStreamId();
  // 'vtpInterface' is a place holder for your own video technology partner
  // (VTP) API calls.
  String streamUrl = vtpInterface.requestStreamURL(streamID);

  streamManager.init();

  // Pass any subtitles returned by your VTP in this step as well.
  streamManager.loadThirdPartyStream(streamUrl, subtitles);
}

启用 Pod 投放后，IMA 不会调用 VideoStreamPlayer.loadUrl()，因此您可以从中移除对 videoPlayer.setStreamUrl() 和 videoPlayer.play() 的任何调用。

大功告成！现在，您正在通过 IMA DAI SDK 在广告连播投放视频流中请求并展示广告。如需查看所使用的 Android SDK 的其他示例，请参阅 GitHub 上的示例。