Google IMA tvOS SDK 发布历史记录

版本 发布日期 备注
4.18.1 2026-10-22
  • 添加 IMASettings.preloadTime 属性，以设置在广告插播时间点开始时间之前开始加载中贴片广告插播时间点的时间。如果未设置，则预加载时间默认为 8 秒。
  • 添加了 IMAAdsRenderingSettings.prerollLoadVideoTimeout 属性，用于设置在取消广告播放并播放内容之前，等待前贴片广告加载的秒数。
  • 修复了在 tvOS VoiceOver 处于开启状态时用户无法跳过广告的问题。
4.17.0 2026-05-29
  • 添加了对启用了 HLS 插页式广告的直播的可跳过广告的支持。
  • 添加了编译时检查，以验证应用的目标 tvOS 版本是否与 IMA SDK 的最低 tvOS 版本兼容。
  • 向 IMAAdError 枚举添加了错误代码：
    • kIMAError_ASSET_FALLBACK_FAILED：1021
    • kIMAError_UNSUPPORTED_URL：1022
    • kIMAError_STREAM_INITIALIZATION_TIMEOUT： 1023
    • kIMAError_STREAM_AUTHORIZATION_FAILED： 1024
  • 更新 IMASettings.featureFlags() 方法，以接受任何对象类型作为值。
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 会话销毁不当时发生内存泄漏的问题。
  • 在 VOD 连播广告投放视频流中添加了对可跳过广告的支持。
  • 修复了视频嵌入到可滚动容器中时滚动支持方面存在的 bug。
  • 为非线性广告添加了对 minSuggestedDuration 的支持
  • 修复了会导致某些 Campaign Manager 跟踪网址编码不正确的 bug。
  • 修复了导致在某些广告会话中无法分派 STARTED 事件的问题。
4.13.0 2024-06-13
  • 向 IMAVideoStitcherVODStreamRequest 添加了 VODConfigID。
  • 修复了 IMAAdsRequest 中 adTagURL 为 null 时出现的 nullpointerexception。
  • 更改了素材资源级后备逻辑，以遍历原始 VAST 中的所有广告，直到 SDK 识别出可播放的广告素材。如果未找到可播放的广告素材，则不会播放广告。
  • 修复了未触发对 ad.doubleclick.net 的跟踪 ping 的问题。
  • 根据视图框架（而非 playerView 的安全区域布局指南）设置 SDK 的广告尺寸呈现限制。
4.12.0 2024-04-03
4.11.1 2024-02-22
  • 修复了在广告播放期间可以听到内容音频的问题。
4.10.0 2024-01-24
  • 启用 Pod 投放 VOD 视频流请求。
  • 更新 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。
  • 修复了导致不必要的“内部消息无效”警告的 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 上导致警告消息的问题。
  • IMA iOS SDK 的最后一个支持 tvOS 10 的版本。
4.4.1 2021-03-09
  • 添加了 IMASettings.sessionID 属性，以便发布商手动设置其 sessionID。
  • 添加了对画中画的支持。
  • 修复了广告暂停和恢复事件有时会在内容播放期间触发的问题。
  • 添加了 IMAVideoDisplay.nowPlayingSession，以便在 tvOS 14 及更高版本上正确支持播放/暂停事件。
  • 修复了以下 bug：AdSense 线性广告被作为非线性广告报告给发布商。
  • 修复了 IMAStreamManager.replaceAdTagParameters 不会发出更新的问题。
  • 添加了广告连播投放 API。
  • 强制将 adContainer 附加到窗口。
4.3.2 2020-08-11
4.3.1 2020-08-05
  • 新增了对 Google 的额外同意模式的支持。如需了解详情，请参阅 Google 的额外同意模式技术规范。
  • 添加了对直播字幕的“language_name”键的支持。
  • 修复了导致纯音频广告超时的问题。
  • 修复了以下问题：跳过前贴片广告中的第一个广告会导致第二个广告忽略其自身的可跳过前的播放时长。
  • 添加了 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”。
  • 添加了 authToken API（IMAStreamRequest）。
4.0.1（已弃用） 2019-07-02
  • 合并了客户端和 DAI tvOS SDK
  • 修复了以下问题：在 tvOS 上，AdsList 未被解析并抛出 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 包含大括号（“{”或“}”）的跟踪网址的问题。
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
  • 初始版本。