Android6.0指纹识别开发实例

Android M指纹的资料太少，经过一段时间阅读原生Android代码，写了以下例子，贡献出来给需要帮助的人。

　　以下内容基于64位的高通CPU，搭载fpc1020芯片，此部分代码在原生android上做了更改，以应付工厂指纹的测试。原生android指纹录入需要采集10次（因不同的芯片而定）。

　　代码简单说明：

　　1. FingerPrintEnrollBase类：

　　重要的是

Java代码

 public interface Listener {
        void onEnrollmentHelp(CharSequence helpString);
         void onEnrollmentError(int errMsgId, CharSequence errString);
        void onEnrollmentProgressChange(int steps, int remaining);
 }

　　这个接口。

　　1)onEnrollmentHelp函数:是下层返回的指纹操作帮助信息。

　　2）onEnrollmentError函数是下层返回的错误信息，errMsgId是错误信息类型，其中1表示指纹硬件不可用，3表示超时，5表示操作已取消。errString是errMsgId对应的文字信息，有需要的自己实验就知道了。

　　3）onEnrollmentProgressChange（）函数是显示当前指纹的采集情况，steps：总共需要录入多少次；remaining是剩余多少次，我在此函数中有打印Log。

　　2. FingerPrintActivity是主Activity类，FingerPrintEnrollBase是指纹Base类。

　　需要特别说明的是，在FingerPrintEnrollBase类中有一句：private byte[] mToken = new byte[69];这个数组正常情况是通过输入密码后经由framework层向hal层申请的，我这里为了省去验证那一块的代码，通过sizeof(hw_auth_token_t)计算出来的为69，需要的请依此计算。我在代码里实验过，此数组如果不是69（在64位CPU上），将直接导致程序crach!

       fpc指纹的采集流程图：

       源码如下：

       FingerPrintEnrollBase：

Java代码

 /*
 * Copyright (C) 2015 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 com.mediatek.test;

 import android.app.Activity;
import android.app.Fragment;
 import android.content.Context;
import android.hardware.fingerprint.FingerprintManager;
 import android.os.Bundle;
import android.os.CancellationSignal;
 import android.os.Handler;
import android.util.Log;
 /**
 * local fragment to handle the state around fingerprint enrollment.
  */
public class FingerPrintEnrollBase extends Fragment {

    private int mEnrollmentSteps = -1;
     private int mEnrollmentRemaining = 0;
    private Listener mListener;
     private boolean mEnrolling;
    private CancellationSignal mEnrollmentCancel;
     private Handler mHandler = new Handler();
    private byte[] mToken = new byte[69];//if byte length != sizeof(hw_auth_token_t), throws Exception
     private boolean mDone;
    private static final String TAG = "FingerPrintEnrollBase";

    @Override
     public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
         setRetainInstance(true);
    }

    @Override
     public void onAttach(Activity activity) {
        super.onAttach(activity);
     }

     @Override
    public void onStart() {
         super.onStart();
        Log.d(TAG, "mToken length="+mToken.length);
         if (!mEnrolling) {
            FingerprintManager mFpM = (FingerprintManager) getActivity().getSystemService(Context.FINGERPRINT_SERVICE);
             startEnrollment(mFpM);
        }
     }

     @Override
    public void onStop() {
         super.onStop();
        if (!getActivity().isChangingConfigurations()) {
             cancelEnrollment();
        }
     }

     protected void startEnrollment(FingerprintManager mFpM) {
        mHandler.removeCallbacks(mTimeoutRunnable);
         mEnrollmentSteps = -1;
        mEnrollmentCancel = new CancellationSignal();
         if(mFpM != null){
            mFpM.enroll(mToken, mEnrollmentCancel, 0, mEnrollmentCallback);
         }
        mEnrolling = true;
     }

     protected void cancelEnrollment() {
        mHandler.removeCallbacks(mTimeoutRunnable);
         if (mEnrolling) {
            mEnrollmentCancel.cancel();
             mEnrolling = false;
            mEnrollmentSteps = -1;
         }
    }

    public void setListener(Listener listener) {
         mListener = listener;
    }

    public int getEnrollmentSteps() {
         return mEnrollmentSteps;
    }

    public int getEnrollmentRemaining() {
         return mEnrollmentRemaining;
    }

    public boolean isDone() {
         return mDone;
    }

    private FingerprintManager.EnrollmentCallback mEnrollmentCallback
             = new FingerprintManager.EnrollmentCallback() {

         @Override
        public void onEnrollmentProgress(int remaining) {
             if (mEnrollmentSteps == -1) {
                mEnrollmentSteps = remaining;
             }
            mEnrollmentRemaining = remaining;
             mDone = remaining == 0;
            if (mListener != null) {
                 mListener.onEnrollmentProgressChange(mEnrollmentSteps, remaining);
            }
         }

         @Override
        public void onEnrollmentHelp(int helpMsgId, CharSequence helpString) {
             if (mListener != null) {
                mListener.onEnrollmentHelp(helpString);
             }
        }

        @Override
         public void onEnrollmentError(int errMsgId, CharSequence errString) {
            if (mListener != null) {
                 mListener.onEnrollmentError(errMsgId, errString);
            }
         }
    };

    private final Runnable mTimeoutRunnable = new Runnable() {
         @Override
        public void run() {
             cancelEnrollment();
        }
     };

     public interface Listener {
        void onEnrollmentHelp(CharSequence helpString);
         void onEnrollmentError(int errMsgId, CharSequence errString);
        void onEnrollmentProgressChange(int steps, int remaining);
     }
}

       FingerPrintActivity：

Java代码

 package com.mediatek.test;

 import java.io.FileInputStream;
import java.io.IOException;
 import java.util.List;
import java.util.Timer;
 import java.util.TimerTask;

 import android.R.color;
import android.app.Activity;
 import android.app.AlertDialog;
import android.content.Context;
 import android.content.DialogInterface;
import android.content.Intent;
 import android.graphics.Color;
import android.os.Bundle;
 import android.os.CancellationSignal;
import android.os.Handler;
 import android.os.Message;
import android.text.Spannable;
 import android.text.style.ForegroundColorSpan;
import android.util.Log;
 import android.view.KeyEvent;
import android.view.View;
 import android.view.View.OnClickListener;
import android.widget.Button;
 import android.widget.ImageView;
import android.widget.ProgressBar;
 import android.widget.TableRow;
import android.widget.TextView;
 import android.widget.Toast;

 import com.mediatek.test.R;
import android.hardware.fingerprint.Fingerprint;
 import android.hardware.fingerprint.FingerprintManager;

 public class FingerPrintActivity extends Activity implements FingerPrintEnrollBase.Listener{
    private static final String TAG = "FingerPrintActivity";
     private MyHandler mHandler = new MyHandler();
    private TextView fingerPrintAcquisitionTextView, fingerPrintEnrollmentErrorView, fingerPrintEnrollmentHelpView;
     private FingerPrintEnrollBase fpeb;
    private FingerprintManager mFingerprintManager;

    @Override
     protected int setTitleId() {
        return R.string.tittle_fingerprint;
     }

     @Override
    protected Activity getActivity() {
         return this;
    }

    @Override
     protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
         setContentView(R.layout.fingerprint);
        fingerPrintAcquisitionTextView = (TextView)findViewById(R.id.fingerprint_message);
         fingerPrintEnrollmentErrorView= (TextView)findViewById(R.id.fingerprint_enrollment_error);
        fingerPrintEnrollmentHelpView= (TextView)findViewById(R.id.fingerprint_enrollment_help);

        mFingerprintManager = (FingerprintManager) getActivity().getSystemService(
                 Context.FINGERPRINT_SERVICE);


    }

    private void sendMsgToHandler(int msgType, String remark){
         Message msg = Message.obtain();
        msg.what = msgType;
         Bundle bundle = new Bundle();
        bundle.putString("result", remark);
         msg.setData(bundle);
        mHandler.sendMessage(msg);
     }

     @Override
    public void onEnrollmentHelp(CharSequence helpString) {
         Log.d(TAG, "==onEnrollmentHelp="+helpString.toString());
        sendMsgToHandler(3, helpString.toString());
     }

     @Override
    public void onEnrollmentError(int errMsgId, CharSequence errString) {
         Log.d(TAG, "==onEnrollmentError errMsgId="+errMsgId+" errString="+errString.toString());
        if(errMsgId == 3){//time out
             postEnrollment();
        }else if(errMsgId == 1){//hardware lose efficacy
             startEnrollment();
        }else if(errMsgId == 5){//operation cancel
         }else{
            sendMsgToHandler(4, errString.toString());
         }
    }

    @Override
     public void onEnrollmentProgressChange(int steps, int remaining) {
        Log.d(TAG, "===============onEnrollmentProgressChange=======");
         Log.d(TAG, "steps" + steps + "||remaining=" + remaining);
        fingerPrintEnrollmentHelpView.setText("");
         fingerPrintEnrollmentErrorView.setText("");
        sendMsgToHandler(2, getString(R.string.fingerprint_validate_success));
         buttonS.setEnabled(true);
        stopFingerprint();
     }

     private void startEnrollment(){
        if (fpeb == null) {
             fpeb = new FingerPrintEnrollBase();
        }
         fpeb.setListener(this);
        fpeb.startEnrollment(mFingerprintManager);
     }
    private void postEnrollment(){
         if(mFingerprintManager != null){
            mFingerprintManager.postEnroll();
         }
    }

    private void stopFingerprint() {
         if (fpeb != null){
            fpeb.cancelEnrollment();
             onStop();
        }
     }

     @Override
    protected void onStart() {
         super.onStart();
    }

    @Override
     protected void onStop() {
        super.onStop();
         if(fpeb != null){
            fpeb.setListener(null);
         }
    }

    @Override
     protected void onResume() {
        super.onResume();
         if(mFingerprintManager == null){
            mFingerprintManager = (FingerprintManager) getActivity().getSystemService(
                 Context.FINGERPRINT_SERVICE);
        }

        startEnrollment();
     }

     @Override
    protected void onPause() {
         super.onPause();
        postEnrollment();
         mFingerprintManager = null;
        stopFingerprint();
         fpeb = null;
    }


     class MyHandler extends Handler{

         @Override
        public void handleMessage(Message msg) {
             Bundle bundle = null;
            super.handleMessage(msg);
             switch (msg.what) {
            case 0:
                 removeMessages(0);
                bundle = msg.getData();
                 String result = bundle.getString("result");
                selfTestView.setText(result);
                 selfTestView.setTextColor(result.contains("PASS")?Color.GREEN:Color.RED);
                break;
             case 1:
                removeMessages(1);
                 bundle = msg.getData();
                String rs = bundle.getString("result");
                 checkBroadView.setText(bundle.getString("result"));
                checkBroadView.setTextColor(rs.contains("PASS")?Color.GREEN:Color.RED);
                 break;
            case 2:
                 removeMessages(2);
                bundle = msg.getData();
                 String fingerprint = bundle.getString("result");
                fingerPrintAcquisitionTextView.setText(bundle.getString("result"));
                 fingerPrintAcquisitionTextView.setTextColor(fingerprint.contains("PASS")?Color.GREEN:Color.WHITE);
                mButtonSelftest.setEnabled(true);
                 mButtonCheckerboardTest.setEnabled(true);
                break;
             case 3:
                removeMessages(3);
                 bundle = msg.getData();
                String enrollmentHelp = bundle.getString("result");
                 fingerPrintEnrollmentHelpView.setText(bundle.getString("result"));
                break;
             case 4:
                removeMessages(4);
                 bundle = msg.getData();
                String enrollmentError = bundle.getString("result");
                 fingerPrintEnrollmentErrorView.setText(bundle.getString("result"));
                fingerPrintAcquisitionTextView.setText("");
                 break;
            default:
                 break;
            }
         }
    }

}