FingerprintAuthHelper

最新推荐文章于 2024-04-22 09:35:01 发布

Wei_Leng

最新推荐文章于 2024-04-22 09:35:01 发布

阅读量711

点赞数 1

分类专栏： Android 自定义控件进阶文章标签： FingerprintAuthHelpe

本文链接：https://blog.csdn.net/u014608640/article/details/52848376

版权

Android 自定义控件进阶专栏收录该内容

344 篇文章 0 订阅

订阅专栏

FingerprintAuthHelper

项目地址： pro100svitlo/FingerprintAuthHelper

简介：A small library that allows You to easily manage fingererprint authentication inside your Activity or Fragment on devices with fingerprint scanner and Android M and higher.

A small library that allows You to easily manage fingererprint authentication inside your Activity or Fragment on devices with fingerprint scanner and Android M and higher. Min sdk version 14.

alt text

Usage

Add the dependencies to your gradle file:

    dependencies {
        compile 'com.github.pro100svitlo:fingerprintAuthHelper:1.1.5'
    }

Inside your activity or fragment:


    private FingerprintAuthHelper mFAH;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
    ...
        mFAH = new FingerprintAuthHelper
                .Builder(this, this) //(Context inscance of Activity, FahListener)
                .build();

        if (mFAH.isHardwareEnable()){
            //do some stuff here
        } else {
            //otherwise do
        }
    }

    ...

   @Override
    protected void onResume() {
        super.onResume();
        mFAH.startListening();
    }

    ...

    @Override
    protected void onPause() {
        super.onPause();
        mFAH.stopListening();
    }

    ...

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mFAH.onDestroy();
    }

That's pretty much all what you need to start the work! Full documentation and all options descriptions you can findhere.

Callbacks:

Your activity or fragment must implement FahListener;

    @Override
    public void onFingerprintStatus(boolean authSuccessful, int errorType, CharSequence errorMess) {
        // authSuccessful - boolean that shows auth status
        // errorType - if auth was failed, you can catch error type
        // errorMess - if auth was failed, errorMess will tell you (and user) the reason

        if (authSuccessful){
            // do some stuff here in case auth was successful
        } else if (mFAH != null){
          // do some stuff here in case auth failed
            switch (errorType){
                case FahErrorType.General.LOCK_SCREEN_DISABLED:
                case FahErrorType.General.NO_FINGERPRINTS:
                    mFAH.showSecuritySettingsDialog();
                    break;
                case FahErrorType.Auth.AUTH_NOT_RECOGNIZED:
                    //do some stuff here
                    break;
                case FahErrorType.Auth.AUTH_TO_MANY_TRIES:
                    //do some stuff here
                    break;
            }
        }
    }

    @Override
    public void onFingerprintListening(boolean listening, long milliseconds) {
        // listening - status of fingerprint listen process
        // milliseconds - timeout value, will be > 0, if listening = false & errorType = AUTH_TO_MANY_TRIES

        if (listening){
            //add some code here
        } else {
            //add some code here
        }
        if (milliseconds > 0) {
            //if u need, u can show timeout for user
        }
    }

Updates

v.1.1.5
1. refactoring
2. small bugfix
v.1.1.4
1. fix crashes on Sumsung devices
2. add method isFingerprintEnrolled() to FingerprintAuthHelper
3. small bugfix
v.1.1.3
1. init context must be instance of Activity
2. add method showSecuritySettingsDialog() to FingerprintAuthHelper
3. add help error
v.1.1.2
1. add possibility to set max count of tries