版本
发布日期
备注
3.34.1
2026-10-19
3.33.0
2026-08-24
服务版本。没有新功能。
IMA SDK 3.32.0 版将于 2027 年 8 月 24 日弃用。如需了解详情,请参阅弃用时间表 。
3.32.0
2026-05-29
添加了对启用了 HLS 插页式广告的直播的可跳过广告的支持。
添加编译时检查,以验证应用的目标 iOS 版本是否与 IMA SDK 的最低 iOS 版本兼容。
向 IMAAdError 枚举添加了错误代码:
kIMAError_ASSET_FALLBACK_FAILED:1021
kIMAError_UNSUPPORTED_URL:1022
kIMAError_STREAM_INITIALIZATION_TIMEOUT:
1023
kIMAError_STREAM_AUTHORIZATION_FAILED:
1024
SDK 版本 3.31.0 将于 2027 年 5 月 29 日弃用。如需了解详情,请参阅弃用时间表 。
3.31.0
2026-04-15
修复了 3.30.0 版中引入的一个问题,该问题导致 IMA SDK 停止支持低于 17 的最低 iOS 版本。此版本支持最低版本 15。
修复了在 iOS 版本 26 上可见度被错误地衡量为 0% 的问题。
添加了对 Open Measurement SDK v1.6 的支持。
更新 IMASettings.featureFlags() 以接受任何对象类型作为值。
3.30.1(已弃用)
2026-03-25
注意 :此版本将 iOS 最低版本提高到了 17。
由于内部变更,所需的最低 iOS 版本有所提高。CocoaPods podspec 和 Swift Package Manager 错误地指明支持 iOS 15。IMA SDK 3.31.0 版恢复支持 iOS 15。
修复了 v3.30.0 中引入的一个问题,即 xcframework 文件权限不正确,导致 Swift Package Manager 用户遇到以下错误:
Error Domain=NSCocoaErrorDomain Code=513
"couldn't be removed because you don't have permission to access it."
3.30.0(已弃用)
2026-03-13
注意 :此版本将 iOS 最低版本提高到了 17。
由于内部变更,所需的最低 iOS 版本有所提高。CocoaPods podspec 和 Swift Package Manager 错误地指明支持 iOS 15。IMA SDK 3.31.0 版恢复支持 iOS 15。
为 WKWebView 设置添加了一项实验性功能。默认情况下,此实验性功能处于停用状态。如需启用,请使用 IMASettings.featureFlags 设置。这可以提升搭载 iOS 17 或更高版本的设备的性能。
修复了在与 Google Cast iOS SDK 相同的目标中使用该 SDK 时发生的运行时崩溃问题。
修复了 IMAAVPlayerVideoDisplay 中的一个问题:resignFirstResponder 可能会在后台线程上调用,以防止出现 UIKit“主线程检查器”警告。
SDK 版本 3.28.10 将于 2027 年 3 月 13 日弃用。如需了解详情,请参阅弃用时间表 。
3.28.10
2025-10-22
通过在视频流请求中引入 useHLSInterstitial 字段,为服务器导向型广告插播 (SDAI) 直播和 VOD 视频流启用插页式广告支持。
改进了随播广告的内存管理,以防止应用销毁 adsManager 对象时发生内存泄漏。
将 iOS 最低版本提高到了 15。
SDK 版本 3.27.4 将于 2026 年 10 月 22 日弃用。如需了解详情,请参阅弃用时间表 。
3.27.4
2025-08-28
修复了 IMARemoteControl 类创建问题,使其仅在播放器开始播放时发生。
SDK 版本 3.26.1 将于 2026 年 8 月 28 日弃用。如需了解详情,请参阅弃用时间表 。
3.26.1
2025-04-02
将广告时段信息添加到 AD_PERIOD_STARTED 事件中,您可以通过 IMAAdEvent.adData 属性访问该事件。
添加了对使用 IMA SDK 处理 HLS 插播广告元数据的支持。
SDK 版本 3.24.0 将于 2026 年 4 月 2 日弃用。如需了解详情,请参阅弃用时间表 。
3.24.0
2024-12-03
为所有直播类型将广告资源网代码 添加到直播请求参数列表中。
在点击无效的点击型网址时触发 LOG 事件,而不是静默失败。
修复了 OMID 会话未正确销毁时发生内存泄漏的问题。
新增了对 VOD 连播广告投放视频流中可跳过广告的支持。
修复了视频嵌入到可滚动容器中时滚动支持方面存在的 bug。
为非线性广告添加了对 minSuggestedDuration 的支持
修复了在某些情况下导致 Campaign Manager 跟踪网址编码不正确的问题。
SDK 版本 3.23.0 将于 2025 年 12 月 3 日弃用。如需了解详情,请参阅弃用时间表 。
3.23.0
2024-06-12
3.22.1
2024-04-12
修复了最新 Cocoapods 版本中导致应用无法在 iOS 模拟器上构建的问题。
SDK 版本 3.22.0 将于 2025 年 4 月 12 日弃用。如需了解详情,请参阅弃用时间表 。
3.22.0
2024-04-03
3.20.0
2024-01-28
为广告连播投放启用随播广告支持
启用 Pod 投放 VOD 视频流请求。
向直播管理器添加了提示点的 getter。
SDK 版本 3.19.2 将于 2025 年 1 月 28 日弃用。如需了解详情,请参阅弃用时间表 。
3.19.2
2023-04-28
将编译所需的最低 iOS 版本降至 iOS 12。
SDK 版本 3.19.1 将于 2024 年 4 月 28 日弃用。如需了解详情,请参阅弃用时间表 。
3.19.1
2023-04-20
3.18.5
2023-03-10
3.18.4
2022-12-08
服务版本。没有新功能。
SDK 版本 3.18.2 将于 2023 年 12 月 8 日弃用。如需了解详情,请参阅弃用时间表 。
3.18.2
2022-11-07
将 user_context 添加到直播请求。
修复了错误的“内部消息无效”警告。
SDK 版本 3.18.1 将于 2023 年 11 月 7 日弃用。如需了解详情,请参阅弃用时间表 。
3.18.1
2022-10-02
修复了导致 SDK 崩溃并显示 UIViewControllerHierarchyInconsistency 的问题
SDK 3.17.0 版将于 2023 年 10 月 2 日弃用。如需了解详情,请参阅弃用时间表 。
3.17.0
2022-08-03
如果发布商未设置最大比特率,则提高非移动设备的默认最大比特率。
SDK 版本 3.16.3 将于 2023 年 8 月 3 日弃用。如需了解详情,请参阅弃用时间表 。
3.16.3
2022-04-19
3.15.1
2022-02-23
将 iOS 最低版本提高到了 12
SDK 版本 3.14.5 将于 2023 年 2 月 23 日弃用。如需了解详情,请参阅弃用时间表 。
3.14.5
2021-10-05
添加了
IMASettings:sameAppKeyEnabled
API,该 API 可以利用从您的应用中收集的数据,帮助您投放更具相关性、个性化程度更高的广告。该 API 目前默认处于启用状态,发布商无需进行任何更改。
向所有 API 添加了可为 null 性协定。
SDK 版本 3.14.4 将于 2022 年 10 月 5 日弃用。如需了解详情,请参阅弃用时间表 。
3.14.4
2021-07-06
修复了应用在后台运行时导致事件丢失的问题。
修复了允许发布商在 iOS <14 上手动设置 islat 的问题。
将 iOS 最低版本提高到 iOS 11
SDK 3.14.3 版将于 2022 年 7 月 6 日弃用。如需了解详情,请参阅弃用时间表 。
3.14.3
2021-05-03
修复了导致在 iOS < 12 上显示警告消息的问题。
添加了
IMASettings:sessionid
,以便发布商自定义会话 ID。
修复了广告暂停和恢复事件会在内容播放期间触发的问题。
确保广告界面内容边衬区不会自动调整
IMA iOS SDK 的最后一个支持 iOS 10 的版本。
SDK 版本 3.14.1 将于 2022 年 5 月 3 日弃用。如需了解详情,请参阅弃用时间表 。
3.14.1
2021-02-17
修复了启用预加载功能后有时会触发重复广告事件的问题。
实现了 PodServing 支持。
修复了在 iOS 13 及更高版本上打开双重深层链接的问题。
SDK 3.13.0 版将于 2022 年 2 月 17 日弃用。如需了解详情,请参阅弃用时间表 。
3.13.0
2020-10-13
此 SDK 现在使用 Xcode 12 构建。
修复了在广告插播时间点之外跳转不会触发 AD_BREAK_ENDED 事件的问题。
移除了 IMAAVPlayerVideoDisplay、IMAVideoDisplay 和 IMAVideoDisplayDelegate 中已弃用的字段。
修复了每次广告播放完毕后画中画都会最小化的问题。
修复了以下 bug:直播在通过 AirPlay 播放后会立即结束播放。
修复了在共享播放时按“跳过”没有任何效果的问题。
修复了以下问题:在共享播放中,广告连播中的广告之间会短暂闪烁内容。
添加了 IMAAVPlayerVideoDisplay.streamAssetOptions API。
广告曝光时段时长(以IMAStreamManagerDelegate为单位)。
修复了错误地触发 "Ads cannot be requested because the ad container
is not attached to the view hierarchy." 错误的问题。
SDK 3.12.1 版将于 2021 年 10 月 13 日弃用。如需了解详情,请参阅弃用时间表 。
3.12.1
2020-08-11
iOS 14 的官方发布版本。
修复了打开点击链接然后关闭应用会导致内存泄漏的问题。
SDK 3.12.0 版将于 2021 年 8 月 11 日弃用。如需了解详情,请参阅弃用时间表 。
3.12.0
2020-08-05
添加了对 Google 额外同意模式的支持。如需了解详情,请参阅 Google 的额外同意模式技术规范 。
添加了对直播字幕的“language_name”键的支持。
修复了导致纯音频广告超时的问题。
修复了以下问题:跳过前贴片广告中的第一个广告会导致第二个广告忽略其自身的可跳过前的播放时长。
将 viewController 添加为 IMAAdDisplayContainer 的新必需初始化参数或属性。
减少错误的 RESUME 事件。
添加了 IMAAdsRenderingSettings.enablePreloading(默认处于启用状态),以提升广告呈现性能。
添加 ICON_TAPPED 事件。
修复了仅当 IABTCF_gdprApplies 为字符串时才会被确认的问题。
SDK 3.11.4 版将于 2021 年 8 月 5 日弃用。如需了解详情,请参阅弃用时间表 。
3.11.4
2020-03-26
将最低运行时版本提高到 iOS 10
修复了某些界面更新可能会在后台线程上触发的 bug
修复了严格标志会导致 IMACompanionAd 的 init 与 NSObject 的 init 冲突的问题
弃用了 IMAVideoDisplay 协议中的 loadURL 方法
增加了对
客户端 SIMID 广告
的支持
SDK 版本 3.11.3 将于 2021 年 3 月 26 日弃用。如需了解详情,请参阅弃用时间表 。
3.11.3
2020-02-12
3.11.3 将是支持 iOS 9.x 的最后一个 IMA SDK 版本
修复了导入框架标头时未导入 IMAFriendlyObstruction.h 的 bug
修复了在 iOS 9.x 上点击广告会发生崩溃的问题
SDK 版本 3.11.2 将于 2021 年 2 月 12 日弃用。如需了解详情,请参阅弃用时间表 。
3.11.2
2020-01-22
3.11.1
2019-12-04
添加了对自动包含 IAB TCFv2 和 CCPA 中的意见征求参数的支持。
修复了使用控制中心时导致崩溃的问题。
添加了对 TrueView 行动号召广告的支持。
为 DAI 添加了 playerVideoDisplay:didLoadPlayerItem:。
更新了 IMAAVPlayerVideoDisplayDelegate 名称,以便与 Obj-C 样式规范保持一致。
修复了在某些情况下导致 LOG 和 INTERACTION 广告事件无法包含广告对象的问题。
为符合 IAB TCFv2 的意见征求管理平台(例如 Google 的资助选项)的实现添加了 Google 广告请求的自动集成。
修复了 VMAP breakstart 和 breakend 跟踪事件的问题。
向 IMAStreamManager 添加了 replaceAdTagParameters 方法,该方法可让您在直播期间替换所有广告代码参数。
添加 AD_BREAK_FETCH_ERROR 事件,以指明广告插播时间点不会播放。
SDK 3.10.1 版将于 2020 年 12 月 4 日弃用。如需了解详情,请参阅弃用时间表 。
3.10.1
2019-09-19
添加了对 iOS 13 和 iPadOS 的支持。
SDK 版本 3.9.2 将于 2020 年 9 月 19 日弃用。如需了解详情,请参阅弃用时间表 。
3.9.2
2019-08-16
此版本修复了以下问题:广告播放完毕后,清晰的 IMA 广告界面视图仍会保留,导致用户无法与播放器互动。
SDK 3.9.1 版将于 2020 年 8 月 16 日弃用。如需了解详情,请参阅弃用时间表 。
3.9.1
2019-07-18
修复了 is_lat 报告准确性方面的问题。
现已输入“IMAAdEventType.adData”。
向 IMAStreamRequest 添加了 authToken 和 streamFormat API。
从 LinearAd 中移除了 mediaUrl 支持。请改用 adMedia。
修复了不公开列出的视频的 YouTube 元数据 bug。
修复了广告 ID 识别不正确的问题。
将 mediaWidth 和 mediaHeight 替换为了 adMedia.width 和 adMedia.height。
修复了随播广告只会呈现一次的问题。
现在,如果不支持某种视频广告类型,SDK 将抛出错误 kIMAError_VAST_TRAFFICKING_ERROR,而不是 kIMAError_FAILED_TO_REQUEST_ADS。
videoDisplayDidPlay: 现已废弃,取而代之的是 videoDisplayDidResume:。
SDK 3.9.0 版将于 2020 年 7 月 18 日弃用。如需了解详情,请参阅弃用时间表 。
3.9.0
2019-03-22
3.8.2
2019-02-19
添加 AD_PERIOD_STARTED 和 AD_PERIOD_ENDED 事件。这些事件仅适用于 DAI 。
修复了广告视图在启动时播放动画的问题。
修复了直播或 VOD 视频错误未触发的问题。
修复了在 iOS+AirPlay 上内容无法继续播放的问题。
2020 年 2 月 19 日,SDK 3.8.1 版弃用。如需了解详情,请参阅弃用时间表 。
3.8.1
2018-11-13
修复了具有多个广告位尺寸的广告代码解析不正确的问题。
添加了 [IMAVideoDisplay seekStreamToTime],以支持 IMA DAI VOD 视频流中的可跳过广告。
添加了 IMAAdRenderingSettings.loadVideoTimeout。
添加 IMAAd.VASTMediaWidth、IMAAd.VASTMediaHeight 和 IMAAd.VASTMediaBitrate。
由于 build 改进,二进制文件大小缩减了约 15%。
SDK 3.7.3 版将于 2019 年 11 月 13 日弃用。如需了解详情,请参阅弃用时间表 。
3.7.3
2018-08-21
改进了针对格式错误的直播清单的错误处理。
修复了 HTML 随播广告中自定义应用内网址点击的问题。
修复了与背靠背可跳过视频广告相关的问题。
2019 年 8 月 21 日,SDK 3.7.2 版弃用。如需了解详情,请参阅弃用时间表 。
3.7.2
2018-05-15
修复了以下问题:某些随播广告会展开为全屏 WebView。
SDK 3.7.1 版将于 2019 年 5 月 15 日弃用。如需了解详情,请参阅弃用时间表 。
3.7.1
2018-04-30
3.7.0.1
2018-02-12
仅限 Cocoapods 的版本,用于修复 podspec 错误。拉取 3.7.0 的库文件。
3.7.0
2018-01-30
不再支持 iOS 8 及更低版本。
服务版本,无新功能。
2019 年 1 月 30 日,SDK 3.6.1 版弃用。如需了解详情,请参阅弃用时间表 。
3.6.1
2017-10-09
添加了 IMAAdsRequest.liveStreamPrefetchSeconds。
2018 年 10 月 9 日,SDK 3.6.0 版弃用。如需了解详情,请参阅弃用时间表 。
3.6.0
2017-07-24
添加了 IMAAdsRequest.vastLoadTimeout。
添加了 IMAAd.wrapperAdIDs。
添加了 IMAAd.skipTimeOffset。
修复了以下错误:如果用于广告播放的视频视图从视图层次结构中移除并重新添加,SDK 无法检测到该视图。
2018 年 7 月 24 日,SDK 3.5.2 版弃用。如需了解详情,请参阅弃用时间表 。
3.5.2
2017-05-02
移除了从后台返回应用时自动恢复播放的功能。
拨打 [IMAAdsManager resume] 即可继续。
添加了 [IMAAdsRenderingSettings playAdsAfterTime]。
2018 年 5 月 2 日,SDK 3.5.1 版弃用。如需了解详情,请参阅弃用时间表 。
3.5.1
2017-04-03
现在,如果发出广告或直播请求时 IMAAdDisplayContainer 不在视图层次结构中,SDK 将抛出 kIMAError_FAILED_TO_REQUEST_ADS。以前,这些请求会静默失败。
2018 年 4 月 3 日,SDK 3.5.0 版弃用。如需了解详情,请参阅弃用时间表 。
3.5.0
2017-03-24
修复了位码支持方面的问题。
向 IMAAdsRequest 对象添加 adsResponse。
修复了 Swift build 的问题。
2018 年 3 月 24 日,SDK 3.4.2 版弃用。如需了解详情,请参阅弃用时间表 。
3.4.2
2017-03-09
服务版本,无新功能。
2018 年 3 月 9 日,SDK 3.4.1 版弃用。如需了解详情,请参阅弃用时间表 。
3.4.1
2017-02-03
该 SDK 现在作为动态框架分发。因此,我们不再发布单独的 AdMob 版本框架,无论您的实现是否也使用 AdMob,您都可以使用同一版本。
添加了对视频图标的支持。
向 IMAAd 添加了以下新属性:
adSystem
creativeID
creativeAdID
universalAdIdValue
universalAdIdRegistry
advertiserName
surveyURL
dealID
wrapperCreativeIDs
wrapperSystems
向 IMAAdsRequest 添加了以下新属性:
contentDuration
contentKeywords
contentTitle
添加了 [IMAAdsManager setVolume:]。
添加了 [IMACompanionDelegate companionSlotWasClicked]。
添加了 IMASettings.disableNowPlayingInfo。
SDK 版本 3.3.1 将于 2018 年 2 月 3 日弃用。如需了解详情,请参阅弃用时间表 。
回滚到 3.3.1
2016-01-31
由于针对特定设备进行构建时出现问题,因此回滚到了 3.3.1。
3.4.0
2017-01-26
该 SDK 现在作为动态框架分发。因此,我们不再发布单独的 AdMob 版本框架,无论您的实现是否也使用 AdMob,您都可以使用同一版本。
添加了对视频图标的支持。
向 IMAAd 添加了以下新属性:
adSystem
creativeID
creativeAdID
universalAdIdValue
universalAdIdRegistry
advertiserName
surveyURL
dealID
wrapperCreativeIDs
wrapperSystems
向 IMAAdsRequest 添加了以下新属性:
contentDuration
contentKeywords
contentTitle
添加了 [IMAAdsManager setVolume:]。
添加了 [IMACompanionDelegate companionSlotWasClicked]。
添加了 IMASettings.disableNowPlayingInfo。
SDK 3.3.1 版将于 2018 年 1 月 26 日弃用。如需了解详情,请参阅弃用时间表 。
3.3.1
2016-09-16
不再支持 iOS 7 及更低版本。
2017 年 9 月 16 日,SDK 3.2.1 版弃用。如需了解详情,请参阅弃用时间表 。
3.2.1
2016-05-09
3.2.0
2016-04-14
注意:由于存在错误,此版本中的 bitcode 支持功能无法正常运行。
添加了位码支持。
增加了对指向应用商店的点击后到达网址的支持。
3.1.0
2015-12-17
Beta v16
2015-09-04
进行了更新,以与 iOS 9 的应用传输安全 功能兼容。
修复了 IMAAdsLoader 解除分配时发生崩溃的问题。
Beta v15
2015-07-22
通过 IMAAdsManager 委托引入广告缓冲事件。这有助于向播放器添加活动指示器和缓冲条等元素。
公开调试模式。发布商现在可以将 IMASettings enableDebugMode 设置设为 YES,以便在控制台中获取更详细的日志记录。请勿在生产环境中使用此功能,因为它会为广告播放器添加水印。
IMAAdsManager destroy 现在可在所有情况下正确终止广告。
允许重复使用展示容器。
允许发布商从委托方法中销毁 IMA 对象。
IMAAdsManager 现在仅具有对 contentPlayhead 的弱引用(修复了潜在的内存泄漏问题)。现在,您需要保留实现 IMAContentPlayhead 的任何 IMAAVPlayerContentPlayhead 实例或对象作为属性,否则该对象将立即释放。
移除了视频大小调整动画。
移除了不必要的初始恢复广告事件。
Beta v14
2015-05-27
修复了广告播放器偶尔会停止缓冲且无法恢复播放的问题。
将 IMASettings 移至其自己的头文件中。
Beta v13
2015-04-29
添加了对后台广告播放的支持。如需了解详情,请参阅后台广告播放 。
现在,该 SDK 可以作为框架导入。如需详细了解如何升级,请参阅我们关于此版本的博文 。
缩短了 iOS 8 上的广告加载时间。
修复了随播广告在广告结束后消失的问题。现在,随播广告会一直展示,直到广告位刷新。
为 SDK 加载添加了 10 秒超时。
IMASettings 现在会实现 NSCopying。
修复了耳机拔出时应用会崩溃的问题。
现在,当设备默认静音时,广告也会静音。发布商可以通过设置 AVAudioSession 类别来更改此设置。
修复了以下问题:在低于 8 的 iOS 版本上,控制中心的播放和暂停功能无法正常运行。
打开通知栏时,广告不再暂停。
向可下载的 ZIP 文件中添加了 VERSION 文件。
为了提升性能,现在所有 iOS 版本上的广告呈现都通过 AVPlayer 原生完成。
Beta v12
2015-02-12
现在,在 iOS 7 及更低版本上使用原生广告播放。这样可以防止 SDK 干扰 MPMoviePlayerController 事件和控件。
修复了在 LOADED 和 START 事件中未填充 adPlaybackInfo 的问题。
添加了 IMASettings.maxRedirects,用于指定重定向次数上限,超过此上限后,后续重定向将被拒绝,广告加载也将中止。
添加了对手动广告播放 的支持。
Beta v11
2014-12-17
修复了 Beta 版 v10 中因添加 WKWebView 而引入的内存泄漏问题。
Beta v10
2014-11-20
该 SDK 现在使用 iOS 8 上的 WKWebView(而非 UIWebView)来呈现广告。此版本修复了与 SDK 原生层和 JS 层之间的通信相关的多个问题。此项变更带来的一个副作用是,IMA SDK 现在会要求您的应用在构建时支持 arm64。
添加了 TAPPED 事件,每当用户点按广告的不可点击部分时,就会触发该事件。这可用于检测对广告的点按,以显示播放器控件。
为符合 iOS 惯例,以下方法已被弃用,并替换为引用调用对象的方法:
IMAAdsManagerDelegate - adDidProgressToTime:currentTime:
IMAWebOpenerDelegate - willOpenInExternalBrowser
IMAWebOpenerDelegate - willOpenInAppBrowser
IMAWebOpenerDelegate - didCloseInAppBrowser
IMAWebOpenerDelegate - didOpenInAppBrowser
IMAWebOpenerDelegate - willCloseInAppBrowser
Beta v9
2014-10-27
修复了 IMAJavascript 类中的内存泄漏问题。
Beta v8
2014-10-13
Beta v7
2014-08-11
Beta v6
2014-05-27
在 IMAAd 对象上公开说明、标题和 contentType。
添加了对 64 位 iOS 模拟器的支持
Beta v5
2014-02-14
添加了 arm64 支持。
修复了与 Google+ 集成时发生的冲突。
Beta v4
2013-12-12
修复了 IMAAdsManager 和 IMAAdsLoader 中的内存泄漏问题。
IMAAdPodInfo 具有三个新 API:podIndex、timeOffset、maxDuration。
API 文档很快就会更新,以反映这一变化。
Beta v3
2013-09-25
Beta v2
2013-07-07
封闭式 Beta 版 v2
2013-06-24
封闭式 Beta 版 v1
2013-04-02