版本
发布日期
备注
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 Pod Serving 流中可跳过广告的支持。
修复了当视频嵌入可滚动容器中时出现的滚动支持方面的 bug。
为非线性广告添加了对 minSuggestedDuration 的支持
修复了在某些情况下导致 Campaign Manager 跟踪网址编码不正确的 bug。
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 Serving 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。
修复了广告暂停和恢复事件会在内容播放期间触发的问题。
确保广告界面内容边衬区不会自动调整
支持 iOS 10 的最后一个 IMA SDK for iOS 版本。
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 中已弃用的字段。
修复了 PiP 会在每次广告播放完毕后最小化的问题。
修复了以下 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 的初始化与 NSObject 的初始化冲突的问题
弃用了 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 广告界面视图会保留,导致用户无法与播放器互动。
自 2020 年 8 月 16 日起,SDK 版本 3.9.1 将弃用。如需了解详情,请参阅弃用时间表 。
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 上内容未恢复的问题。
SDK 版本 3.8.1 将于 2020 年 2 月 19 日弃用。如需了解详情,请参阅弃用时间表 。
3.8.1
2018-11-13
修复了包含多个展示广告资源尺寸的广告代码解析不正确的问题。
添加了 [IMAVideoDisplay seekStreamToTime] 以支持 IMA DAI VOD 流中的可跳过广告。
添加了 IMAAdRenderingSettings.loadVideoTimeout。
添加了 IMAAd.VASTMediaWidth、IMAAd.VASTMediaHeight 和 IMAAd.VASTMediaBitrate。
由于构建改进,将二进制文件的大小缩减了约 15%。
自 2019 年 11 月 13 日起,SDK 版本 3.7.3 将弃用。如需了解详情,请参阅弃用时间表 。
3.7.3
2018-08-21
改进了对格式错误的流清单的错误处理。
修复了 HTML 随播广告中自定义应用内网址点击后到达网址的问题。
修复了与背对背可跳过的视频广告相关的问题。
SDK 版本 3.7.2 将于 2019 年 8 月 21 日弃用。如需了解详情,请参阅弃用时间表 。
3.7.2
2018-05-15
修复了部分辅助信息会展开为全屏 WebView 的问题。
自 2019 年 5 月 15 日起,SDK 版本 3.7.1 将被弃用。如需了解详情,请参阅弃用时间表 。
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 及更低版本。
服务版本,无新功能。
SDK 版本 3.6.1 已于 2019 年 1 月 30 日弃用。如需了解详情,请参阅弃用时间表 。
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 无法检测到该视频视图。
SDK 版本 3.5.2 将于 2018 年 7 月 24 日弃用。如需了解详情,请参阅弃用时间表 。
3.5.2
2017-05-02
移除了从后台返回应用时自动恢复的功能。
致电 [IMAAdsManager resume] 即可恢复。
添加了 [IMAAdsRenderingSettings playAdsAfterTime]。
SDK 版本 3.5.1 将于 2018 年 5 月 2 日弃用。如需了解详情,请参阅弃用时间表 。
3.5.1
2017-04-03
如果 IMAAdDisplayContainer 在发出广告或视频流请求时不在视图层次结构中,SDK 现在将抛出 kIMAError_FAILED_TO_REQUEST_ADS。之前,这些请求会静默失败。
SDK 版本 3.5.0 于 2018 年 4 月 3 日弃用。如需了解详情,请参阅弃用时间表 。
3.5.0
2017-03-24
修复了与位码支持相关的问题。
将 adsResponse 添加到 IMAAdsRequest 对象。
修复了 Swift build 的问题。
SDK 版本 3.4.2 将于 2018 年 3 月 24 日弃用。如需了解详情,请参阅弃用时间表 。
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
由于特定设备的 build 存在问题,已回滚到 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 及更低版本。
SDK 版本 3.2.1 于 2017 年 9 月 16 日弃用。如需了解详情,请参阅弃用时间表 。
3.2.1
2016-05-09
3.2.0
2016-04-14
注意:由于存在错误,此版本中的位码支持无法正常运行。
添加了位码支持。
添加了对指向应用商店的点击后到达网址的支持。
3.1.0
2015-12-17
已结束 Beta 版测试。
添加了对 iOS 9 上画中画的支持。如需了解详情,请参阅我们的画中画指南 或高级示例中的实现。
现在,IMAContentPlayhead 应传递给 IMAAdsRequest,而不是 IMAAdsManager。
添加了对 HTML5 随播广告的支持。
添加了 [IMAAdsManager discardAdBreak] 。
Beta 版 v16
2015-09-04
更新以兼容 iOS 9 的应用传输安全 功能。
修复了 IMAAdsLoader 解分配时发生崩溃的问题。
Beta 版 v15
2015-07-22
通过 IMAAdsManager 委托引入了广告缓冲事件。这样一来,便可轻松向播放器添加 activity 指示器和缓冲栏等元素。
公开调试模式。发布商现在可以将 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 类别来更改此行为。
修复了在 iOS 8 之前的版本上控制中心播放和暂停功能无法正常运行的 bug。
打开抽屉式通知栏时,广告不再暂停。
向可下载的 ZIP 文件添加了 VERSION 文件。
为提升性能,广告呈现现在通过 AVPlayer 在所有 iOS 版本上以原生方式完成。
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