设置 IMA SDK for DAI

借助 IMA SDK，您可以轻松地将多媒体广告集成到网站和应用中。IMA SDK 可以从任何 符合 VAST 标准的广告服务器请求广告，并在您的应用中管理广告播放。借助 IMA DAI SDK，应用可以针对广告和内容视频（VOD 或直播内容）发出视频流请求。然后，SDK 会返回一个组合视频流，这样您就不必在应用内管理广告和内容视频之间的切换。

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

全服务 Pod 服务

Pod Serving DAI

借助 IMA SDK，您可以轻松地将多媒体广告集成到网站和应用中。IMA SDK 可以从任何 符合 VAST 标准的广告服务器请求广告，并在您的应用中管理广告播放。借助 IMA DAI SDK，应用可以针对广告和内容视频（VOD 或直播内容）发出视频流请求。然后，SDK 会返回一个组合视频流，这样您就不必在应用内管理广告和内容视频之间的切换。

本指南演示了如何使用 IMA DAI SDK 和视频播放器来播放 DAI Pod Serving 流，以进行直播和 VOD 流播放。如需查看或遵循已完成的集成示例，请下载 Pod Serving 示例。

注意： 适用于 Android 的 IMA DAI SDK 同时支持 HLS 和 DASH 流。

本指南介绍了如何配置 ExoPlayer 和 IMA DAI SDK 以播放 HLS 流。如需查看同时支持 HLS 和 DASH 流的视频播放器示例，请参阅我们的高级示例。

要点： 如需使用 IMA DAI Pod Serving，您必须与 Pod Serving 合作伙伴合作，并且必须拥有 Ad Manager 360 高级版账号。如果您有 Ad Manager 账号，请与您的客户经理联系以了解详情。如需了解如何注册 Ad Manager，请访问 Ad Manager 帮助中心。

注意：如需了解如何与其他平台集成，或如何使用 IMA 客户端 SDK，请参阅 互动式媒体广告 SDK。

IMA DAI Pod Serving 概览

• StreamRequest：用于定义向 Google 广告服务器发出的信息流请求的对象。必须使用 ImaSdkFactory.createPodStreamRequest() 或 ImaSdkFactory.createPodVodStreamRequest() 创建，以启用 Pod Serving。这些方法需要广告资源网代码，而 createPodStreamRequest 还需自定义内容密钥和可选的 API 密钥。两者都包含其他可选参数。

• StreamManager：用于处理视频流与 IMA DAI SDK 之间通信的对象，例如触发跟踪 ping 和将流事件转发给发布商。

前提条件

• 已设置 IMA DAI SDK 的 Android 应用，用于播放包含 DAI 广告的视频流。如果您还没有此类应用，建议您从 Android DAI BasicExample 开始。BasicExample 具有本指南中引用的代码库。

• 您的应用必须使用 VideoStreamPlayerCallback.onUserTextReceived() 发送 ID3 事件，IMA DAI 才能正常运行。请参阅此全服务 DAI 代码段示例。

设置 Pod Serving 变量

Pod Serving 所需的所有更改都在 SampleAdsWrapper.java 中完成。第一步是更新常量变量。

以下是要添加的广告插播时间流请求常量：

• STREAM_URL：仅用于直播 - 由清单操纵器或使用 Pod Serving 的第三方合作伙伴提供的视频流网址。它应该要求您在发出请求之前插入 IMA DAI SDK 提供的视频流 ID。在这种情况下，视频流网址包含一个占位符 "[[STREAMID]]"，在发出请求之前，该占位符会被替换为视频流 ID。

• NETWORK_CODE：您的 Ad Manager 360 账号的广告资源网代码。

• CUSTOM_ASSET_KEY：仅用于直播 - 用于在 Ad Manager 360 中标识 Pod 服务事件的自定义素材资源键。此文件可由您的清单操纵器或第三方 Pod Serving 合作伙伴创建。

• API_KEY：仅用于直播 - 可选的 API 密钥，可能需要此密钥才能从 IMA DAI SDK 中检索直播 ID。

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

注意： 所提供的直播参数适用于 Live Pod 直播。如需使用插播广告 VOD 视频流进行测试，您需要提供自己的测试视频流参数。

/** This class implements IMA to add pod ad-serving support to SampleVideoPlayer */
@SuppressLint("UnsafeOptInUsageError")
/* @SuppressLint is needed for new media3 APIs. */
public class SampleAdsWrapper
    implements AdEvent.AdEventListener, AdErrorEvent.AdErrorListener, AdsLoader.AdsLoadedListener {

  // Set up the pod serving variables.
  private static final String NETWORK_CODE = "";
  private static final String CUSTOM_ASSET_KEY = "";
  private static final String API_KEY = "";
  private static final String STREAM_URL = "";
  private static final StreamFormat STREAM_FORMAT = StreamFormat.HLS;
SampleAdsWrapper.java

创建直播或 VOD Pod 视频流请求，以启用 Pod Serving

直播广告插播

移除了曾用于在构建各种流类型之间切换的方法 buildStreamRequest()。然后，修改 requestAndPlayAds() 以调用 ImaSdkFactory.createPodStreamRequest() 来创建 Live Pod Serving 广告请求。

// Live pod stream request.
request = sdkFactory.createPodStreamRequest(NETWORK_CODE, CUSTOM_ASSET_KEY, API_KEY);
SampleAdsWrapper.java

VOD 视频流 Pod Serving

移除了曾用于在构建各种流类型之间切换的方法 buildStreamRequest()。然后，修改 requestAndPlayAds() 以调用 ImaSdkFactory.createPodVodStreamRequest() 来创建 VOD Pod Serving 广告请求。

// VOD pod stream request.
request = sdkFactory.createPodVodStreamRequest(NETWORK_CODE);
SampleAdsWrapper.java

创建视频流请求实例后，使用 AdsLoader.requestStream() 请求视频流：

request.setFormat(STREAM_FORMAT);
adsLoader.requestStream(request);
SampleAdsWrapper.java

修改和设置直播网址

直播广告插播

调用 StreamManager.getStreamId() 方法以获取媒体资源 ID。这需要插入到 STEAM_URL 中，以替换 "[[STREAMID]]"。做出此更改后，使用 videoPlayer.setStreamUrl() 方法设置新的流网址，然后调用 videoPlayer.play() 方法开始播放流。

// Play the live pod stream.
streamID = streamManager.getStreamId();
String liveStreamUrl = STREAM_URL.replace("[[STREAMID]]", streamID);
// Call videoPlayer.play() here, because IMA doesn't call the VideoStreamPlayer.loadUrl()
// function for livestreams.
videoPlayer.setStreamUrl(liveStreamUrl);
videoPlayer.play();
SampleAdsWrapper.java

VOD 视频流 Pod Serving

1. 调用 StreamManager.getStreamId() 方法以获取媒体资源 ID。
2. 向视频技术合作伙伴 (VTP) 请求直播网址。
3. 从 VTP 收到网址后，请使用该网址调用 StreamManager.loadThirdPartyStream() 方法来加载视频流，以及 VTP 返回的任何字幕。

// Play the VOD pod stream.
streamID = streamManager.getStreamId();
String vodStreamUrl = "";
// Refer to your Video Tech Partner (VTP) or video stitching guide to fetch the stream URL
// and the subtitles for a the ad stitched VOD stream.

// In the following commented out code, 'vtpInterface' is a place holder
// for your own video technology partner (VTP) API calls.
// vodStreamUrl = vtpInterface.requestStreamURL(streamID);
List<Map<String, String>> subtitles = new ArrayList<>();
streamManager.loadThirdPartyStream(vodStreamUrl, subtitles);
SampleAdsWrapper.java

对于 VOD Pod 投放请求，IMA 会在视频流加载完毕后调用 VideoStreamPlayer.loadUrl() 回调。如需开始播放直播，请将 videoPlayer.setStreamUrl() 和 videoPlayer.play() 调用添加到 VideoStreamPlayer.loadUrl() 回调中：

private VideoStreamPlayer createVideoStreamPlayer() {
  return new VideoStreamPlayer() {
    @Override
    public void loadUrl(String url, List<HashMap<String, String>> subtitles) {
      // IMA doesn't make calls to VideoStreamPlayer.loadUrl() for pod serving live streams.
      // The following code is for VOD streams.
      videoPlayer.setStreamUrl(url);
      videoPlayer.play();
    }
SampleAdsWrapper.java

清理 IMA DAI 资产

当您使用 IMA DAI SDK 成功完成在 Pod Serving 视频流中请求和展示广告后，建议您在 Pod Serving 会话结束后清理所有资源。调用 StreamManager.destroy() 可停止视频流播放、停止所有广告跟踪并释放所有已加载的视频流素材资源。

如需查看 Android SDK 的其他使用示例，请参阅 GitHub 上的示例。