Android 6.0指纹识别相关API

本文只对指纹识别相关的API做简单的讲解以及测试，官方文档的相应的API是23，也就是Android6.0才能使用的，但是有些厂商的6.0以下手机也适配了指纹功能，应该有它相应的兼容适配，这里就不做讲解，只讲讲基本的使用。我这里测试用的手机是一加5，Android7.1。

效果图

官方文档介绍

与指纹识别相关的类不是很多，只有一个主类FingerprintManager，主类中有3个内部类，如图：

FingerprintManager类中主要对提供了3个方法，也是我们都需要用的，如图：

• authenticate()：开始指纹验证，也就是开启指纹传感器，需要传入一个回调，用来返回验证的结果。
• hasEnrolledFingerprints()：判断设备是否录入过指纹，录入过就返回true，反之false。
• isHardwareDetected()：判断设备是否支持指纹识别，支持为true，不支持为false。

再讲讲authenticate()方法中要传的参数：

• crypto：用来提高安全性的，里面有对指纹加密的操作。本文不讲这个，后面传入null就可以了。
• cancel：用来取消指纹识别的，传入CancellationSignal对象。
• flags：文档上说应该为0
• callback：回调，指纹扫描后的结果都会进入到回调。
• handler：传null即可。

下面就来实际演示一下。

演示

首先我们需要添加置为识别权限。在6.0以上这个权限是Normal Permissions的，所以不需要运行时申请权限。

<uses-permission android:name="android.permission.USE_FINGERPRINT" />

后面的大致流程是

1. 判断设备是否支持指纹。
2. 判断设备是否处于安全保护中，比如需要设置解锁的密码锁，图案锁才能使用指纹。这个判断需要使用到KeyguardManager屏幕锁的服务。
3. 判断设备是否录入过指纹，没录入过就当然也不能使用。
4. 开始指纹验证。

首先需要拿到FingerprintManager，这里有两种方法，Google推荐第一种，我们也用第一种

        //方式一:使用v4兼容包中的,Google推荐的
        FingerprintManagerCompat fingerprintManagerCompat = FingerprintManagerCompat.from(this);
        //方式二:使用系统服务
        FingerprintManager fingerprintManager = (FingerprintManager) getSystemService(Context.FINGERPRINT_SERVICE);

代码
MainActivity.java

public class MainActivity extends AppCompatActivity {

    private static final String TAG = "MainActivity";
    private TextView tvinfo;
    private FingerprintManagerCompat fingerprintManagerCompat;
    private CancellationSignal cancellationSignal;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        this.tvinfo = (TextView) findViewById(R.id.tv_info);
        //使用v4兼容包中的,Google推荐的
        fingerprintManagerCompat = FingerprintManagerCompat.from(this);


        if (fingerprintManagerCompat.isHardwareDetected()) {   //判断设备是否支持指纹识别
            Log.d(TAG, "支持指纹识别");
        } else {
            Log.d(TAG, "不支持指纹识别");
        }

        KeyguardManager keyguardManager = (KeyguardManager) getSystemService(Context.KEYGUARD_SERVICE);
        if (keyguardManager.isKeyguardSecure()) { //判断设备是否处于安全保护中
            Log.d(TAG, "处于安全保护中");
        } else {
            Log.d(TAG, "未处于安全保护中");
        }

        if (fingerprintManagerCompat.hasEnrolledFingerprints()) {  //判断设备是否已经录入过指纹
            Log.d(TAG, "设备已录入指纹");
        } else {
            Log.d(TAG, "设备未录入指纹");
        }
    }

    /**
     * 开始指纹验证
     *
     * @param view
     */
    public void startAuthen(View view) {
        Log.d(TAG, "startAuthen: 开始指纹验证");
        tvinfo.setText("开始指纹识别，请按下指纹");
        cancellationSignal = new CancellationSignal();
        fingerprintManagerCompat.authenticate(null, 0, cancellationSignal, new FingerprintManagerCompat.AuthenticationCallback() {

            //出现错误的时候会回调,比如:1.取消验证 2.验证了5次都是错误,就会提示验证次数过多
            @Override
            public void onAuthenticationError(int errMsgId, CharSequence errString) {
                Log.i(TAG, "onAuthenticationError: 验证错误,errMsgId:" + errMsgId + ",errString:" + errString);
                tvinfo.setText("验证错误," + errString);
            }

            @Override
            public void onAuthenticationHelp(int helpMsgId, CharSequence helpString) {
                Log.i(TAG, "onAuthenticationHelp: ");
            }

            @Override
            public void onAuthenticationSucceeded(FingerprintManagerCompat.AuthenticationResult result) {
                Log.i(TAG, "onAuthenticationSucceeded: 验证成功");
                tvinfo.setText("验证成功");
            }

            @Override
            public void onAuthenticationFailed() {
                Log.i(TAG, "onAuthenticationFailed: 验证失败");
                tvinfo.setText("验证失败");
            }
        }, null);
    }

    /**
     * 取消指纹验证
     *
     * @param view
     */
    public void cancel(View view) {
        if (cancellationSignal != null) {
            Log.d(TAG, "cancel: 取消指纹验证");
            cancellationSignal.cancel();
        }
    }
}

布局
activity_main.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context="com.fu.fingerprintdemo.MainActivity">


    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="50dp"
        android:orientation="horizontal">

        <ImageView
            android:layout_width="60dp"
            android:layout_height="60dp"
            android:layout_marginLeft="50dp"
            android:src="@mipmap/fingerprint" />

        <TextView
            android:id="@+id/tv_info"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center_vertical"
            android:text="未开启" />
    LinearLayout>


    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="200dp"
        android:gravity="center"
        android:orientation="horizontal">

        <Button
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:onClick="startAuthen"
            android:text="开始" />

        <Button
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:onClick="cancel"
            android:text="取消" />

    LinearLayout>
LinearLayout>

打印的日志

补充说明：
取消的回调会到Error中去。
验证失败指纹传感并没有关闭，可以最多连续验证5次，5次都失败了就会回调到验证错误中，并且会关闭指纹传感器，而且这个时候你把屏幕锁住用指纹也解不开，也会提示尝试次数过多。