Release notes for the IMA Roku SDK

[Jackson Sui (IMA SDK Team)]

Hi all,

We'll post in this thread every time a new version of the IMA Roku SDK is released. If you wish to receive these updates by e-mail, please subscribe to receive update from this thread.

The release notes will also be available at https://developers.google.com/interactive-media-ads/docs/sdks/roku/history

If you have any questions regarding a particular release, please post a new topic in this forum and let us know that you are using the Roku version of the IMA SDK. If you're experiencing an error, please also include a link to a test page where we can see the issue.

Thanks,

IMA SDK Team

[Jackson Sui (IMA SDK Team)]

11/11/2019 - 3.35.0

• Service release, no new features.

[Jackson Sui (IMA SDK Team)]

08/05/2022 - 3.56.0

• Service release, no new features.

A note on the inactivity on this thread for previous IMA Roku releases. Since the previous documented release (v3.35.0 on 11/11/2019) there have been a total of 12 version releases. See the IMA Roku release history for details on those releases. This thread should not be properly updated for future Roku releases.

[Jackson Sui (IMA SDK Team)]

09/15/2022 - 3.58.0

• Service release, no new features.

09/12/2022 - 3.57.2

• Adds the StreamFormat class which is used when setting StreamInfo.format.

[IMA SDK]

09/23/2022 - 3.59.0

• Service release, no new features.

ref:_00D1U1174p._5004Q2ePLeR:ref

[IMA SDK]

09/30/2022 - 3.60.0

• Launches Roku Watermark support for all tracking pings.

ref:_00D1U1174p._5004Q2ePLeR:ref

[Jackson Sui (IMA SDK Team)]

03/22/2023 - 3.61.1

• Adds support for traditional and TrueView skippable ads.
• Adds the following ad events:
  • SKIPPABLE_STATE_CHANGED
  • SKIPPED

[Jackson Sui (IMA SDK Team)]

06/29/2023 - 3.62.0

• Adds the 'StreamRequest.createVideoStitcherLiveStreamRequest()' and 'StreamRequest.createVideoStitcherVodStreamRequest()' APIs to support the Google Cloud Video Stitcher API.
• Updates IMA behavior to respect the value set for the 'description_url=' parameter. Previously, IMA would always override the 'description_url=' parameter with what it detected as the correct URL, and change the 'url=' parameter to what had previously been set as the 'description_url='. IMA will still set the 'description_url=' if it is not set in the stream's ad tag URL.

[Jackson Sui (IMA SDK Team)]

09/14/2023 - 3.63.0

• Fixes a bug where the app could crash when encountering invalid adBreakInfo.

[Jackson Sui (IMA SDK Team)]

2024-03-29 - 3.65.0

• Adds createPodVodStreamRequest and StreamManager.loadThirdPartyStream functions for DAI Pod Serving VOD.

2024-02-08 - 3.64.0

• Adds an optional settings parameter to the ima.initSdk function for enabling and disabling SDK features.

[Jackson Sui (IMA SDK Team)]

2024-06-18 - 3.66.0

• Adds ima.StreamRequest.CreateVideoStitcherVodStreamRequestWithVodConfig().
• Adds ima.AdEvent.ICON_FALLBACK_IMAGE_SHOWN and ima.AdEvent.ICON_FALLBACK_IMAGE_CLOSED for when the fallback image dialog is shown and closed.
• Adds ima.AdInfo.skipOffset for the seconds it takes an ad to become skippable.
• Adds ima.StreamRequest.videoStitcherSessionOptions.
• Fixes an issue where ad period events were not called for slate.

[Jackson Sui (IMA SDK Team)]

2024-07-25 - 3.66.1

• Adds a requirement for the networkCode parameter for all live and VOD stream requests.
• Adds creative_id, creative_ad_id, and deal_id to the AdInfo class.
• Adds support for custom VAST tracking events such as skip shown, skip, and click-through.
• Fixes an issue with StreamManager.getCuePoint() for Cloud Video Stitcher VOD streams.
• Fixes a capitalization in StreamManager.createVideoStitcherVodStreamRequestWithVodConfig().

[Jackson Sui (IMA SDK Team)]

2024-11-07 - 3.67.0

• Adds the optional Ad Manager network code parameter for full-service DAI stream requests. Including the parameter lets IMA behavior change to match Ad Manager settings such as programmatic limited ads being disabled.
• Adds VOD stream support for streamManager.loadThirdPartyStream().
• Updates AdBreakInfo.podIndex for live streams. This value now returns the break ID as the pod index for mid-rolls, or 0 for pre-rolls. There are no post-rolls in live streams. The value defaults to -2 for live streams.
• Adds support for StreamManager.getStreamTime() and StreamManager.getContentTime() to Cloud stitching and pod serving streams.
• Fixes an issue where the creative ad id and creative id values were not included in the AdInfo.
• Fixes an issue where the Roku UI icon and skip button are incorrectly positioned.

[Jackson Sui (IMA SDK Team)]

2024-12-19 - 3.67.2

• Adds improvements to currentAd.currentTime to align the currentTime value to the time when the ad event is fired.
• Fixes an issue where certain ad events intermittently did not fire.

[Jackson Sui (IMA SDK Team)]

2025-04-21 - 3.68.1

• Fixes the Divide by Zero edge case runtime error related to ad icons.