此页面由 Cloud Translation API 翻译。

开始使用 IMA DAI SDK

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

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

广告连播投放 DAI

本指南将演示如何使用结合使用 IMA DAI SDK for iOS 与简单的视频播放器。如果您想关注以及完整的示例，请下载广告连播投放示例

IMA DAI Pod Serving 概览

使用适用于 iOS 的 IMA DAI SDK 实现广告连播投放涉及到两个主要组件：

StreamRequest：一个对象，用于定义流请求与 Google 的广告服务器通信必须使用 IMAPodStreamRequest 或 IMAPodVODStreamRequest 来启用 Pod 传送这两种方法都需要网络代码和 IMAPodStreamRequest 还需要一个自定义资产键。API 密钥是可选属性。
IMAStreamManager：用于处理视频流和 IMA DAI SDK（例如，触发跟踪 ping 和将视频流事件转发给发布商。

前提条件

在开始之前，您需要做好以下准备：

Xcode 13 或更高版本。
CocoaPods（首选）、Swift Package Manager 或下载了适用于 iOS 的 IMA DAI SDK。
已设置 IMA DAI SDK 的 iOS 应用可通过 DAI 广告。如果您还没有此类应用程序，我们建议您使用 iOS DAI BasicExample 的形式起点BasicExample 中包含这个指南。如需详细了解如何实施 IMA DAI SDK，请参阅快速入门指南。

设置 Pod 服务变量

Pod 传送所需的所有更改都在 ViewController.swift 中完成： swift 或 ViewController.m（在 Objective-C 中）。本指南中的代码段默认使用 Swift 语言。第一步是更新常量变量。

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

STREAM_URL（仅用于直播）：由您的清单操纵器或使用 Pod 传送的第三方合作伙伴。它应该您需要先插入 IMA DAI SDK 提供的视频流 ID，然后才能发出请求。在这个示例中，视频流网址包含一个占位符 "[[STREAMID]]"（将替换为数据流 ID），然后再执行请求。
NETWORK_CODE：您的 Ad Manager 360 账号的广告资源网代码。
CUSTOM_ASSET_KEY（仅用于直播）：自定义素材资源键，用于在 Ad Manager 360 中标识广告连播投放事件这可以通过您的清单操纵器或第三方 Pod 投放合作伙伴。
API_KEY（仅用于直播）：可选的 API 密钥，从 IMA DAI SDK 检索视频流 ID 所需的参数。

更改示例的变量部分以匹配以下内容：

...
class ViewController:
  UIViewController,
  IMAAdsLoaderDelegate,
  IMAStreamManagerDelegate,
  AVPlayerViewControllerDelegate
{
  static let streamUrl =
    "https://encodersim.sandbox.google.com/masterPlaylist/9c654d63-5373-4673-8c8d-6d92b66b9d46/master.m3u8?gen-seg-redirect=true&network=51636543&event=google-sample&pids=devrel4628000,devrel896000,devrel3528000,devrel1428000,devrel2628000,devrel1928000&seg-host=dai.google.com&stream_id=[[STREAMID]]"
  static let networkCode = "51636543"
  static let customAssetKey = "google-sample"
  static let APIKey = ""
  static let backupStreamURLString =
    "http://googleimadev-vh.akamaihd.net/i/big_buck_bunny/bbb-,480p,720p,1080p,.mov.csmil/master.m3u8"

  var adsLoader: IMAAdsLoader?
  ...

创建直播或 VOD 广告连播视频流请求

直播广告连播投放

修改 requestStream 方法以通过以下方法创建实时 Pod 流请求：正在实例化 IMAPodStreamRequest。

  ...

  func requestStream() {
    guard let playerViewController = self.playerViewController else return
    guard let adContainerView = self.adContainerView else return
    guard let adsLoader = self.adsLoader else return

    self.videoDisplay = IMAAVPlayerVideoDisplay(avPlayer: playerViewController.player)
    adDisplayContainer = IMAAdDisplayContainer(
      adContainer: adContainerView, viewController: self)

    // Create a podserving stream request.
    request = IMAPodStreamRequest(
      networkCode: self.networkCode,
      customAssetKey: self.customAssetKey,
      adDisplayContainer: adDisplayContainer,
      videoDisplay: self.videoDisplay,
      userContext: nil)

    adsLoader.requestStream(with: request)
  }

  ...

VOD 视频流广告连播投放

修改 requestStream 方法以通过以下方法创建 VOD Pod 流请求：正在实例化 IMAPodVODStreamRequest。

  ...

  func requestStream() {
    guard let playerViewController = self.playerViewController else return
    guard let adContainerView = self.adContainerView else return
    guard let adsLoader = self.adsLoader else return

    self.videoDisplay = IMAAVPlayerVideoDisplay(avPlayer: playerViewController.player)
    adDisplayContainer = IMAAdDisplayContainer(
      adContainer: adContainerView, viewController: self)

    // Create a podserving stream request.
    request = IMAPodVODStreamRequest(
      networkCode: self.networkCode,
      adDisplayContainer: adDisplayContainer,
      videoDisplay: self.videoDisplay,
      userContext: nil)

    adsLoader.requestStream(with: request)
  }

  ...

修改并设置直播网址

直播广告连播投放

使用 streamManager.streamId 修改 IMAAdsLoaderDelegate 方法，获取数据流 ID。然后将数据流 ID 插入 STREAM_URL，将 "[[STREAMID]]"。更改完成后，即可创建新的直播网址使用 videoDisplay.loadStream() 进行设置。

  ...

  // MARK: - IMAAdsLoaderDelegate

  func adsLoader(_ loader: IMAAdsLoader!, adsLoadedWith adsLoadedData: IMAAdsLoadedData!) {
    let streamManager = adsLoadedData.streamManager
    let streamId = streamManager.streamId
    let urlString = streamUrl.replacingOccurrences(of: "[[STREAMID]]", with: streamId)
    let loadedStreamUrl = URL(string:urlString)
    self.videoDisplay.loadStream(loadedStreamUrl, subtitles:@[])
    self.videoDisplay.play()
    streamManager.delegate = self
    streamManager.initialize(with: nil)
    self.streamManager = streamManager
  }

  ...

VOD 视频流广告连播投放

使用 streamManager.streamId 修改 IMAAdsLoaderDelegate 方法，获取数据流 ID。然后，通过你的视频技术请求直播网址合作伙伴 (VTP)。然后调用 IMAStreamManager.loadThirdPartyStream() 以获取 IMA 加载直播网址和 TVP 返回的所有字幕。

  ...

  // MARK: - IMAAdsLoaderDelegate

  func adsLoader(_ loader: IMAAdsLoader!, adsLoadedWith adsLoadedData: IMAAdsLoadedData!) {
    let streamManager = adsLoadedData.streamManager
    let streamId = streamManager.streamId
    // 'vtpInterface' is a place holder for your own video technology partner
    // (VTP) API calls.
    let streamUrl = vtpInterface.requestStreamURL(streamID)
    self.streamManager.loadThirdPartyStream(streamUrl, streamSubtitles:@[])
    streamManager.delegate = self
    streamManager.initialize(with: nil)
    self.streamManager = streamManager
  }

大功告成！现在，您正在使用 IMA DAI SDK for iOS要查看正在使用的 IMA DAI SDK 的其他示例，请参阅 GitHub 上的示例。