Google IMA tvOS SDK 发布历史记录

版本 发行日期 备注
4.16.0 2025-10-23
  • 将编译所需的最低 tvOS 版本提高到 tvOS 15。
  • 添加了 useHLSInterstitial 参数，以针对 IMALiveStreamRequest 和 IMAVODStreamRequest 接口启用插页式支持。
4.15.1 2025-05-07
  • 向 AD_PERIOD_STARTED 事件添加了广告时段信息，您可以从 IMAAdEvent.adData 属性访问该信息。
  • 添加了对使用 IMA SDK 处理 HLS 插播广告元数据的支持。
4.14.1 2024-12-03
  • 为所有流类型的流请求参数列表添加了广告资源网代码 。
  • 点击无效的点击后到达网址时，系统会触发 LOG 事件， 而不是静默失败。
  • 修复了 OMID 会话被不当销毁时发生的内存泄漏问题。
  • 添加了对视频点播广告连播流中可跳过广告的支持。
  • 修复了视频嵌入到可滚动容器中时滚动支持方面的 bug。
  • 添加了对非线性广告的 minSuggestedDuration 支持
  • 修复了会导致某些 Campaign Manager 跟踪网址被 错误编码的 bug。
  • 修复了导致 STARTED 事件无法在某些广告会话中分派的问题。
4.13.0 2024-06-13
  • 向 IMAVideoStitcherVODStreamRequest 添加了 VODConfigID。
  • 修复了 IMAAdsRequest 中 adTagURL 为 null 时出现的 nullpointerexception。
  • 更改了 素材资源级后备 逻辑，以遍历原始 VAST 中的所有广告，直到 SDK 识别出可播放的广告素材。如果找不到可播放的广告素材， 则不会播放广告。
  • 修复了向 ad.doubleclick.net 发送跟踪 ping 信号失败的问题。
  • 将 SDK 的广告尺寸呈现限制设置为基于视图框架 而不是基于 playerView 的安全区域布局指南。
4.12.0 2024-04-03
4.11.1 2024-02-22
  • 修复了在广告播放期间可能会听到内容音频的问题。
4.10.0 2024-01-24
  • 启用了 Pod Serving 视频点播流请求。
  • 更新了 AdUI 的限制，以遵循安全区域指南。
  • 为 iOS/tvOS 流管理器添加了提示点的 getter
4.9.2 2023-08-15
  • 修复了导致某些 DAI 流的 CPU 使用率过高的 bug。
4.9.1 2023-04-20
4.8.2 2022-11-03
  • 向 IMA 流请求添加了 userContext。
  • 修复了导致出现不必要的“Invalid internal message”警告的 bug。
4.7.0 2022-07-20
  • 修复了发布商覆盖 IMA SDK 版本信息的问题。
  • 添加了 AD_CAN_PLAY 事件。在广告准备好播放且无需缓冲时触发。
  • 将非移动设备的最大默认比特率提高到无限制。
4.6.1 2022-02-23
  • 服务版本；没有公开的更改。
4.5.0 2021-12-06
  • 将最低 tvOS 版本提高到 tvOS 12。
  • 修复了可能导致出现多个“为什么会看到此广告”图标的 bug。
  • 移除了对 MPNowPlayingSession 的需求。
4.4.2 2021-05-03
  • 修复了导致 tvOS < 12 上出现警告消息的问题。
  • 这是支持 tvOS 10 的最后一个 IMA SDK for iOS 版本。
4.4.1 2021-03-09
  • 添加了 IMASettings.sessionID 属性，以允许发布商手动设置其 sessionID。
  • 添加了对画中画 (PiP) 的支持。
  • 修复了广告暂停和恢复事件有时会在内容播放期间触发的问题。
  • 添加了 IMAVideoDisplay.nowPlayingSession，以正确支持 tvOS 14+ 上的播放/暂停事件。
  • 修复了将 AdSense 线性广告报告给发布商时显示为非线性的 bug。
  • 修复了 IMAStreamManager.replaceAdTagParameters 不会发出更新的问题。
  • 添加了广告连播服务 API。
  • 强制将 adContainer 附加到窗口。
4.3.2 2020-08-11
4.3.1 2020-08-05
  • 添加了对 Google 的“更多意见征求方式”的支持。如需了解详情，请参阅 Google 的“额外同意模式”技术规范。
  • 添加了对流字幕的“language_name”键的支持。
  • 修复了导致纯音频广告超时的 bug。
  • 修复了跳过片前广告中的第一个广告会导致第二个广告忽略其自身的可跳过前的播放时长的问题。
  • 添加了 IMAAdDisplayContainer.focusEnvironment，允许 发布商在广告插播期间将焦点转移到 SDK。每当用户需要与广告界面互动（例如可跳过的广告、VAST 图标）时，都需要执行此操作。
  • 将 viewController 添加为 IMAAdDisplayContainer 的新必需初始化实参或属性。
  • 修复了非英语本地化支持。
  • 减少了错误的 RESUME 事件。
  • 添加了 IMAAdsRenderingSettings.enablePreloading，该属性默认处于 启用状态，用于提升广告呈现效果。
  • 添加了对可跳过广告（客户端和 VOD）和 VAST 图标 （客户端和 DAI）的支持
  • 添加了 ICON_FALLBACK_IMAGE_CLOSED 和 ICON_TAPPED 事件。我们建议在 ICON_FALLBACK_IMAGE_CLOSED 上自动恢复，因为 SDK 会在后备 图片打开时暂停。
  • 修复了仅当 IABTCF_gdprApplies 为字符串时才会被 确认的问题。
4.2.3 2020-05-06
  • 修复了某些应用软件包 ID 可能会导致流量被错误分类的问题。
4.2.2 2020-03-26
  • 将最低运行时版本提高到 tvOS 10
  • 修复了某些界面更新可能会在后台线程上触发的 bug
  • 修复了严格标志会导致 IMACompanionAd 的 init 与 NSObject 的 init 冲突的问题
  • 弃用了 IMAVideoDisplay 协议中的 loadURL 方法
4.2.1 2020-02-12
  • 4.2.1 将是支持 tvOS 9.x 的最后一个 IMA SDK 版本
  • 修复了点击后到达网址在 tvOS 9.x 上崩溃的问题
4.2.0 2019-10-30
  • 修复了 tvOS 13 上间歇性崩溃的问题。
4.1.0 2019-09-23
  • 添加了对 tvOS 13 的支持。
  • 为 DAI 添加了 playerVideoDisplay:didLoadPlayerItem:。
  • 为 DAI 广告添加了 IMAAd.companionAds 和 IMACompanionAd 。
  • 更新了 IMAAVPlayerVideoDisplayDelegate 名称，以更好地 符合 Objective-C 样式。
4.0.5 2019-08-16
  • 修复了 Apple TV 遥控器上的播放按钮无法恢复内容的问题。
4.0.2 2019-07-18
  • 修复了用户“限制广告跟踪”设置被 错误传输的问题。
  • IMAAdEventType.adData 现在已输入。
  • 在 IMAStreamRequest 上添加了 authToken API。
4.0.1 已弃用 2019-07-02
  • 合并了客户端和 DAI tvOS SDK
  • 修复了 AdsLists 未被解析并在 tvOS 上抛出 AdsLoader 错误的问题。

显示早期版本

版本 发行日期 备注
3.9.1 2019-03-28
  • 将默认流初始化超时时间从 5 秒更改为 8 秒。
  • 向 IMAStreamRequest 添加了 initializationTimeout 属性，以启用流初始化超时的配置。
3.9.0 2019-03-06
  • 向 IMAStreamManagerDelegate 添加了 adPeriodDidStart 和 adPeriodDidEnd 回调。
3.8.1 2018-12-06
  • 为防止重复记录指标，当重新观看/搜索广告时，AD_BREAK_STARTED/AD_BREAK_ENDED 等广告事件不再触发。
3.8.0 2018-05-21
  • 添加了对 npa 广告代码参数的支持。
3.7.1 2018-02-26
  • 修复了在 tvOS 11.2.6 上，包含大括号（“{”或“}”）的跟踪网址未被 ping 的 bug。
3.7.0 2018-01-24
  • 将以下内容添加为 IMAStreamRequest.adTagParameters 键的可接受值：
    • 音频范围 (dai-aor)
    • 排除 (dai-excl)
    • 订单开始 (dai-os)
    • 视频范围 (dai-sr)
  • 向 IMAAd 添加了以下内容：advertiserName、creativeID、creativeAdID、dealID、universalAdIDRegistry、universalAdIDValue、wrapperAdIDs、wrapperAdSystems、wrapperCreativeIDs 和 wrapperDealIDs。
  • 现在，当在广告插播时间点期间加入流时，SDK 会触发 AD_BREAK_STARTED，以便监听器可以呈现广告界面。
  • 添加了 IMAAVPlayerVideoDisplayDelegate，以便 IMAAVPlayerVideoDisplay 的用户可以接收要加载的流的 AVAssetURL。借助 AVAssetURL 对象，用户可以注册 FairPlay 内容保护播放。
3.6.0 2017-09-19
  • 移除了非功能性 IMAStreamRequest.attemptPreroll。
  • 将以下内容添加为可接受的 IMAStreamRequest.adTagParameters：
    • dai-ah（暂停显示广告）
    • dai-dlid（送货地点）
  • 添加了 IMAStreamRequest.streamActivityMonitorID。
  • 修复了对于未播放或加载的流，[IMAStreamManagerDelegate streamManager:didReceiveError:] 未被调用的问题。
3.5.0 2017-04-24
  • 添加了 IMAAd.companions。
  • 添加了 IMACompanion 类。
3.4.1 2017-03-31
  • 服务版本，没有新功能。
3.4.0 2017-03-13
  • 修复了位码支持。
  • 向 AdBreakInfo 添加了以下属性：
    • adBreakIndex
    • timeOffset
3.3.0 2016-12-05
  • 公开了 [IMAAVPlayerVideoDisplay reset]，以便在需要将内容播放器上的 AVPlayerItem 替换为备份 AVPlayerItem 时调用。
3.2.0 2016-08-22
  • 修复了提交使用该框架进行测试的应用时出现的问题。
3.1.0 2016-05-09
  • 初始版本。