Android指纹识别，提升APP用户体验，从这里开始( 二 ) _Android

【Android指纹识别，提升APP用户体验，从这里开始】我的代码中提供了一个 Cipher 的帮助类，可用来创建一个 Cipher 对象，可参考使用。

int flags

可选标志，暂无用处，传 0 即可。只用于 Android 6.0 。

CancellationSignal cancel

这个对象的作用是用来取消指纹扫描器的扫描操作。比如在用户点击识别框上的“取消”按钮或者“密码验证”按钮后，就要及时取消扫描器的扫描操作。
不及时取消的话，指纹扫描器就会一直扫描，直至超时。这会造成两个问题：
(1) 耗电
(2) 在超时时间内，用户将无法再次调起指纹识别。
同样，这个参数在 Android 6.0 是 @Nullable，在 Android 9.0 之后是 @NonNull ，由于上述的原因，不建议传 null。

FingerprintManagerCompat.AuthenticationCallback callback

指纹识别结果的回调接口，是 @NonNull 的，其中声明了如下几个方法：

文章插图

重点关注一下 onAuthenticationError() 和 onAuthenticationHelp() 两个方法，当出现指纹识别异常时会被回调：
(1) 参数 errString 和 helpString 是具体的异常信息，例如“手指移动过快”、“验证失败”等。这个异常信息是由系统提供的，目前看到的情况是系统会根据应用使用的语言匹配对应的异常信息。
应用有做国际化的小伙伴，对系统匹配对应语言的异常信息不放心的话，可根据 errMsgId 和 helpMsgId 自行处理。
(2) 参数 errMsgId 和 helpMsgId 是某个异常的 Id 标识，有很多，这里不赘述，各位请自行查看开发者文档。注意注意的是，在 Android 6.0 上和 Android 9.0 上有差别。

Handler handler

这个参数用于 Android 6.0，是 @Nullable 的，作用是告诉系统使用这个 Handler 的 Looper 处理指纹识别的 Message 。默认就是交给主线程的 Looper 处理，传 null 即可。

Executor executor （补充，是）

这个参数是 Android 9.0 Api BiometricPrompt.authenticate() 中的参数，是 @NonNull的，作用与上个参数 Handler handler 类似，用来分发指纹识别的回调事件。
当通过主线程进行分发时，可通过 Context#getMainExecutor() 传参；
当通过共享线程池进行分发时，可通过 AsyncTask#THREAD_POOL_EXECUTOR 传参。
指纹识别的实践在指纹识别功能的实践中，我将其做成了开源库发布在了 Github 上，可通过 gradle 进行依赖，使用方法比较简单，两三行代码，再传入一个验证结果监听即可。
下面对部分实现过程做一下介绍，详细的 Api 及源码请移步 Github 。
Github 地址：https://github.com/ZuoHailong/BiometricPrompt
示例Android 6.0 指纹识别框，开发者自定义：

文章插图

Android 9.0 指纹识别框，系统提供：

文章插图

其中指纹 icon 和取消按钮的文字颜色，由属性 colorPrimary 的颜色值决定。
指纹识别管理类FingerprintVerifyManager 是指纹识别库的入口，对指纹识别进行管理，通过 FingerprintVerifyManager.Builder 对指纹识别进行初始化。
在这个类中，有根据手机系统版本调用不同的指纹识别 Api（FingerprintManagerCompat或者 BiometricPrompt），其中 BiometricPrompt 支持开启或者关闭，默认关闭。
public FingerprintVerifyManager(Builder builder) { IFingerprint fingerprint; // >= Android P if (AndrVersionUtil.isAboveAndrP()) { //在 Android P 上是否展示系统提供的识别框 if (builder.enableAndroidP) fingerprint = FingerprintAndrP.newInstance(); else fingerprint = FingerprintAndrM.newInstance(); } else if (AndrVersionUtil.isAboveAndrM()) {// Android 6.0 =< Version fingerprint = FingerprintAndrM.newInstance(); } else {// < Android 6.0 ，官方未开放指纹识别，某些机型自行支持的情况暂不做处理 builder.callback.onError(builder.context.getString(R.string.biometricprompt_verify_error_below_m)); return; } …… fingerprint.authenticate(builder.context, bean, builder.callback); }其中 IFingerprint 是指纹识别的接口，兼容 Android 6.0 的 FingerprintAndrM 和兼容 Android 9.0 的 FingerprintAndrP 都实现了此接口。
public interface IFingerprint { /** * 初始化并调起指纹识别 * * @param context * @param verificationDialogStyleBean 指纹识别框样式 * @param callback 通知开发者指纹识别结果 */ void authenticate(Activity context, VerificationDialogStyleBean verificationDialogStyleBean, FingerprintCallback callback);}