适用于 Roku 的 IMA DAI SDK 发布历史记录

注意：此页面上显示的版本序列号可能存在数字缺口（例如 v.3.583.1 之前的 v.3.582.5），这是因为系统会定期跳过一些版本号。

版本	发布日期	备注
3.69.0	2025-09-25	添加了 Companion.adSlotId 和 Companion.companionClickThrough 属性，以支持 Pod 投放型视频流的随播广告。 修复了以下问题：对于广告连播中的所有广告（最后一个广告除外），已完成的信标无法发送。 修复了以下 bug：当广告被跳过时，系统会报告 COMPLETE 广告事件。现在，当用户在广告插播时段中快进时，广告事件的报告会更加准确。 移除了 IMA 在移除广告界面后聚焦界面容器的行为。
3.68.3	2025-07-02	修复了广告插播开始和广告开始事件在错误的时间触发的问题，例如在内容恢复播放时。 修复了以下问题：无效的广告时长值会导致运行时错误 'Dot' Operator attempted with invalid BrightScript Component or interface reference 。
3.68.2	2025-05-28	公开了在初始化流时调用的 player.streamInitialized() 方法。 更新了 IMA 行为，以便在用户跳过广告时不会触发 COMPLETED 事件。即使在用户跳过广告时，SDK 仍会触发 SKIPPED 事件。此项针对 COMPLETED 事件行为的更改现在与其他 IMA SDK 的行为相符。 改进了 pod 服务流的消息处理。 修复了广告界面在全高清视频流中拉伸的问题。 修复了初始前贴片广告事件延迟的问题。
3.68.1	2025-04-21	修复了与广告图标相关的 Divide by Zero 极端情况运行时错误。
3.67.2	2024-12-19	改进了 currentAd.currentTime，使 currentTime 值与广告事件触发的时间保持一致。 修复了某些广告事件间歇性未触发的问题。
3.67.0	2024-11-07	为全方位服务的 DAI 流请求添加了可选的 Ad Manager 广告资源网代码参数。添加此参数可让 IMA 行为发生变化，以匹配 Ad Manager 设置，例如停用程序化受限广告。 为 streamManager.loadThirdPartyStream() 添加了 VOD 视频流支持。 直播的更新 AdBreakInfo.podIndex。此值现在会返回插播广告的广告插播 ID（作为 pod 指数），或前贴片广告的 0。直播中没有后贴片广告。对于直播活动，该值的默认值为 -2。 为云拼接和 Pod 服务流添加了对 StreamManager.getStreamTime() 和 StreamManager.getContentTime() 的支持。 修复了 AdInfo 中未包含广告素材广告 ID 和广告素材 ID 值的问题。 修复了 Roku 界面图标和跳过按钮位置不正确的问题。
3.66.1	2024-07-25	为所有直播和 VOD 流请求添加了对 networkCode 参数的要求。 向 AdInfo 类添加了 creative_id、creative_ad_id 和 deal_id。 添加了对自定义 VAST 跟踪事件（例如“跳过显示”“跳过”和“点击后到达”）的支持。 修复了 Cloud Video Stitcher VOD 流的 StreamManager.getCuePoint() 问题。 修复了 StreamManager.createVideoStitcherVodStreamRequestWithVodConfig() 中的大写问题。
3.66.0	2024-06-18	添加了 ima.StreamRequest.createVideoStitcherVodStreamRequestWithVodConfig()。 添加了 ima.AdEvent.ICON_FALLBACK_IMAGE_SHOWN 和 ima.AdEvent.ICON_FALLBACK_IMAGE_CLOSED，用于在显示和关闭回退图片对话框时进行处理。 添加了 ima.AdInfo.skipOffset，用于表示广告变为可跳过状态所需的秒数。 添加了 ima.StreamRequest.videoStitcherSessionOptions。 修复了以下问题：未针对板岩调用广告时段事件。
3.65.0	2024-03-29	为 DAI Pod Serving VOD 添加了 createPodVodStreamRequest 和 StreamManager.loadThirdPartyStream 函数。
3.64.0	2024-02-08	向 ima.initSdk 函数添加了一个可选的 settings 参数，用于启用和停用 SDK 功能。
3.63.0	2023-09-14	修复了应用在遇到无效 adBreakInfo 时可能会崩溃的 bug。
3.62.0	2023-08-02	添加了 StreamRequest.createVideoStitcherLiveStreamRequest() 和 StreamRequest.createVideoStitcherVodStreamRequest() API，以支持 Google Cloud Video Stitcher API。 更新 IMA 行为，以遵循为 description_url= 参数设置的值。之前，IMA 始终会使用其检测到的正确网址覆盖 description_url= 参数，并将 url= 参数更改为之前设置为 description_url= 的值。如果未在视频流的广告代码网址中设置 description_url=，IMA 仍会设置该值。
3.61.1	2023-03-22	添加了对传统广告和 TrueView 可跳过广告的支持。 添加了以下广告事件： SKIPPABLE_STATE_CHANGED SKIPPED
3.60.0	2022-09-30	针对所有跟踪 ping 推出 Roku 水印支持。
3.59.0	2022-09-23	服务版本，无新功能。
3.58.0	2022-09-15	服务版本，无新功能。
3.57.2	2022-09-12	添加了在设置 StreamInfo.format 时使用的 StreamFormat 类。
3.56.0	2022-08-05	服务版本，无新功能。
3.55.0	2022-07-15	添加了以下用于请求特定流类型的 API： CreateLiveStreamRequest() 用于创建直播请求。 CreatePodLiveStreamRequest() 用于创建实时 pod 流请求。 CreateVodStreamRequest() 用于创建 VOD 视频流请求。 如需了解每个 API 的参数，请参阅 StreamRequest 。
3.54.0	2022-05-19	添加了 StreamRequest.customAssetKey() 和 StreamRequest.networkCode()，以支持 Pod 服务。
3.53.0	2022-04-25	针对直播 HLS CMAF 数据流实现了适当的 ID3 事件解析。此问题修复了以下问题：对于这些视频流，广告事件是在错误的时间触发的。 弃用了 StreamManager.onTimedMetadata()。此方法不再有相关文档。
3.52.0	2022-03-29	服务版本，无新功能。
3.51.0	2022-03-17	服务版本，无新功能。
3.50.0	2022-03-07	添加了 StreamManager.onTimedMetadata()。
3.45.1	2021-11-03	添加了对可跳过广告的支持。 更新了 SDK 行为，现在可以正确 ping 进度事件。
3.41.1	2021-04-07	添加了 StreamRequest.adUiNode，以便在广告播放期间放置为什么显示该广告和跳过按钮等元素。 移除了对 StreamManager.enableInteractiveAds() 的支持。现在，此方法已成为空操作。请改为直接将数据从随播广告传递到 RAF。
3.40.1	2020-09-23	添加了对 DASH 直播的支持。
3.39.0	2020-07-06	服务版本，无新功能。
3.36.0	2020-02-28	服务版本，无新功能。
3.35.0	2019-11-11	服务版本，无新功能。
3.34.0	2019-07-18	服务版本，无新功能。
3.33.0	2019-05-14	向 ima.AdEvent 添加了 AD_PERIOD_STARTED 和 AD_PERIOD_ENDED 事件。 向 ima.AdEvent 添加广告 PROGRESS 事件。 向 adInfo 添加了 advertiserName、universalAdIDRegistry 和 universalAdIDValue 参数。
3.28.1	2018-07-10	服务版本，无新功能。