Home | History | Annotate | Download | only in fingerprint
      1 /*
      2  * Copyright (C) 2015 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License
     15  */
     16 
     17 package com.android.settings.fingerprint;
     18 
     19 import android.annotation.Nullable;
     20 import android.app.Activity;
     21 import android.app.Fragment;
     22 import android.hardware.fingerprint.FingerprintManager;
     23 import android.os.Bundle;
     24 import android.os.CancellationSignal;
     25 import android.os.Handler;
     26 
     27 import com.android.settings.ChooseLockSettingsHelper;
     28 
     29 /**
     30  * Sidecar fragment to handle the state around fingerprint enrollment.
     31  */
     32 public class FingerprintEnrollSidecar extends Fragment {
     33 
     34     private int mEnrollmentSteps = -1;
     35     private int mEnrollmentRemaining = 0;
     36     private Listener mListener;
     37     private boolean mEnrolling;
     38     private CancellationSignal mEnrollmentCancel;
     39     private Handler mHandler = new Handler();
     40     private byte[] mToken;
     41     private boolean mDone;
     42 
     43     @Override
     44     public void onCreate(@Nullable Bundle savedInstanceState) {
     45         super.onCreate(savedInstanceState);
     46         setRetainInstance(true);
     47     }
     48 
     49     @Override
     50     public void onAttach(Activity activity) {
     51         super.onAttach(activity);
     52         mToken = activity.getIntent().getByteArrayExtra(
     53                 ChooseLockSettingsHelper.EXTRA_KEY_CHALLENGE_TOKEN);
     54     }
     55 
     56     @Override
     57     public void onStart() {
     58         super.onStart();
     59         if (!mEnrolling) {
     60             startEnrollment();
     61         }
     62     }
     63 
     64     @Override
     65     public void onStop() {
     66         super.onStop();
     67         if (!getActivity().isChangingConfigurations()) {
     68             cancelEnrollment();
     69         }
     70     }
     71 
     72     private void startEnrollment() {
     73         mHandler.removeCallbacks(mTimeoutRunnable);
     74         mEnrollmentSteps = -1;
     75         mEnrollmentCancel = new CancellationSignal();
     76         getActivity().getSystemService(FingerprintManager.class).enroll(mToken, mEnrollmentCancel,
     77                 0 /* flags */, mEnrollmentCallback);
     78         mEnrolling = true;
     79     }
     80 
     81     private void cancelEnrollment() {
     82         mHandler.removeCallbacks(mTimeoutRunnable);
     83         if (mEnrolling) {
     84             mEnrollmentCancel.cancel();
     85             mEnrolling = false;
     86             mEnrollmentSteps = -1;
     87         }
     88     }
     89 
     90     public void setListener(Listener listener) {
     91         mListener = listener;
     92     }
     93 
     94     public int getEnrollmentSteps() {
     95         return mEnrollmentSteps;
     96     }
     97 
     98     public int getEnrollmentRemaining() {
     99         return mEnrollmentRemaining;
    100     }
    101 
    102     public boolean isDone() {
    103         return mDone;
    104     }
    105 
    106     private FingerprintManager.EnrollmentCallback mEnrollmentCallback
    107             = new FingerprintManager.EnrollmentCallback() {
    108 
    109         @Override
    110         public void onEnrollmentProgress(int remaining) {
    111             if (mEnrollmentSteps == -1) {
    112                 mEnrollmentSteps = remaining;
    113             }
    114             mEnrollmentRemaining = remaining;
    115             mDone = remaining == 0;
    116             if (mListener != null) {
    117                 mListener.onEnrollmentProgressChange(mEnrollmentSteps, remaining);
    118             }
    119         }
    120 
    121         @Override
    122         public void onEnrollmentHelp(int helpMsgId, CharSequence helpString) {
    123             if (mListener != null) {
    124                 mListener.onEnrollmentHelp(helpString);
    125             }
    126         }
    127 
    128         @Override
    129         public void onEnrollmentError(int errMsgId, CharSequence errString) {
    130             if (mListener != null) {
    131                 mListener.onEnrollmentError(errString);
    132             }
    133         }
    134     };
    135 
    136     private final Runnable mTimeoutRunnable = new Runnable() {
    137         @Override
    138         public void run() {
    139             cancelEnrollment();
    140         }
    141     };
    142 
    143     public interface Listener {
    144         void onEnrollmentHelp(CharSequence helpString);
    145         void onEnrollmentError(CharSequence errString);
    146         void onEnrollmentProgressChange(int steps, int remaining);
    147     }
    148 }
    149