Child index for position label in Roku's built-in trickPlayBar component. The trickPlayBar is part of the Video node and doesn't expose child IDs, so we must access by index. Fallback search logic exists if Roku changes the structure. Defined at module level (BrighterScript const requirement) to provide immutability and enable reuse across multiple helper functions if needed.

Returns the metadata in the response — main.bs's transport dispatcher calls roAppManager.SetNowPlayingContentMetaData() on the MAIN thread (roAppManager can't be created on the render thread, where this callFunc executes).

availSubtitleTrackIdx: Returns Roku's index for requested subtitle track

Check the the buffering has not hung

Check media segments and trigger appropriate actions based on current playback position

Checks if we need to display the Next Episode button

findTrickPlayBarPositionLabel: Defensively finds the position text label in trickPlayBar

Tries multiple strategies to find the Label that displays seek position:

1. Expected child index (8) - fast path for current Roku OS
2. Search for FIRST Label child - position text comes before remaining time
3. Return invalid if not found - feature gracefully degrades

Forces playback to finished state for proper watched-status and auto-play. Triggers synchronous teardown (onState -> ViewCreator -> popScene -> onDestroy), invalidating all m. references. Callers MUST return immediately after calling.

getCurrentChapterIndex: Finds current chapter index

handleChapterListAction: Handles action to show chapter list

handleChapterSkipAction: Handles user command to skip chapters in playing video

handleHideAction: Handles action to hide OSD menu

handleItemSkipAction: Handles user command to skip items

handleShowAudioMenuAction: Handles action to show audio selection menu

handleShowSubtitleMenuAction: Handles action to show subtitle selection menu

handleShowVideoInfoPopupAction: Handles action to show video info popup

handleShowVideoSourceMenuAction: Handles action to show video source selection menu

handleTransport: Roku voice transport handler. Called from source/main.bs when an roInputEvent with info.type = "transport" arrives and the active scene is this player.

Returns { status: "" } per roInput.EventResponse() — Roku OS uses the status to render the appropriate HUD message. Codes used here:

• success / success.seek-start / success.seek-end — op completed (with bounds note)
• error.redundant — state already matches request (e.g. pause-while-paused)
• error.generic — op semantically unsupported in this context
• unhandled — command we don't recognize; lets Roku show "Command not available"

See https://github.com/rokudev/dev-doc — docs/DEVELOPER/media-playback/voice-controls/transport-controls.md

handleVideoPlayPauseAction: Handles action to either play or pause the video content

Reuse the OSD itemNext code path so Live-TV channel advance, queue advance, and Episode→next-Episode all behave identically to pressing the on-screen Next button.

Hide the Next Episode notification

Check if a VideoNotification is visually present (including during fade-out animation)

Set caption url to server subtitle track and run the fetch task

Only setup caption items if captions are allowed

Event handler for when audioIndex changes. For direct play: switches audio track directly using Roku's availableAudioTracks (no stop/reload needed since all tracks are in the container). For transcoded — or when the newly-selected stream exceeds the device's audio capability (e.g. switching from stereo back to an 8ch track on a stereo Roku) — must reload so the server transcodes the new selection.

Event handler for when video content field changes

onDestroy: Full teardown releasing all resources before component removal Called by SceneManager when popping this scene

Handler for Next Episode notification action

Safety net: ensure focus isn't orphaned after notification dismissal animation completes

onOSDAction: Process action events from OSD to their respective handlers

When Video Player state changes

Handler for segment notification action

When Video Player state changes

Event handler for when selectedSubtitle changes

Called when Roku's trickPlayBar position text changes Parses the time string to get seek position and syncs our carousel This ensures carousel stays in sync with Roku's authoritative seek position

onVideoSourceChange: Handles video source switching from OSD Saves position, stops playback, re-selects audio for the new source's streams, and reloads video content with the new MediaSource ID.

populateChapterMenu: ' Parse chapter data from API and appeand to chapter list menu

Report playback to server

retryPlayback: Re-runs the content loader from the current position with updated task flags. Used by error handlers to retry without exiting the player.

30s end-slack matches the Roku transport-controls reference example for video — clamping shy of duration prevents the player from firing end-of-content immediately.

Determines if custom subtitles should be used for the current selection Custom subtitles should only be used for external subtitles when the user has enabled the setting

Show the Next Episode notification with countdown text

stateAllowsOSD: Check if current video state allows showing the OSD

m.isSwitchingChannel prevents the old view's onState("stopped") from hiding the spinner before the new VideoPlayerView finishes loading.

Toggles visibility of custom subtitles and sets captionTask's player state

Skip an active media segment (intro/recap/etc.) if one is currently in-window. Returns true if a segment was skipped, false if no active segment.

Removes old subtitle lines and adds new subtitle lines

Update Next Episode countdown text

Updates trickplay carousel with index calculated from video position Snaps to thumbnail boundaries for cleaner UX