StreamSourceSequenceSettings.onPreloaded property

Fires when the engine holds a source pin (pre-warmed, queued, ready). Re-fires whenever the held pin’s stream complement changes so the client can wait for an expected shape (e.g. audio + video both present) before pausing the upstream and choosing release timing.

Held pins remain held until either the autopilot picks them on the previous source’s EOF (default — next pin from the declared sequence) or the client calls releasePreloaded(pin) to override the autopilot pick for the next transition.

Signature:

onPreloaded?: (pin: Pins, streamKeys: StreamKey[]) => void;