publishFramingSubject

fun publishFramingSubject(cx: Float, cy: Float, width: Float, height: Float)

Publishes the subject that auto-framing follows, as a box normalised to 0.0..1.0.

Requires VideoEffectsConfig.Framing enabled through setVideoEffects. The SDK ships no detector, so with nothing published here the video is sent unchanged and no error is reported. Call it for every box your detector produces, not once.

Coordinates are relative to the frame after any geometry crop, not the raw camera frame. A smaller box zooms further, up to Framing.maxZoom.

Safe to call from any thread.

Parameters

cx

the subject centre's x, 0.0..1.0 across the frame.

cy

the subject centre's y, 0.0..1.0 down the frame.

width

the subject's width as a fraction of the frame. Zero or less means "no subject": the crop returns to the full frame.

height

the subject's height, same rule as width.