Supplies a DRM license token. Called on every license request — including renewals — so implementations must return a currently valid token each time (fetch it, refresh auth, etc.). Never cache a token beyond its lifetime; the SDK never caches it at all.

DrmTokenRequest

class DrmTokenRequest(val licenseUrl: String, val mediaItem: OGMediaItem)

Context for a DrmTokenProvider.getToken call.

InternalOGPlayerApi

@Target(allowedTargets = [AnnotationTarget.PROPERTY, AnnotationTarget.FUNCTION, AnnotationTarget.CLASS])

annotation class InternalOGPlayerApi

Marks declarations that are internal to the ogplayer SDK modules. They carry no compatibility guarantees and must not be used by apps.

LiveInfo

class LiveInfo(val streamType: StreamType, val dvrWindowMs: Long, val atLiveEdge: Boolean, val latencyMs: Long, val playheadWallClockMs: Long? = null)

Runtime facts about the current live stream. Null for VOD.

OGAnalyticsListener

fun interface OGAnalyticsListener

Receives AnalyticsEvents from an OGPlayer. Host apps adapt these to their analytics vendor (Conviva, Tealium, ...).

OGMediaItem

class OGMediaItem

Immutable description of a piece of media to play.

OGPlayer

interface OGPlayer

The ogplayer playback engine.

OGPlayerError

sealed class OGPlayerError

Sealed hierarchy of playback errors surfaced by the SDK.

OGPlayerSdk

object OGPlayerSdk

Entry point metadata for the ogplayer SDK.

PlaybackListener

interface PlaybackListener

Callbacks for playback lifecycle events. All methods have empty defaults.

PlaybackState

enum PlaybackState : Enum<PlaybackState>

High-level playback state of an OGPlayer.

StreamType

enum StreamType : Enum<StreamType>

Declared stream type of a media item. Drives default UI behavior.

SubtitleSource

class SubtitleSource(val url: String, val language: String, val label: String? = null, val isDefault: Boolean = false)

A sideloaded subtitle file (WebVTT/TTML/SRT) attached to a media item.

SubtitleStyle

class SubtitleStyle

Caption rendering style. When applyEmbeddedStyles is false (default), this styling always wins over in-stream text styling, while WebVTT positioning (line/position/align cue settings) is always preserved.

TextTrack

class TextTrack(val id: String, val language: String?, val label: String?, val isSelected: Boolean)

A selectable subtitle/caption track of the current media.

VideoQuality

class VideoQuality(val id: String, val width: Int, val height: Int, val bitrate: Int, val isSelected: Boolean)

A selectable video rendition of the current media.

VolumeControlMode

enum VolumeControlMode : Enum<VolumeControlMode>

How the player's volume slider behaves.