Tune capture quality
Most defaults are good. Some environments justify stricter or looser gates.
Relax face quality for low-light environments
const session = sdk.createFaceSession(video, {
faceQualityGate: 'strict',
faceQuality: {
sharpnessMin: 30,
brightnessMin: 60,
},
maxFaceQualityRetries: 8,
});Choose values below the documented defaults to relax, above to tighten. See the configuration reference for current default values.
Verification-grade fingerprint capture
For 1:1 verification, where one clean print is enough, lower the threshold and switch the policy:
const session = sdk.createFingerprintSession(video, {
qualityThreshold: 30,
qualityPolicy: 'any',
centeringTolerance: 0.35,
proximityRange: {
singleMin: 0.3,
singleMax: 2.5,
},
});Force the coarse quality fallback during local development
sdk.createFingerprintSession(video, {
forceQualityFallback: true,
});This uses a coarser scorer that always loads, useful when the full quality stack is not available in your local environment.
Do not ship this flag to production. The fallback accepts captures the production scorer would reject.