About Dynamic Liveness#
Dynamic Liveness estimation aims to determine whether a person is alive by interacting with a camera in your app.
The estimation is performed directly on your device without sending the request to a server.
Interaction types#
To perform the Dynamic Liveness estimation, you can implement the following user interaction types:
- Blinking with either one or two eyes
- Head rotation to the left along the Y axis
- Head rotation to the right along the Y axis
- Head pitch up along the X axis
- Head pitch down along the X axis
In LUNA ID for Android, you need to specify the order in which the interactions will be performed. By default, all user interactions with a camera are disabled and the Dynamic Liveness estimation does not start. For details, see Performing Dynamic Liveness estimation.
In LUNA ID for iOS, you need to do one of the following to perform the Dynamic Liveness estimation:
- Specify a number of interactions to be performed. In this case, the interaction generator produces a random sequence of interactions. For details, see Specify a number of interactions or a sequence of interactions to be performed.
- Define a sequence of interactions to be performed. For details, see Define an interaction sequence or a sequence of interactions to be performed.
Dynamic Liveness defaults#
Interaction timeout#
You can set a timeout for every interaction to be performed. The timeout parameter value defaults to 5 seconds.
For details on setting the timeout, see:
- Set an interaction timeout in LUNA ID for Android
- Set an interaction timeout in LUNA ID for iOS
Timeout between interacions#
You can set a timeout between Dynamic Liveness interactions. The timeout parameter value defaults to 0 seconds.
For details on setting the timeout, see:
- Set a timeout between interactions in LUNA ID for Android
- Set a timeout between interactions in LUNA ID for iOS
Head rotation angles#
A head rotation angle is the angle to which the user must turn their head for the interaction to be considered successful. The angles are:
- Pitch - Limits the head rotation along the X axis.
- Yaw - Limits the head rotation along the Y axis.
- Roll - Limits the head rotation along the Z axis.
In LUNA ID for Android, default head rotation angles are as follows:
- Head rotation angles to the left and right along the Y axis are in the 10-30 degrees range.
- Head pitch up and down angles along the X axis are in the 5-20 degrees range.
In LUNA ID for iOS, default head rotation angles are in the 10-25 degrees range.