Biometrics iOS
1.4
Search
K
Comment on page

SybrinBiometricsConfiguration

A base class conforming to the SybrinCommonConfiguration protocol containing configurable options

Declaration

@objc final public class SybrinBiometricsConfiguration : NSObject, SybrinCommonConfiguration {
@objc final public var license: String { get }
@objc final public var overlayColor: UIColor
@objc final public var overlayLabelTextColor: UIColor
@objc final public var overlaySubLabelTextColor: UIColor
@objc final public var overlayBorderColor: UIColor
@objc final public var overlayBorderThickness: CGFloat
@objc final public var overlayBorderLength: CGFloat
@objc final public var overlayBlurStyle: UIBlurEffect.Style
@objc final public var overlayBlurIntensity: CGFloat
@objc final public var customAuthorizationToken: String?
@objc final public var cameraPosition: AVCaptureDevice.Position
@objc final public var environmentKey: String
@objc final public var overlayBrandingTitleText: String
@objc final public var overlayBrandingTitleColor: UIColor
@objc final public var overlayBrandingSubtitleText: String
@objc final public var overlayBrandingSubtitleColor: UIColor
@objc final public var enableBackButton: Bool
@objc final public var enableOfflinePassiveLiveness: Bool
@objc final public var enableSwipeRightGesture: Bool
@objc final public var showFlashButton: Bool
@objc final public var correlationID: String?
@objc final public var displayToastMessages: Bool
@objc final public var saveImages: Bool
@objc final public var capturedImageCountForTraining: Int?
@objc final public var language: String?
@objc public init(license: String)
}
Only relevant details are shown, boilerplate or standard Swift generated code is omitted

Summary

Public constructors

Signature
Description
Creates a new configuration with the specified license key.

Public variables

Name
Type
Description
license
String
Returns the license key you initialized the configuration with.
UIColor
Changes the color of the overlay.
UIColor
Changes the color of the top instruction message.
UIColor
Changes the color of the bottom instruction message.
UIColor
Changes the color of the border around the cutout.
CGFloat
Changes the thickness of the border around the cutout.
CGFloat
Changes the length of the border around the cutout. Has no effect on this SDK.
UIBlurEffect.Style
Changes the style of the blur applied to the overlay.
CGFloat
Changes the intensity of the blur applied to the overlay.
String
Specifies a custom authorization token to be used during the online calls within the SDK.
AVCaptureDevice.Position
Changes which camera will be used (front or back).
String
An encrypted key that changes the SDKs environment variables.
String
Changes the text of the top label (at the bottom of the screen).
UIColor
Changes the color of the top label (at the bottom of the screen).
String
Changes the text of the bottom label (at the bottom of the screen).
UIColor
Changes the color of the bottom label (at the bottom of the screen).
Bool
Shows or hides the back button.
Bool
Captures face image for later processing
Bool
Enables or disables the swipe right to dismiss functionality.
Bool
Shows or hides the flash button.
String?
A unique user-generated value that associates the individual scan.
Bool
Determines if toast messages will be displayed to the UI.
Bool
Enables or disables if images are auto saved when captured.
language
String
Localises SDK string to desired language
capturedImageCountForTraining
Int
A number indicating how many images must be captured for training

Public constructors

init(license: String)

@objc public init(license: String)
Creates a new configuration with the specified license key.
The license key will be provided by Sybrin. Check out Licensing to find out how to get your key!

Public variables

license

@objc final public var license: String { get }
Returns the license key you initialized the configuration with.

overlayColor

@objc final public var overlayColor: UIColor
Changes the color of the overlay.
Default: UIColor(red: 0, green: 0, blue: 0, alpha: 0.4)

Visual example:

Default
UIColor.green.withAlphaComponent(0.7)

overlayLabelTextColor

@objc final public var overlayLabelTextColor: UIColor
Changes the color of the top instruction message.
Default: UIColor(red: 1, green: 1, blue: 1, alpha: 1)

Visual example:

Default
UIColor.green

overlaySubLabelTextColor

@objc final public var overlaySubLabelTextColor: UIColor
Changes the color of the bottom instruction message.
Default: UIColor(red: 1, green: 1, blue: 1, alpha: 1)

Visual example:

Default
UIColor.green

overlayBorderColor

@objc final public var overlayBorderColor: UIColor
Changes the color of the border around the cutout.
Default: UIColor(red: 1, green: 1, blue: 1, alpha: 1)

Visual example:

Default
UIColor.green

overlayBorderThickness

@objc final public var overlayBorderThickness: CGFloat
Changes the thickness of the border around the cutout.
Default: 2
Setting this to 0 will disable the border

Visual example:

Default
10

overlayBorderLength

@objc final public var overlayBorderLength: CGFloat
Changes the length of the border around the cutout. Has no effect on this SDK.
Default: 0

overlayBlurStyle

@objc final public var overlayBlurStyle: UIBlurEffect.Style
Changes the style of the blur applied to the overlay.
Default: UIBlurEffect.Style.dark

Visual example:

Default
Light

overlayBlurIntensity

@objc final public var overlayBlurIntensity: CGFloat
Changes the intensity of the blur applied to the overlay. 1 being the most blur applied. 0 being no blur applied.
Default: 0.8
Setting this to 0 will disable the blur

Visual example:

Default
0

customAuthorizationToken

@objc final public var customAuthorizationToken: String?
Specifies a custom authorization token to be used during the online calls within the SDK.
Default: nil

cameraPosition

@objc final public var cameraPosition: AVCaptureDevice.Position
Changes which camera will be used (front or back).
Default: AVCaptureDevice.Position.front

environmentKey

@objc final public var environmentKey: String
An encrypted key that changes the SDKs environment variables.

overlayBrandingTitleText

@objc final public var overlayBrandingTitleText: String
Changes the text of the top label (at the bottom of the screen).
Default: "INNOVATIONS LAB"

Visual example:

Default
Example Text

overlayBrandingTitleColor

@objc final public var overlayBrandingTitleColor: UIColor
Changes the color of the top label (at the bottom of the screen).
Default: UIColor(red: 1, green: 1, blue: 1, alpha: 1)

Visual example:

Default
UIColor.green

overlayBrandingSubtitleText

@objc final public var overlayBrandingSubtitleText: String
Changes the text of the bottom label (at the bottom of the screen).
Default: "A DIVISION OF SYBRIN"

Visual example:

Default
Example Text

overlayBrandingSubtitleColor

@objc final public var overlayBrandingSubtitleColor: UIColor
Changes the color of the bottom label (at the bottom of the screen).
Default: UIColor(red: 1, green: 1, blue: 1, alpha: 1)

Visual example:

Default
UIColor.green

enableBackButton

@objc final public var enableBackButton: Bool
Shows or hides the back button.
Default: true

Visual example:

Default
False

enableOfflinePassiveLiveness

@objc final public var enableOfflinePassiveLiveness: Bool
Enables if passive liveness should only capture image for later use.
Default: false

enableSwipeRightGesture

@objc final public var enableSwipeRightGesture: Bool
Enables or disables the swipe right to dismiss functionality.
Default: true

showFlashButton

@objc final public var showFlashButton: Bool
Shows or hides the flash button.
Default: false
The flash button will only show (when enabled) if the flash is available (like on the back camera).

Visual example:

Default
True

correlationID

@objc final public var correlationID: String?
A unique user-generated value that associates the individual scan. This value can be used in customer journeys, to link multiple independent scans (for example, one execution of face compare and one execution of liveness) with each other as the same customer.
The user must manually set and control this value.
Default: nil

displayToastMessages

@objc final public var displayToastMessages: Bool
Determines if toast messages will be displayed to the UI.
Default: true

saveImages

@objc final public var saveImages: Bool
Enables or disables if images are auto saved when captured.
Default: false

capturedImageCountForTraining

@obj final public var capturedImageCountForTraining: Int
Specifies the number of images captured for training on facial recognition.
Default: 4

language

@obj final public var language: String
Specifies the language used by the SDK strings
Default: system Language

Where this is used