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
`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.
`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,5	Specifies the source image score for further descriptor extraction and matching.