Language

BiometricErrorCode Enum

Definition

public enum BiometricErrorCode
type BiometricErrorCode = 
Inheritance
BiometricErrorCode

Fields

Name Value Description
HwUnavailable 1

The hardware is unavailable. Try again later.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_HW_UNAVAILABLE.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

UnableToProcess 2

Error state returned when the sensor was unable to process the current image.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_UNABLE_TO_PROCESS.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Timeout 3

Error state returned when the current request has been running too long. This is intended to prevent programs from waiting for the biometric sensor indefinitely. The timeout is platform and sensor-specific, but is generally on the order of 30 seconds.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_TIMEOUT.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

NoSpace 4

Error state returned for operations like enrollment; the operation cannot be completed because there's not enough storage remaining to complete the operation.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_NO_SPACE.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Canceled 5

The operation was canceled because the biometric sensor is unavailable. For example, this may happen when the user is switched, the device is locked or another pending operation prevents or disables it.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_CANCELED.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Lockout 7

The operation was canceled because the API is locked out due to too many attempts. This occurs after 5 failed attempts, and lasts for 30 seconds.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_LOCKOUT.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Vendor 8

OEMs should use this constant if there are conditions that do not fit under any of the other publicly defined constants, and must provide appropriate strings for these errors to the BiometricPrompt.AuthenticationCallback.onAuthenticationError(int,CharSequence) callback. OEMs should expect that the error message will be shown to users.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_VENDOR.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

LockoutPermanent 9

The operation was canceled because BIOMETRIC_ERROR_LOCKOUT occurred too many times. Biometric authentication is disabled until the user unlocks with strong authentication (PIN/Pattern/Password)

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_LOCKOUT_PERMANENT.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

UserCanceled 10

The user canceled the operation. Upon receiving this, applications should use alternate authentication (e.g. a password). The application should also provide the means to return to biometric authentication.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_USER_CANCELED.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

NoBiometrics 11

The user does not have any biometrics enrolled.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_NO_BIOMETRICS.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

HwNotPresent 12

The device does not have a biometric sensor.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_HW_NOT_PRESENT.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

NoDeviceCredential 14

The device does not have pin, pattern, or password set up. See BiometricPrompt.Builder.setAllowedAuthenticators(int), Authenticators.DEVICE_CREDENTIAL, and BiometricManager.canAuthenticate(int).

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_NO_DEVICE_CREDENTIAL.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

SecurityUpdateRequired 15

A security vulnerability has been discovered and the sensor is unavailable until a security update has addressed this issue. This error can be received if for example, authentication was requested with Authenticators.BIOMETRIC_STRONG, but the sensor's strength can currently only meet Authenticators.BIOMETRIC_WEAK.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_SECURITY_UPDATE_REQUIRED.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

IdentityCheckNotActive 20

Identity Check is currently not active. This device either doesn't have this feature enabled, or it's not considered in a high-risk environment that requires extra security measures for accessing sensitive data.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_IDENTITY_CHECK_NOT_ACTIVE.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

NotEnabledForApps 21

Biometrics is not allowed to verify the user in apps.

Android reference for android.hardware.biometrics.BiometricPrompt.BIOMETRIC_ERROR_NOT_ENABLED_FOR_APPS.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to