The device rotated (reported by the view layer once on attach with the initial value, then on change). The vertical feed does not emit it — the feed is portrait by design. Distinct from FullscreenChanged: the two diverge on button-driven fullscreen and on tablets.

Pause

class Pause : AnalyticsEvent

PictureInPictureChanged

data class PictureInPictureChanged(val isActive: Boolean) : AnalyticsEvent

The player entered or left picture-in-picture (reported by the view layer; headless integrations do not emit it).

Play

class Play : AnalyticsEvent

PlaybackRecovered

data class PlaybackRecovered(val reason: RecoveryReason, val positionMs: Long) : AnalyticsEvent

The SDK recovered playback silently — no Error was surfaced, but the viewer saw a short rebuffer (typically 1–4 s). Emitted so QoE pipelines can count field recoveries the app never observes.

PlaybackStarted

data class PlaybackStarted(val startupMs: Long) : AnalyticsEvent

First video frame of a load rendered. startupMs is wall time from OGPlayer.load to that frame — time-to-first-frame, the industry's primary startup metric. Emitted once per load; audio-only streams, which never render a frame, do not emit it.

QualitySnapshot

data class QualitySnapshot(val positionMs: Long, val bufferedMs: Long, val bandwidthEstimateBps: Long, val droppedFramesTotal: Int, val liveLatencyMs: Long? = null, val atLiveEdge: Boolean? = null) : AnalyticsEvent

Periodic playback-quality sample, emitted every 10s while playing. liveLatencyMs/atLiveEdge are populated for live streams only — the live-latency measurement rides the existing cadence.

Seek

data class Seek(val fromMs: Long, val toMs: Long) : AnalyticsEvent

TextTrackChanged

data class TextTrackChanged(val id: String?, val language: String?) : AnalyticsEvent

A text track was selected (id null = subtitles off) — accessibility usage reporting.

VerticalFeedImpression

data class VerticalFeedImpression(val index: Int, val url: String) : AnalyticsEvent

Vertical feed: the item at index became the visible page.

VerticalFeedItemLooped

data class VerticalFeedItemLooped(val index: Int, val loopCount: Int) : AnalyticsEvent

Vertical feed: the active item finished a loop (loopCount so far).

VerticalFeedItemWatched

data class VerticalFeedItemWatched(val index: Int, val url: String, val watchTimeMs: Long, val loopCount: Int) : AnalyticsEvent

Vertical feed: the item at index left the screen — the impression summary. watchTimeMs is actual watched wall-time on this item (loops included), loopCount how many times it restarted.

VolumeChanged

data class VolumeChanged(val volume: Float, val muted: Boolean) : AnalyticsEvent

The viewer changed volume or mute — the muted-to-sound conversion metric for autoplay/ad measurement.

Properties

assetUrl

var assetUrl: String?

URL of the media item this event belongs to (null before a load).

sessionId

var sessionId: String?

Playback-session id: a fresh UUID minted by every OGPlayer.load, stamped on each event of that session so consumers can key their pipelines without inventing their own ids. Null only for events emitted before the first load.