Android M指纹的资料太少,经过一段时间阅读原生Android代码,写了以下例子,贡献出来给需要帮助的人。
以下内容基于64位的高通CPU,搭载fpc1020芯片,此部分代码在原生android上做了更改,以应付工厂指纹的测试。原生android指纹录入需要采集10次(因不同的芯片而定)。
代码简单说明:
1. FingerPrintEnrollBase类:
重要的是
- 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:
- /*
- * 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:
- 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;
- }
- }
- }
- }
发表评论:
◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。