watchPosition

open fun watchPosition(positionSec: Double, onReached: () -> Unit): () -> Unit?

Calls onReached once, on the main thread, when playback reaches positionSec (seconds on the currentTime axis, ahead of the playhead), unless the returned function is called first. Driven by the player's own position, so it follows buffering and rate changes. Null when the player cannot signal a position; the SDK then uses a timer for the pre-marker trigger.