/*
 * Copyright (C) 2018 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package android.hardware.biometrics;

import android.hardware.fingerprint.FingerprintManager;

Interface containing all of the fingerprint-specific constants.
@hide
/** * Interface containing all of the fingerprint-specific constants. * @hide */
public interface BiometricFingerprintConstants { // // Error messages from fingerprint hardware during initilization, enrollment, authentication or // removal. Must agree with the list in fingerprint.h //
The hardware is unavailable. Try again later.
/** * The hardware is unavailable. Try again later. */
public static final int FINGERPRINT_ERROR_HW_UNAVAILABLE = 1;
Error state returned when the sensor was unable to process the current image.
/** * Error state returned when the sensor was unable to process the current image. */
public static final int FINGERPRINT_ERROR_UNABLE_TO_PROCESS = 2;
Error state returned when the current request has been running too long. This is intended to prevent programs from waiting for the fingerprint sensor indefinitely. The timeout is platform and sensor-specific, but is generally on the order of 30 seconds.
/** * Error state returned when the current request has been running too long. This is intended to * prevent programs from waiting for the fingerprint sensor indefinitely. The timeout is * platform and sensor-specific, but is generally on the order of 30 seconds. */
public static final int FINGERPRINT_ERROR_TIMEOUT = 3;
Error state returned for operations like enrollment; the operation cannot be completed because there's not enough storage remaining to complete the operation.
/** * Error state returned for operations like enrollment; the operation cannot be completed * because there's not enough storage remaining to complete the operation. */
public static final int FINGERPRINT_ERROR_NO_SPACE = 4;
The operation was canceled because the fingerprint 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.
/** * The operation was canceled because the fingerprint 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. */
public static final int FINGERPRINT_ERROR_CANCELED = 5;
The FingerprintManager.remove call failed. Typically this will happen when the provided fingerprint id was incorrect.
@hide
/** * The {@link FingerprintManager#remove} call failed. Typically this will happen when the * provided fingerprint id was incorrect. * * @hide */
public static final int FINGERPRINT_ERROR_UNABLE_TO_REMOVE = 6;
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.
/** * 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. */
public static final int FINGERPRINT_ERROR_LOCKOUT = 7;
Hardware vendors may extend this list if there are conditions that do not fall under one of the above categories. Vendors are responsible for providing error strings for these errors. These messages are typically reserved for internal operations such as enrollment, but may be used to express vendor errors not covered by the ones in fingerprint.h. Applications are expected to show the error message string if they happen, but are advised not to rely on the message id since they will be device and vendor-specific
/** * Hardware vendors may extend this list if there are conditions that do not fall under one of * the above categories. Vendors are responsible for providing error strings for these errors. * These messages are typically reserved for internal operations such as enrollment, but may be * used to express vendor errors not covered by the ones in fingerprint.h. Applications are * expected to show the error message string if they happen, but are advised not to rely on the * message id since they will be device and vendor-specific */
public static final int FINGERPRINT_ERROR_VENDOR = 8;
The operation was canceled because FINGERPRINT_ERROR_LOCKOUT occurred too many times. Fingerprint authentication is disabled until the user unlocks with strong authentication (PIN/Pattern/Password)
/** * The operation was canceled because FINGERPRINT_ERROR_LOCKOUT occurred too many times. * Fingerprint authentication is disabled until the user unlocks with strong authentication * (PIN/Pattern/Password) */
public static final int FINGERPRINT_ERROR_LOCKOUT_PERMANENT = 9;
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 fingerprint authentication, such as a "use fingerprint" button.
/** * 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 fingerprint authentication, such as a "use fingerprint" button. */
public static final int FINGERPRINT_ERROR_USER_CANCELED = 10;
The user does not have any fingerprints enrolled.
/** * The user does not have any fingerprints enrolled. */
public static final int FINGERPRINT_ERROR_NO_FINGERPRINTS = 11;
The device does not have a fingerprint sensor.
/** * The device does not have a fingerprint sensor. */
public static final int FINGERPRINT_ERROR_HW_NOT_PRESENT = 12;
@hide
/** * @hide */
public static final int FINGERPRINT_ERROR_VENDOR_BASE = 1000; // // Image acquisition messages. Must agree with those in fingerprint.h //
The image acquired was good.
/** * The image acquired was good. */
public static final int FINGERPRINT_ACQUIRED_GOOD = 0;
Only a partial fingerprint image was detected. During enrollment, the user should be informed on what needs to happen to resolve this problem, e.g. "press firmly on sensor."
/** * Only a partial fingerprint image was detected. During enrollment, the user should be * informed on what needs to happen to resolve this problem, e.g. "press firmly on sensor." */
public static final int FINGERPRINT_ACQUIRED_PARTIAL = 1;
The fingerprint image was too noisy to process due to a detected condition (i.e. dry skin) or a possibly dirty sensor (See FINGERPRINT_ACQUIRED_IMAGER_DIRTY).
/** * The fingerprint image was too noisy to process due to a detected condition (i.e. dry skin) or * a possibly dirty sensor (See {@link #FINGERPRINT_ACQUIRED_IMAGER_DIRTY}). */
public static final int FINGERPRINT_ACQUIRED_INSUFFICIENT = 2;
The fingerprint image was too noisy due to suspected or detected dirt on the sensor. For example, it's reasonable return this after multiple FINGERPRINT_ACQUIRED_INSUFFICIENT or actual detection of dirt on the sensor (stuck pixels, swaths, etc.). The user is expected to take action to clean the sensor when this is returned.
/** * The fingerprint image was too noisy due to suspected or detected dirt on the sensor. * For example, it's reasonable return this after multiple * {@link #FINGERPRINT_ACQUIRED_INSUFFICIENT} or actual detection of dirt on the sensor * (stuck pixels, swaths, etc.). The user is expected to take action to clean the sensor * when this is returned. */
public static final int FINGERPRINT_ACQUIRED_IMAGER_DIRTY = 3;
The fingerprint image was unreadable due to lack of motion. This is most appropriate for linear array sensors that require a swipe motion.
/** * The fingerprint image was unreadable due to lack of motion. This is most appropriate for * linear array sensors that require a swipe motion. */
public static final int FINGERPRINT_ACQUIRED_TOO_SLOW = 4;
The fingerprint image was incomplete due to quick motion. While mostly appropriate for linear array sensors, this could also happen if the finger was moved during acquisition. The user should be asked to move the finger slower (linear) or leave the finger on the sensor longer.
/** * The fingerprint image was incomplete due to quick motion. While mostly appropriate for * linear array sensors, this could also happen if the finger was moved during acquisition. * The user should be asked to move the finger slower (linear) or leave the finger on the sensor * longer. */
public static final int FINGERPRINT_ACQUIRED_TOO_FAST = 5;
Hardware vendors may extend this list if there are conditions that do not fall under one of the above categories. Vendors are responsible for providing error strings for these errors.
@hide
/** * Hardware vendors may extend this list if there are conditions that do not fall under one of * the above categories. Vendors are responsible for providing error strings for these errors. * @hide */
public static final int FINGERPRINT_ACQUIRED_VENDOR = 6;
@hide
/** * @hide */
public static final int FINGERPRINT_ACQUIRED_VENDOR_BASE = 1000; }