Google IMA Android SDK 版本历史记录

版本 发布日期 备注
3.34.0 2024-06-13
3.33.0 2024-03-28
3.32.0 已弃用 2024-01-30
  • 此版本与运行 Android API 的设备不兼容 25 级及以下。请改用 IMA SDK Android v3.33.0。
  • 为广告连播投放添加了第三方拼接器 VOD 流支持。请参阅 Android Pod 服务指南 了解详情。此更改包括添加以下 API：
  • 将 IMA 支持的 minSdkVersion 增加到 19。
  • 修复了使用“了解详情”按钮点击广告的问题 不会在 Android API 版本 30 及更高版本中打开新页面。问题 仍存在于 IMA SDK 3.31.0 至 3.29.0 版本中，其中 需要解决这一问题。
  • 修复了使用 AdsLoader.addAdsLoadedListener() 的 bug 可能会导致 ArrayIndexOutOfBoundsException 异常。
  • 添加广告错误 VAST_NO_ADS_AFTER_WRAPPER。
3.31.0 2023-08-31
  • 使用 IMA SDK 版本 3.31.0 至 3.29.0 时 Android API 30 版及更高版本（使用 了解详情按钮无法打开新页面。对于 则应添加 intent 声明，以便打开 Web 应用 链接，如下所示： 
              <?xml version="1.0" encoding="utf-8"?>
          <manifest xmlns:android="http://schemas.android.com/apk/res/android"
              package="com.example.project_name">
              ...
              </application>
              <queries>
                  <intent>
                      <action android:name="android.intent.action.VIEW" />
                      <data android:scheme="https" />
                  </intent>
                  <intent>
                      <action android:name="android.intent.action.VIEW" />
                      <data android:scheme="http" />
                  </intent>
              </queries>
          </manifest>
  • 将 IMA 的 OM SDK 依赖项更新为 1.4.8 版，该版本包括 新联网电视信号。
  • 废弃了以下 AdsRequest API： <ph type="x-smartling-placeholder">
      </ph>
    • getExtraParameter()
    • getExtraParameters()
    • setExtraParameter()
  • SDK 版本 3.31.0 将于 2025 年 3 月 28 日弃用。请参阅 弃用时间表 了解详情。
3.30.3 2023-08-03
  • 更新了内部库依赖项，以缩短启动延迟时间。
  • SDK 版本 3.30.3 将于 2024 年 8 月 31 日弃用。请参阅 弃用时间表 了解详情。
3.30.2 2023-07-28
  • 修复了意外的 NullPointerException 错误 v3.30.1 中引入。
  • 修复了导致某些事件无法执行的 ProGuard 的问题 从 SDK 发出。此 bug 修复会影响 IMA DAI SDK
  • 添加对 Gradle v8 及更高版本的支持。旧版 Android IMA SDK 需要使用 在android.enableR8.fullMode=false gradle.properties 文件。请参阅 “R8 完整模式”一文 了解详情。
  • SDK 版本 3.30.2 将于 2024 年 8 月 3 日弃用。请参阅 弃用时间表 了解详情。
3.30.1 已弃用 2023-04-18
  • 此版本存在意外错误 NullPointerException 个错误。 在运行较新版本之前，使用旧版 IMA SDK Android v3.29.0 发布。
  • 修复了使用 v3.30.0 的应用在非 Android TV 上发生崩溃的问题 设备。
3.30.0 已弃用 2023-03-29
3.29.0 2022-10-14
  • 将 EspVersion 类重命名为 VersionInfo 类。
  • 将 Encrypted Signals for Publishers (ESP) API 重命名为 Secure Signals API。
  • 添加了功能标志 API。您可以使用功能标志 API 来启用或停用 特定功能使用 ImaSdkSettings.getFeatureFlags()和 ImaSdkSettings.setFeatureFlags() 来获取和设置功能标志
  • 修复了部分 IMA 事件无法发送的问题。
  • 添加了 androidx.webkit:webkit 作为 IMA SDK 依赖项
  • SDK 版本 3.29.0 将于 2024 年 3 月 29 日弃用。请参阅 弃用时间表 了解详情。
3.28.2 2022-09-14
  • 更新 SDK 依赖项以使用 AndroidX。
  • SDK 版本 3.28.2 将于 2023 年 10 月 14 日弃用。请参阅 弃用时间表 了解详情。
3.28.1 已弃用 2022-08-03
3.27.1 2022-05-27
  • 服务版本，无新功能。
  • SDK 版本 3.27.1 将于 2023 年 8 月 3 日弃用。请参阅 弃用时间表 了解详情。
3.27.0 2022-03-01
  • 通过设置随播广告位添加了对自适应尺寸的随播广告位的支持。 将宽度和高度设置为 IMA 常量 FLUID_SIZE 。
  • SDK 版本 3.27.0 将于 2023 年 5 月 27 日弃用。请参阅 弃用时间表 了解详情。
3.26.0 2022-01-12
  • 添加了 Encrypted Signals for Publishers (ESP) API（已重命名为 安全信号 。这样，发布商就可以启用广告联盟出价方 和 IDP
  • SDK 版本 3.26.0 将于 2023 年 3 月 1 日弃用。请参阅 弃用时间表 了解详情。
3.25.1 2021-11-08
3.24.0 2021-06-03
3.23.0 2021-04-07
  • 将 ImaSdkSettings.setSessionId() 和 ImaSdkSettings.getSessionId() 方法获取和设置会话 ID。这是一项临时随机 专门用于频次上限的 ID。
  • 修复了与随播广告相关的 NullPointerException 错误 广告。
  • 在低于 API 级别 21 的随播广告中停用 JavaScript，以达到 修复安全漏洞问题
  • SDK 版本 3.23.0 将于 2022 年 6 月 3 日弃用。请参阅 弃用时间表 了解详情。
3.22.3 2021-03-16
  • 修复了与发布相关的 NullPointerException 错误 在加载广告时调用 AdsLoader。
  • 添加 1206 错误 UNEXPECTED_ADS_LOADED_EVENT（在广告加载的情况下） 意外发送。
  • SDK 版本 3.22.3 将于 2022 年 4 月 7 日弃用。请参阅 弃用时间表 了解详情。
3.22.2 2021-02-26
  • IMA SDK 现在依赖于以下库：
    • com.google.android.gms:play-services-base
    • com.google.android.gms:play-services-basement
    • androidx.preference:preference
  • 修复了当 AdsLoader 收到 错误。
  • SDK 版本 3.22.2 将于 2022 年 3 月 16 日弃用。请参阅 弃用时间表 了解详情。
3.22.0 2021-01-11
  • 添加了针对 DAI 视频流的广告连播投放。在广告连播投放工作流程中 仅负责投放广告。发布商应负责 内容并创建随后会指向广告管理器的清单。 使用ImaSdkFactory.createPodStreamRequest() 为广告连播传送创建视频流请求如果使用它 负责在 streamInit() 上加载数据流。
  • 修复了由于未应用生命周期监控器而导致的内存泄漏问题 已妥善清理
  • SDK 版本 3.22.0 将于 2022 年 2 月 26 日弃用。请参阅 弃用时间表 了解详情。
3.21.4 2020-12-09
  • 移除与通话相关的无害警告消息 adsLoader.release()。
  • SDK 版本 3.21.4 将于 2022 年 1 月 8 日弃用。请参阅 弃用时间表 了解详情。
3.21.2 2020-11-20
  • 修复了由于发送消息更新而导致的意外线程安全问题 。
  • 更新了 的文档 AdsLoader.release()。
  • SDK 版本 3.21.2 将于 2021 年 12 月 9 日弃用。请参阅 弃用时间表 了解详情。
3.21.1 2020-11-17
  • 修复了在发生事件时偶尔导致应用崩溃的问题 触发。
  • SDK 版本 3.21.1 将于 2021 年 11 月 20 日弃用。请参阅 弃用时间表 了解详情。
3.21.0 2020-10-23
  • 在 DAI Android SDK 中添加了对 SIMID 广告的支持。
  • 将 AdsLoader.release() 方法并废弃了 BaseDisplayContainer.destroy()。 此更改解决了在处理 在 VMAP 广告投放期间投放了 BaseDisplayContainer。 AdsLoader.release() 是新的推荐方法 处理 IMA SDK 对象，而不是使用 BaseDisplayContainer.destroy()。
  • SDK 版本 3.21.0 将于 2021 年 11 月 17 日弃用。请参阅 弃用时间表 了解详情。
3.20.1 2020-10-12
  • 修复了以下 API 级别 29+ 上的 HTMLResource 随播广告问题： Android。请参阅 Android API 行为的变化。
  • SDK 版本 3.20.1 将于 2021 年 10 月 23 日弃用。请参阅 弃用时间表 了解详情。
3.20.0 2020-08-18
  • 版本 3.20.0 是受到 IMA 暂停行为的变化。 如果您使用此版本或以后的 SDK 版本，建议您阅读 并做出相应更改，以暂停您的 应用。发布商可以测试这些更改的实施情况 使用测试广告代码进行测试。
  • 将 onPause() 和onResume() 添加 DAI VideoStreamPlayer 类回调。
  • 添加 adPeriodDuration() 方法添加到 AdProgressInfo 类中。
  • 添加了对 Android TV 设备上图标点击后备图片的支持。
  • 将 ICON_FALLBACK_IMAGE_CLOSED 事件，用于在 Android TV 上关闭图标后备图片时处理 设备。
  • 从以下对象中移除了已废弃的 focusSkipButton() 方法： AdsManager赞成focus() 方法。
  • 对于联网电视设备，广告现在会在 AdEvent.AdEventType STARTED 事件。停用自动模式 使用 adsRenderingSettings.setFocusSkipButtonWhenAvailable(false) 方法，然后使用 focus() 方法。
  • 添加 getCurrentTimeMs() 和 getDurationMs 添加到 VideoProgressUpdate() 类中。
  • 废弃了 getCurrentTime 和 getDuration 方法，支持新的 getCurrentTimeMs和getDurationMs 方法。
  • 修复了 DASH 直播时没有广告事件的问题 已正确报告。
  • SDK 版本 3.20.0 将于 2021 年 10 月 12 日弃用。请参阅 弃用时间表 了解详情。
3.19.4 2020-07-08
3.19.3 2020-06-29
  • 修复了针对 GDPR 的 IAB TCF 集成导致的问题 与意见征求管理平台 SDK 集成的玩家发生崩溃。
  • SDK 版本 3.19.3 将于 2021 年 7 月 8 日弃用。请参阅 弃用时间表 了解详情。
3.19.2 2020-06-22
3.19.0 2020-05-12
3.18.1 2020-03-25
  • 针对高像素密度设备上的随播广告增加了缩放比例。
  • 添加了对客户端 SIMID 广告的支持。
  • SDK 版本 3.18.1 将于 2021 年 5 月 12 日弃用。请参阅 弃用时间表 了解详情。
3.18.0 2020-03-04
  • 在 VideoStreamPlayer 界面。必须为 v3.18.0 及更高版本实现这些模式。
  • SDK 版本 3.18.0 将于 2021 年 3 月 25 日弃用。请参阅 弃用时间表 了解详情。
3.17.0 2020-02-07
3.16.5 2020-01-22
  • 通过以下参数重新支持 OMID 1.3 contentUrl AdsRequest.setContentUrl 和 StreamRequest.setContentUrl 。
  • 对 OMID 1.3 友好障碍物 FriendlyObstruction 。
  • 废弃了这些方法 BaseDisplayContainer.registerVideoControlsOverlay 和BaseDisplayContainer.unregisterAllVideoControlsOverlay 支持<ph type="x-smartling-placeholder"></ph> FriendlyObstruction 。
  • 修复了 NullPointerException 通话后发生了 CompanionAdSlotsclear()。
  • 修复了在调用时可能导致内存泄漏的问题 destroy()。
  • SDK 版本 3.16.5 将于 2021 年 2 月 7 日弃用。请参阅 弃用时间表 了解详情。
3.16.2 2019-12-05
  • 添加了对自动包含 IAB TCFv2 和 CCPA 中的用户意见征求参数的支持。
  • 现在，若要使用 Android 偏好设置，需要启用 androidx 软件包。
  • SDK 版本 3.16.2 将于 2021 年 1 月 22 日弃用。请参阅 弃用时间表 了解详情。
3.16.1 2019-11-08
3.16.0 2019-10-23
  • 将 replaceAdTagParameters 方法添加到 StreamManager、 以便在直播期间替换所有广告代码参数。
  • 取消了对以下已废弃方法的支持：
    • AdsRequest.getAdDisplayContainer()
    • AdsRequest.setAdDisplayContainer(AdDisplayContainer adDisplayContainer)
    • ImaSdkFactory.createAdsLoader(Context context)
    • ImaSdkFactory.createAdsLoader(Context context, ImaSdkSettings settings)
    • ImaSdkFactory.createLiveStreamRequest(String assetKey, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • ImaSdkFactory.createVodStreamRequest(String contentSourceId, String videoId, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • StreamRequest.getStreamDisplayContainer()
  • SDK 版本 3.16.0 将于 2020 年 11 月 8 日弃用。请参阅 弃用时间表 了解详情。
3.14.0 2019-09-11
  • 服务版本，无新功能。
  • SDK 版本 3.14.0 将于 2020 年 10 月 23 日弃用。请参阅 弃用时间表 了解详情。
3.13.1 2019-09-03
3.11.3 2019-06-11
  • 修复了 AOSP 设备上 is_lat 设置存在的 bug。
  • SDK 版本 3.11.3 将于 2020 年 9 月 3 日弃用。请参阅 弃用时间表 了解详情。
3.11.2 2019-04-16
  • 修复了以下崩溃问题： java.lang.ClassNotFoundException: Didn't find class "j$.util.concurrent.ConcurrentHashMap"。
  • SDK 版本 3.11.0 自 2020 年 6 月 11 日起已正式弃用。请参阅 弃用时间表 了解详情。
3.11.0 已弃用 2019-03-22
3.10.9 2019-03-13
  • 修复了以下竞态条件 bug：广告界面有时无法在 后续广告。
  • 修复了调用 getCompanionAds() API。
  • SDK 版本 3.10.7 将于 2020 年 3 月 22 日弃用。请参阅 弃用时间表 了解详情。
3.10.7 2019-02-19
3.10.6 2019-01-23
  • 向流式传输播放器界面添加了 seek() 方法。
  • 添加了对 AD_BUFFERING 广告事件回调的支持。
  • 不得再在广告请求中传递容器。全新的工作流程 需要通过 AdsLoader 传递容器 构造函数。
  • 添加 BaseDisplayContainer.destroy() 方法。
  • 修复了视频播放完毕时发生的内存泄漏问题。
  • 弃用了 requestNextAdBreak。此 API 将在以下版本中被移除： 未来的版本。此后，系统将在 4 秒内自动提取广告 。
  • SDK 版本 3.10.2 将于 2020 年 2 月 19 日弃用。请参阅 弃用时间表 了解详情。
3.10.2 2018-11-13
  • 修复了导致广告连播中的第二个广告抛出 VAST 402 错误的竞态条件。
  • 向 DAI Android SDK 添加了频次上限和竞争排除。
  • 将 getAdProgressInfo() 从 StreamManager 移到了 BaseManager。
  • 将 getVastMediaHeight()、getVastMediaWidth() 和 getVastMediaBitrate() 添加到 Ad。
  • SDK 版本 3.9.4 将于 2020 年 1 月 23 日弃用。请参阅 弃用时间表 了解详情。
3.9.4 2018-08-01
  • 将 getCompanionAds() 添加到 Ad。这在仅使用 DAI 时会返回随播广告。
  • 添加了新的 CompanionAd 类。
  • 将新的 SKIPPABLE_STATE_CHANGED 事件添加到 AdEvent。
  • 修复了在某些情况下未遵循 focusSkipButtonWhenAvailable 默认设置的问题。
  • SDK 版本 3.9.0 将于 2019 年 8 月 1 日弃用。请参阅 弃用时间表 了解详情。
3.9.0 2018-07-09
  • 现已支持 Android TV。
  • 将 focusSkipButton() 添加到 AdsManager。此功能仅适用于 Android TV。
  • 将 getFocusSkipButtonWhenAvailable() 添加到 AdsRenderingSettings，默认为 true。此功能仅适用于 Android TV。
  • 将 setFocusSkipButtonWhenAvailable() 添加到 AdsRenderingSettings。此功能仅适用于 Android TV。
  • VideoAdPlayer 现在扩展了 VolumeProvider 接口。现在，自定义播放必须实现此接口。
  • SDK 版本 3.8.7 将于 2019 年 7 月 9 日弃用。请参阅 弃用时间表 了解详情。
3.8.7 2018-05-23
  • 允许在 HTML 随播广告中使用动画。
  • SDK 版本 3.8.5 将于 2019 年 5 月 23 日弃用。请参阅 弃用时间表 了解详情。
3.8.5 2018-04-09
  • 修复了 ImaSdkSettings 被忽略的问题。
  • 修复了与以下项存在构建冲突的问题： com.android.support 版本文件。
  • 将 setAdWillPlayMuted 添加到 AdsRequest。
  • 将 setLoadVideoTimeout 添加到 AdsRenderingSettings。
  • SDK 版本 3.8.2 将于 2019 年 4 月 9 日弃用。请参阅 弃用时间表 了解详情。
3.8.2 2018-01-24
  • 将“setLiveStreamPrefetchSeconds”添加到 AdsRequest。
  • 修复了各种文档问题。
  • SDK 版本 3.7.4 将于 2019 年 1 月 24 日弃用。请参阅 弃用时间表 了解详情。
3.7.4 2017-06-29
  • 将 setVastLoadTimeout 添加到 AdsRequest。
  • 将 getSkipTimeOffset 添加到 Ad。
  • SDK 版本 3.7.2 将于 2018 年 6 月 29 日弃用。请参阅 弃用时间表 了解详情。
3.7.2 2017-05-25
  • 将 setDebugMode 添加到 ImaSdkSettings。
  • SDK 版本 3.7.1 将于 2018 年 5 月 25 日弃用。请参阅 弃用时间表 了解详情。
3.7.1 2017-03-24
  • 解决了使用 Proguard 时的命名空间冲突。
  • Jar 大小缩减了约 30KB。
  • SDK 版本 3.7.0 将于 2018 年 3 月 24 日弃用。请参阅 弃用时间表 了解详情。
3.7.0 2017-03-13
  • 修复了某些 IMA 类意外合并到 ProGuard 的 a.a.a.a 软件包的问题。
  • SDK 版本 3.6.0 将于 2018 年 3 月 13 日弃用。请参阅 弃用时间表 了解详情。
3.6.0 2017-02-16
  • 将以下代码添加到 Ad： <ph type="x-smartling-placeholder">
      </ph>
    • getAdWrapperCreativeIds()
    • getAdvertiserName()
    • getCreativeAdId()
    • getCreativeId()
    • getDealId()
    • getSurveyUrl()
    • getUniversalAdIdRegistry()
    • getUniversalAdIdValue()
  • 添加“AdsManager.requestNextAdBreak().”
  • 将以下代码添加到 AdsRenderingSettings： <ph type="x-smartling-placeholder">
      </ph>
    • setEnablePreloading()
    • getEnablePreloading()
  • 将以下代码添加到 AdsRequest： <ph type="x-smartling-placeholder">
      </ph>
    • setContentDuration()
    • setContentKeywords()
    • setContentTitle()
  • SDK 版本 3.5.2 将于 2018 年 2 月 16 日弃用。请参阅 弃用时间表 了解详情。
3.5.2 2016-11-14
  • 添加归 SDK 所有的视频播放器，可视情况处理广告播放。
  • 添加了 CompanionAdSlot.ClickListener 以及用于添加和移除监听器的方法。
  • 修复了 getViewability() 错误日志无效的问题。
  • 修复了图标的点击行为和未正确呈现。
  • SDK 版本 3.4.0 将于 2017 年 11 月 14 日弃用。请参阅 弃用时间表 了解详情。
3.4.0 2016-09-12
  • 修复了使用 Google Play 服务 9.0.0 版及更高版本时出现的重复文件错误。
3.3.2 2016-07-11
3.3.0 2016-05-31
3.2.1 2016-04-07
  • 服务版本，无新功能。
3.1.3 2015-12-16
3.b13.3（Beta 版） 2015-09-10
  • 服务版本，无新功能。
3.b12.1（Beta 版） 2015-07-20
3.b11.4（Beta 版） 2015-05-21
  • 向 API 添加以下内容：
    • AdError.AdErrorCode.VAST_EMPTY_RESPONSE
    • AdError.getErrorNumber()
    • AdsRequest.setAdWillAutoPlay(Boolean)
    • CompanionAdSlot.isFilled()
    • ImaSdkSettings.setPlayerType(String)
    • ImaSdkSettings.setPlayerVersion(String)
3.b10.3（Beta 版） 2015-03-24
  • 添加了 ImaSdkSettings.getMaxRedirects 和 ImaSdkSettings.setMaxRedirects。
  • IMA API 类现为 final。
  • 现在，SDK 版本号的格式为 3.bX.Y，b 表示 SDK 的 Beta 版状态。
  • 已移除以下 AdError.AdErrorCode 值： <ph type="x-smartling-placeholder">
      </ph>
    • API_ERROR - 改用 UNKNOWN_AD_RESPONSE。
    • PLAYLIST_MALFORMED_RESPONSE - 改用 UNKNOWN_AD_RESPONSE。
    • REQUIRED_LISTENERS_NOT_ADDED - 不是由 SDK 引发的。
    • VAST_INVALID_URL - 改用 VAST_LOAD_TIMEOUT。
Beta 版 v9 2014-10-17
  • 添加了广告 API getTitle、getDescription、 和 getContentType。
  • 向广告界面添加广告连播位置相关信息，例如 “第 1 个广告，共 4 个：(0:13)”。
  • 您不应再直接控制 使用视频播放器播放广告请改用 AdsManager.pause() 和AdsManager.resume()。
Beta 版 v8 2014-06-12
  • 修复了可跳过广告的广告界面无法清除的问题。
  • 记录媒体文件加载超时的错误代码。
Beta 版 v7 2014-05-27
  • 修复了与 Google Play 服务相关的问题。SDK 现在要求 Google Play 服务内置于您的应用中。如需了解详情，请参阅 设置 Google Play 服务 SDK。
Beta 版 v6 2014-04-14
  • 添加了 VAST 3 支持。
  • 添加了部分 VMAP 支持（等同于当前的 Ad Manager 广告规则）。
  • 向 API 添加以下内容：
    • AdError.AdErrorCode.ADS_REQUEST_NETWORK_ERROR
    • AdEvent.AdEventType.LOG
    • AdEvent.getAdData()
    • AdPodInfo.getMaximumDuration()
    • AdPodInfo.getPodIndex()
    • AdPodInfo.getTimeOffset()
  • 修复了以下 bug：带有优化型广告连播和封装容器的中贴片广告 导致广告连播中的其他所有广告都被跳过
  • 系统将不再 已忽略。
  • 修复了多个错误以提高稳定性。
Beta 版 v5 2013-12-12
  • 修复了播放列表中可跳过广告的问题。
Beta 版 v4 2013-10-15
  • 添加了通过在 。
Beta 版 v3 2013-09-05
  • 服务版本，无新功能。
Beta 版 v2 2013-07-07
  • 公开发布 SDK Beta 版。
封闭式 Beta 版 v2 2013-06-24
  • 添加了用于在 ImaSdkSettings 对象上设置界面语言的 API。 请注意，它用于设置界面语言，而不是广告语言。
  • 修复了应用同时包含 IMA SDK 和 AdMob SDK 库。
  • 添加了各种内部效果指标的日志记录。
封闭式 Beta 版 v1 2013-04-02

  • 初始测试版。以下是测试版的已知问题：

    SDK 相关信息

    以下 AdEvents Android 设备不支持 HTML5 IMA SDK v3 IMA SDK： IMPRESSION, LOG, SKIPPABLE_STATE_CHANGED, STOPPED, VOLUME_CHANGED, VOLUME_MUTED

    应用相关示例应用

    1. 存在一个间歇性问题，即广告播放器 可以在用户点击广告后正常继续播放。对于 例如，有时当您点击完 继续播放广告会使广告继续播放 而不是从上次停止的地方继续浏览 。
    2. “插播广告 2”返回的广告广告代码不兼容 与 v3 IMA Android SDK 集成
    3. 示例播放器不会自动停用搜寻（拖动） 。确保停用视频跳转功能 。