Android平台如何分别检测指纹与人脸生物识别可用性，实现分场景身份验证引导

Great question! Let’s walk through how to implement your desired flow—prioritizing face authentication guidance first, then falling back to fingerprint if face isn’t supported or the user opts out. Here’s a step-by-step breakdown with code examples tailored to Android’s API versions:

1. Understand API Version Differences #

Android introduced granular biometric type detection in API 30 (Android 11) with BIOMETRIC_FACE and BIOMETRIC_FINGERPRINT constants. For older versions, we’ll use PackageManager to check hardware support directly.

2. Helper Functions to Check Biometric Support #

First, create reusable functions to detect if face or fingerprint biometrics are available (hardware exists, and either enrolled or ready to enroll):

For Face Biometrics #

fun isFaceBiometricAvailable(context: Context): Boolean {
    return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        val biometricManager = BiometricManager.from(context)
        val authResult = biometricManager.canAuthenticate(BIOMETRIC_FACE)
        // Return true if hardware exists (even if not enrolled yet)
        authResult != BiometricManager.BIOMETRIC_ERROR_NO_HARDWARE
    } else {
        // Pre-API 30: Check if face hardware is present on the device
        context.packageManager.hasSystemFeature(PackageManager.FEATURE_FACE)
    }
}

For Fingerprint Biometrics #

fun isFingerprintBiometricAvailable(context: Context): Boolean {
    return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        val biometricManager = BiometricManager.from(context)
        val authResult = biometricManager.canAuthenticate(BIOMETRIC_FINGERPRINT)
        authResult != BiometricManager.BIOMETRIC_ERROR_NO_HARDWARE
    } else {
        // Pre-API 30: Check if fingerprint hardware is present
        context.packageManager.hasSystemFeature(PackageManager.FEATURE_FINGERPRINT)
    }
}

3. Implement the Enrollment Flow #

Now, build the logic to guide users based on your priority (face first, then fingerprint):

Step 1: Define Request Codes #

private const val REQUEST_CODE_FACE_ENROLL = 101
private const val REQUEST_CODE_FINGERPRINT_ENROLL = 102

Step 2: Start the Enrollment Flow #

fun startBiometricEnrollment(context: Context) {
    if (isFaceBiometricAvailable(context)) {
        // Guide user to enroll face first
        launchFaceEnrollment(context)
    } else {
        // Face not supported—fall back to fingerprint immediately
        launchFingerprintEnrollment(context)
    }
}

private fun launchFaceEnrollment(context: Context) {
    val enrollIntent = Intent(Settings.ACTION_BIOMETRIC_ENROLL).apply {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            // Explicitly restrict enrollment to face on API 30+
            putExtra(Settings.EXTRA_BIOMETRIC_AUTHENTICATORS_ALLOWED, BIOMETRIC_FACE)
        } else {
            // Pre-API 30: Use generic strong biometric, but prompt user to choose face
            putExtra(Settings.EXTRA_BIOMETRIC_AUTHENTICATORS_ALLOWED, BIOMETRIC_STRONG)
            Toast.makeText(context, "Please enroll your face when prompted", Toast.LENGTH_SHORT).show()
        }
    }
    (context as Activity).startActivityForResult(enrollIntent, REQUEST_CODE_FACE_ENROLL)
}

private fun launchFingerprintEnrollment(context: Context) {
    val enrollIntent = Intent(Settings.ACTION_BIOMETRIC_ENROLL).apply {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            // Explicitly restrict enrollment to fingerprint
            putExtra(Settings.EXTRA_BIOMETRIC_AUTHENTICATORS_ALLOWED, BIOMETRIC_FINGERPRINT)
        } else {
            putExtra(Settings.EXTRA_BIOMETRIC_AUTHENTICATORS_ALLOWED, BIOMETRIC_STRONG)
            Toast.makeText(context, "Please enroll your fingerprint when prompted", Toast.LENGTH_SHORT).show()
        }
    }
    (context as Activity).startActivityForResult(enrollIntent, REQUEST_CODE_FINGERPRINT_ENROLL)
}

Step 3: Handle Enrollment Results #

Override onActivityResult in your Activity to respond if the user cancels face enrollment:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    when (requestCode) {
        REQUEST_CODE_FACE_ENROLL -> {
            if (resultCode != RESULT_OK) {
                // User canceled face enrollment—fall back to fingerprint
                launchFingerprintEnrollment(this)
            }
            // If resultCode == RESULT_OK, face enrollment succeeded—flow complete!
        }
        REQUEST_CODE_FINGERPRINT_ENROLL -> {
            // Handle fingerprint enrollment success/failure here
        }
    }
}

4. Important Notes #

• Permissions: Add the required biometric permission to your AndroidManifest.xml:

  <uses-permission android:name="android.permission.USE_BIOMETRIC" />
  

• Lock Screen Requirement: Biometric enrollment requires a secure lock screen (PIN/pattern/password). You can validate this with KeyguardManager if you need to handle cases where no lock screen is set.
• Pre-API 30 Limitations: Older Android versions don’t let you restrict enrollment to a specific biometric type, so the user prompt is crucial to guide them to choose face first.

Hope this helps you build the exact enrollment flow you’re looking for! Feel free to ask if you need clarification on any part.

内容的提问来源于stack exchange，提问作者Sparsh Dutta