minKeyframeInterval property
int
get
minKeyframeInterval
Minimum number of frames between keyframes. Default 0 disables.
When > 0, "soft" keyframe triggers — requestKeyframe, scene-cut
detection (sceneCutMeanAbsDiff), and drop-recovery escalation
(forceKeyAfterConsecutiveDrops) — are deferred until at least
this many frames have elapsed since the last keyframe. A pending
requestKeyframe is held and fires on the first eligible frame.
The hard upper bound keyframeInterval and forceKey: true on
encodeFrame still take effect regardless of this minimum.
Must satisfy 0 <= minKeyframeInterval <= keyframeInterval.
Must satisfy 0 <= minKeyframeInterval <= keyframeInterval.
Mutable at runtime via setMinKeyframeInterval.
Implementation
int get minKeyframeInterval => _minKeyframeInterval;