From 47396be0257006d8d6764e4ae0e1647d27678a4a Mon Sep 17 00:00:00 2001 From: "Thingvall, Nils" Date: Tue, 12 May 2026 08:18:50 -0600 Subject: [PATCH 1/2] Added information about `adexitrequested` --- .../getting-started/01-sdks/09-roku/02-displaying-ads.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/theoplayer/getting-started/01-sdks/09-roku/02-displaying-ads.md b/theoplayer/getting-started/01-sdks/09-roku/02-displaying-ads.md index 70d10d101589..e0fcd2d16f34 100644 --- a/theoplayer/getting-started/01-sdks/09-roku/02-displaying-ads.md +++ b/theoplayer/getting-started/01-sdks/09-roku/02-displaying-ads.md @@ -128,6 +128,11 @@ sub onAdsPlayingChange( event as object ) end sub ``` +IMPORTANT NOTE: when playing CSAI ads, if the user presses the back button on the remote, the back button press will not be +captured by `onKeyEvent` listeners. To allow your application to handle this back button press, the application +should listen for the `adexitrequested` event on the Ads API and handle the exit logic there. Otherwise, it takes +a second back button press to exit the player. + ### Monitoring RAF The THEOplayer Roku SDK does not expose RAF directly. However, you can still get the data from RAF's callbacks for tracking, buffering, and library version. On the Ads API, there is the `rafProxy` node. This field exposes data from RAF on fields of its own. To substitute for the output from RAF's `setTrackingCallback` method, you could do the following: From c56a4c961dfa3b7306bf64105bd99e765c0cc573 Mon Sep 17 00:00:00 2001 From: "Thingvall, Nils" Date: Tue, 12 May 2026 15:52:56 -0600 Subject: [PATCH 2/2] Switched to an admonition --- .../getting-started/01-sdks/09-roku/02-displaying-ads.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/theoplayer/getting-started/01-sdks/09-roku/02-displaying-ads.md b/theoplayer/getting-started/01-sdks/09-roku/02-displaying-ads.md index e0fcd2d16f34..a7c5add36583 100644 --- a/theoplayer/getting-started/01-sdks/09-roku/02-displaying-ads.md +++ b/theoplayer/getting-started/01-sdks/09-roku/02-displaying-ads.md @@ -128,11 +128,15 @@ sub onAdsPlayingChange( event as object ) end sub ``` -IMPORTANT NOTE: when playing CSAI ads, if the user presses the back button on the remote, the back button press will not be +:::info + +When playing CSAI ads, if the user presses the back button on the remote, the back button press will not be captured by `onKeyEvent` listeners. To allow your application to handle this back button press, the application should listen for the `adexitrequested` event on the Ads API and handle the exit logic there. Otherwise, it takes a second back button press to exit the player. +::: + ### Monitoring RAF The THEOplayer Roku SDK does not expose RAF directly. However, you can still get the data from RAF's callbacks for tracking, buffering, and library version. On the Ads API, there is the `rafProxy` node. This field exposes data from RAF on fields of its own. To substitute for the output from RAF's `setTrackingCallback` method, you could do the following: