Add plumbing and placeholder screens for parental consent flow.

Bug: 188847063
Test: adb shell am start -a android.settings.BIOMETRIC_ENROLL --ez require_consent true
Test: atest com.android.settings.biometrics.ParentalConsentHelperTest
Change-Id: Ie136036d5f550775fd0b021979581a5d222f1b68

src/com/android/settings/biometrics/ParentalConsentHelper.java

@@ -0,0 +1,168 @@
+/*
+ * Copyright (C) 2021 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.android.settings.biometrics;
+
+import static android.hardware.biometrics.BiometricAuthenticator.TYPE_FACE;
+import static android.hardware.biometrics.BiometricAuthenticator.TYPE_FINGERPRINT;
+import static android.hardware.biometrics.BiometricAuthenticator.TYPE_NONE;
+
+import static com.android.settings.biometrics.BiometricEnrollBase.EXTRA_KEY_MODALITY;
+import static com.android.settings.biometrics.BiometricEnrollBase.RESULT_CONSENT_DENIED;
+import static com.android.settings.biometrics.BiometricEnrollBase.RESULT_CONSENT_GRANTED;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Bundle;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+import com.android.settings.biometrics.face.FaceEnrollParentalConsent;
+import com.android.settings.biometrics.fingerprint.FingerprintEnrollParentalConsent;
+import com.android.settings.password.ChooseLockSettingsHelper;
+
+import com.google.android.setupcompat.util.WizardManagerHelper;
+
+/**
+ * Helper for {@link BiometricEnrollActivity} to ask for parental consent prior to actual user
+ * enrollment.
+ */
+public class ParentalConsentHelper {
+
+    private static final String KEY_FACE_CONSENT = "face";
+    private static final String KEY_FINGERPRINT_CONSENT = "fingerprint";
+
+    private final boolean mRequireFace;
+    private final boolean mRequireFingerprint;
+
+    private long mGkPwHandle;
+    @Nullable
+    private Boolean mConsentFace;
+    @Nullable
+    private Boolean mConsentFingerprint;
+
+    /**
+     * Helper for aggregating user consent.
+     *
+     * @param requireFace if face consent should be shown
+     * @param requireFingerprint if fingerprint consent should be shown
+     * @param gkPwHandle for launched intents
+     */
+    public ParentalConsentHelper(boolean requireFace, boolean requireFingerprint,
+            @Nullable Long gkPwHandle) {
+        mRequireFace = requireFace;
+        mRequireFingerprint = requireFingerprint;
+        mGkPwHandle = gkPwHandle != null ? gkPwHandle : 0L;
+    }
+
+    /**
+     * Updated the handle used for launching activities
+     *
+     * @param data result intent for credential verification
+     */
+    public void updateGatekeeperHandle(Intent data) {
+        mGkPwHandle = BiometricUtils.getGatekeeperPasswordHandle(data);
+    }
+
+    /**
+     * Launch the next consent screen.
+     *
+     * @param activity root activity
+     * @param requestCode request code to launch new activity
+     * @param resultCode result code of the last consent launch
+     * @param data result data from the last consent launch
+     * @return true if a consent activity was launched or false when complete
+     */
+    public boolean launchNext(@NonNull Activity activity, int requestCode, int resultCode,
+            @Nullable Intent data) {
+        if (data != null) {
+            switch (data.getIntExtra(EXTRA_KEY_MODALITY, TYPE_NONE)) {
+                case TYPE_FACE:
+                    mConsentFace = isConsent(resultCode, mConsentFace);
+                    break;
+                case TYPE_FINGERPRINT:
+                    mConsentFingerprint = isConsent(resultCode, mConsentFingerprint);
+                    break;
+            }
+        }
+        return launchNext(activity, requestCode);
+    }
+
+    @Nullable
+    private static Boolean isConsent(int resultCode, @Nullable Boolean defaultValue) {
+        switch (resultCode) {
+            case RESULT_CONSENT_GRANTED:
+                return true;
+            case RESULT_CONSENT_DENIED:
+                return false;
+        }
+        return defaultValue;
+    }
+
+    /** @see #launchNext(Activity, int, int, Intent)  */
+    public boolean launchNext(@NonNull Activity activity, int requestCode) {
+        final Intent intent = getNextConsentIntent(activity);
+        if (intent != null) {
+            WizardManagerHelper.copyWizardManagerExtras(activity.getIntent(), intent);
+            if (mGkPwHandle != 0) {
+                intent.putExtra(ChooseLockSettingsHelper.EXTRA_KEY_GK_PW_HANDLE, mGkPwHandle);
+            }
+            activity.startActivityForResult(intent, requestCode);
+            return true;
+        }
+        return false;
+    }
+
+    @Nullable
+    private Intent getNextConsentIntent(@NonNull Context context) {
+        if (mRequireFace && mConsentFace == null) {
+            return new Intent(context, FaceEnrollParentalConsent.class);
+        }
+        if (mRequireFingerprint && mConsentFingerprint == null) {
+            return new Intent(context, FingerprintEnrollParentalConsent.class);
+        }
+        return null;
+    }
+
+    /**
+     * Get the result of all consent requests.
+     *
+     * This should be called when {@link #launchNext(Activity, int, int, Intent)} returns false
+     * to indicate that all responses have been recorded.
+     *
+     * @return The aggregate consent status.
+     */
+    @NonNull
+    public Bundle getConsentResult() {
+        final Bundle result = new Bundle();
+        result.putBoolean(KEY_FACE_CONSENT, mConsentFace != null ? mConsentFace : false);
+        result.putBoolean(KEY_FINGERPRINT_CONSENT,
+                mConsentFingerprint != null ? mConsentFingerprint : false);
+        return result;
+    }
+
+    /** @return If the result bundle contains consent for face authentication. */
+    public static boolean hasFaceConsent(@NonNull Bundle bundle) {
+        return bundle.getBoolean(KEY_FACE_CONSENT, false);
+    }
+
+    /** @return If the result bundle contains consent for fingerprint authentication. */
+    public static boolean hasFingerprintConsent(@NonNull Bundle bundle) {
+        return bundle.getBoolean(KEY_FINGERPRINT_CONSENT, false);
+    }
+}