Roku SDK Changelog

All notable changes to the StreamLayer Roku SDK are documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning. The most recent version appears first.

For the public methods referenced below, see the API Reference. To get up and running, start with the Integration Guide.

Versioning

The SDK reports its current version at runtime via getVersion(). The version string also accompanies every Analytics request through the sl-sdk-version header.

[2.11.0] - 2026-08-26

Added

Host-driven ad units — host apps can provide a VAST tag and explicitly select the ad shape instead of relying on the creative. showPauseAd supports pause-ad formats (PauseVastFullBleed, PauseVastAd, PauseAdSidebar11, PauseAdSidebar21), while showAd supports playback formats (SideBar21, LBar21, SideBarImageOnly, LBarImageOnly, SideBySide). Omitting the type preserves the previous behaviour
Host-driven standard ad units use the existing programmatic pipeline, including ad pods, impressions, creativeView, and video quartile tracking
Host ads can optionally show a notification teaser using the same title, description, and sponsor logo as the ad
isEventReady — new observable field indicating when the SDK has resolved an event and is ready to serve ads

Changed

showPauseAd now accepts { vastUrl, type, isNotificationEnabled }

Fixed

Fixed analytics so every ad in a VAST pod is counted correctly
Fixed heartbeat and feed polling stopping when video pause ads temporarily pause the host player
Fixed startup failure and potential channel crash when an ad card has no background image
Fixed notification startup when no background image is configured
Fixed notification button labels when no button colour is configured
Fixed Poll and Trivia answer percentage fills so they reflect the actual vote share
Fixed Trivia so the correct answer is marked whether or not the viewer selected it
Fixed Poll answer styling so answers are not treated as correct or incorrect
Fixed previously answered Polls reopening when shown again
Vote results now remain visible for 3.5 seconds

[2.10.0] - 2026-08-14

Added

Image-Only layout for Standard Ad units — L-Bar and Sidebar can render a single full-bleed advertiser image instead of the structured template, while keeping the close button, CTA, and the 6:1 bottom banner on L-Bar; Template remains the default
Full-bleed pause ad for programmatic VAST MP4 creatives
Notification background image — Sidebar notifications now use their own background when configured, falling back to the shared question background
Programmatic ad pods — VAST responses containing multiple ads now play them sequentially within the same card, with transitions and an "X of Y" counter; each ad uses its own creative, sponsor logo, and QR target

Fixed

Fixed notification sponsor logo fallback when Studio leaves the notification logo unset; the advertiser logo is used when "use general logo" is enabled, otherwise the notification uses its own logo or falls back to the campaign logo

[2.9.1] - 2026-08-06

Fixed

Unified sponsor logo sizing and alignment across all ad formats
Fixed the Prediction result overlay for programmatic cards
Smoothed the Side-by-Side transition back to the host player
Fixed Side-by-Side QR/CTA panel and return-to-video button alignment; removed redundant CTA instructions

[2.9.0] - 2026-06-30

Added

Programmatic ads (GAM, PubMatic, Magnite) on standard ad units (L-Bar, Sidebar, Side-by-Side) and interactive units (Trivia, Poll, Insight, Prediction)
Multi-ad playback within a single overlay, with an "X of Y" counter
Prediction results now open in the Sidebar overlay and are revealed in phases: results announcement, question, viewer pick, and outcome
Side-by-Side support for a static banner image

Fixed

Corrected analytics events across standard ad units, Side-by-Side, Poll, and Trivia
Fixed missing sponsor logos on Trivia and Poll cards without a background image
Insight — the remote's Play button now starts the media
Insight — description text no longer fades on focus
Insight — fixed spacing around the description plate so it no longer overlaps the sponsor logo
Insight — added a drop shadow behind focused media and descriptions
Prediction — the picked answer is now marked as selected rather than correct
Prediction — fixed vote percentages showing a fixed 100% instead of the actual result
Prediction — the question is now shown on the "Stay tuned" view after voting
Fixed programmatic interactive cards not appearing when the VAST response has no sponsor logo
Side-by-Side — fixed send-info status alignment, centred descriptions when no buttons are present, and moved focus to the close button after Send Email
"Return to Video" no longer reports a button-navigation event

[2.8.0] - 2026-05-28

Added

SideBySide ad unit — QR/CTA panel with return-to-video and send-to-user (Email and Phone) account buttons.
Trivia pause ad unit — full-bleed variant.

Changed

Unanswered poll and trivia ad units now stay open after moderator deactivation.

Fixed

Trivia ad unit — restored the missing close (X) button on the LBar and SideBar formats.
Insight ad unit — corrected detail focus and scrollbar visuals, capped the body at 6 lines, and fixed the description text size.
Poll and trivia ad units — resolved a card freeze after voting; focus now moves to the close button immediately on answer selection instead of waiting for the vote network response (LBar and SideBar).
Poll ad unit — fixed a vote-result crash caused by an invalid m.botoomGradient access in onVoteResultTimerFired (LBar and SideBar).
Insight ad unit without media — the description detail no longer overlaps or breaks the StreamLayer Element; no-media factoids now route through the regular preview flow, with initial focus on the close button for image-only and no-media variants (LBar and SideBar).
Trivia, prediction, and pause-trivia ad units — listHasFocus is now broadcast from the parent so answer rows dim deterministically when focus leaves the list (for example, to the close or resume button).
Trivia ad unit — fixed answer focus getting stuck on fast navigation or when returning from the close button; focus switching is now direction-based and reacts on the first tick.
Trivia ad unit (LBar and SideBar) now auto-closes after the vote result is shown.
Insight ad unit — media is no longer shown when the "No media" option is selected.
Insight ad unit — corrected body text indentation and selection-highlight rounding.
Poll and trivia ad units — added a peek-scroll hint to the answer list and dynamic fit based on title height.

[2.7.0] - 2026-05-06

Added

Prediction ad unit — LBar and SideBar formats, with a results overlay.
Send to User button on the standard ad units (LBar 11/21 and SideBar 11/21) — Email and Phone variants.

Changed

Sponsor logo unified under the sponsor.{logo, transparentLogo} pattern.
Webhook handlers consolidated into WebhookManager with eventId routing.

[2.6.0] - 2026-04-14

Added

Poll ad unit — LBar and SideBar formats.

Changed

Analytics tracking extended to cover poll ad unit interactions.

[2.5.0] - 2026-04-06

Added

Trivia ad unit — LBar and SideBar formats.

[2.4.0] - 2026-04-01

Added

Insight ad unit with factoid support (SideBar and LBar formats).

[2.3.0] - 2026-03-12

Added

Trivia pause ad unit — SideBar format.

Fixed

Heartbeat issue after closing a Bell ad unit with Back and resuming the stream.

[2.2.2] - 2026-03-13

Changed

Removed unused closeRequested handlers and observers.
Delegated the VAST pause ad lifecycle to the host application.
Back button now passes the event to the host for close handling without resuming.
Play button triggers the resumeRequested callback and closes the ad unit with KIND_STREAM_RESUMED analytics.
Separated KIND_EXTERNAL_AD_CLOSED (Back) and KIND_STREAM_RESUMED (Play) analytics events.

[2.2.1] - 2026-03-10

Changed

Updated gradient styling for the Bell ad unit.
Added the sl-sdk-version header to Analytics requests.

Fixed

Fixed missing analytics events after a second pause.
Fixed the semitransparent background for the Bell ad unit.

[2.2.0] - 2026-02-12

Added

Pause ad unit full-bleed overlay support.
Pause ad unit VAST prefetch cache manager.
Bell ad unit analytics support.
Authentication flow using JWE-based JWT exchange.

Changed

Added setVastModeEnabled configuration support across playback sessions.
Updated analytics tracking and payload structure.

[2.1.0] - 2026-01-07

Added

Live Moment Notification support for SDK events.
SideBar notification format.

Changed

Improved analytics event handling.

Note

This release builds on the 2.0 runtime and focuses on extending event notification capabilities.

[2.0.0] - 2025-12-17

Added

Pause ad unit VAST feature support.
Play button and resume events for the host player.
Sponsor logo dimension loading to mitigate texture warnings.

Changed

Improved promo visibility state handling.
Updated the SDK architecture to support advanced ad unit and playback flows.
Refactored the SDK structure and player attachment interface.
Improved the SDK connection module.

Fixed

Crash caused by unsafe JSON enum mapping.
Promo visibility state issues during presentation.

Note

This release introduces a major update to the SDK runtime and ad unit flow architecture.

[1.0.0] - 2025-09-30

Added

Initial StreamLayer Roku SDK package.
Authentication and organization management via AuthManager.
EventManager for event-related logic.
Feed, leaderboard, and SDK settings API integrations.
Device ID support for API requests.
Centralized logging utility.
SideBar 11 and SideBar 21 interactive ad units.
LBar 11 and LBar 21 interactive ad units.
AnalyticsManager for tracking SDK usage, events, and ad unit interactions.
SDK callback interface for promo and event notifications.
QR Code generator component.

Note

First production-ready release of the StreamLayer Roku SDK.