Skip to content

Bulk editing LUNA ID parameters#

This topic applies to LUNA ID for iOS only.

In LUNA ID, you can either specify various parameters directly in your code or do this in the LCLunaConfiguration.plist configuration file.

Note: You should use either of the approaches as changing parameter values in your code will not automatically change them in the LCLunaConfiguration.plist file.

Using the the LCLunaConfiguration.plist file allows you to bulk edit all the LUNA ID parameters in one place. The file is located in the following directory:

  • ".\luna-id-sdk_ios_v.X.X.X\frameworks\LunaCore.xcframework\ios-arm64\LunaCore.framework\LCLunaConfiguration.plist"

To apply the parameters, you need to pass them to the LCLunaConfiguration object:

LCLunaConfiguration(plistFromDocuments: plist)

The parameters listed in LCLunaConfiguration.plist are as follows:

LCLunaConfiguration section#

Parameter Default value Description
emptyFrameTime 0 Specifies a timeout within which a face should appear in the frame, otherwise the video session will be terminated.
glassesCheckEnabled false Specifies whether the eye occlusion estimation is enabled.
aggregationsForSunglasses false Specifies whether aggregation for sunglasses and eye state estimation is enabled.
ocrEnabled false Specifies whether OCR (Optical Character Recognition) is enabled.
interactionEnabled true Specifies whether Dynamic Liveness interactions with a camera are enabled.
saveOnlyFaceVideo false Specifies whether to save video files only with a face detected.
trackFaceIdentity false Specifies whether face identity tracking is enabled.
occludeCheck true Specifies whether the face occlusion estimation is enabled.
videoRecordLength 5 Specifies a video stream length, in seconds.
eyeInjury true Specifies whether images with a closed eye can be considered the best shots. For details, see Getting the best shot with faces with closed eyes.
startDelay 0 Specifies a timeout, in seconds, before face recognition begins.
faceTime 0 Specifies a delay, in seconds, to define for how long a user's face should be placed in the face detection bounding box before the best shot is taken.
plistLicenseFileName vllicense.plist Specifies the license file.

LCBestShotConfiguration section#

Parameter Default value Description
borderDistance 10 Specifies the distance from the frame edges and is based on the face detection bounding box size estimation.
minDetSize 200 Specifies a bounding box size.

LCInteractionsConfig section#

Parameter Default value Description
stepsNumber 3 Specifies a number of Dynamic Liveness interactions to be performed.
interactionTimeout 5 Specifies a timeout for every Dynamic Liveness interaction to be performed in a random sequence.
timeoutBetweenInteractions 0 Specifies a timeout between Dynamic Liveness interactions.

LCEstimationThreshold section#

Parameter Default value Description
headPitch 25 Specifies the head rotation along the X axis.
headYaw 25 Specifies the head rotation along the Y axis.
headRoll 25 Specifies the head rotation along the Z axis.
ags 0,2 Specifies the source image score for further descriptor extraction and matching.