屏下指纹设备（VIVO V15、Oneplus6T等）Fingerprint Sensor Manager使用及认证问题

Hey there! Let's tackle your issues with fingerprint sensor integration on under-display fingerprint devices like the VIVO V15 and OnePlus 6T. I've worked through similar compatibility problems before, so here's what you need to know:

一、如何在屏下指纹设备中正确使用Fingerprint Sensor Manager #

Under-display fingerprint sensors are integrated directly into the display panel, which means they have subtle differences from traditional rear/front physical sensors. Follow these steps for reliable integration:

• Declare Required Permissions: First, make sure your app has the necessary permissions in the AndroidManifest.xml:

  <!-- For Android 9 and below -->
  <uses-permission android:name="android.permission.USE_FINGERPRINT" />
  <!-- For Android 10+ (recommended for broader compatibility) -->
  <uses-permission android:name="android.permission.USE_BIOMETRIC" />
  

• Verify Hardware & Enrollment: Before initiating any fingerprint operations, check if the device supports fingerprint authentication and has enrolled fingerprints. Use BiometricManager (Android 10+) for this, as it's more reliable for under-display sensors:

  val biometricManager = BiometricManager.from(context)
  val canAuthenticate = biometricManager.canAuthenticate(BiometricManager.Authenticators.BIOMETRIC_WEAK)
  if (canAuthenticate != BiometricManager.BIOMETRIC_SUCCESS) {
      // Handle cases where hardware is missing, unavailable, or no fingerprints are enrolled
  }
  

• Use System-Provided UI: Avoid custom fingerprint prompts if possible. The system's BiometricPrompt automatically aligns with the under-display sensor's position on supported devices, ensuring users tap the correct area. Custom UIs might not account for the sensor's exact location, leading to failed attempts.

二、Fixing Fingerprint Authentication Failures on Under-Display Devices #

If your authentication works on regular devices but fails on these under-display models, try these targeted fixes:

• Ditch the Old FingerprintManager: Android 9's legacy FingerprintManager has known compatibility gaps with under-display sensors. Upgrade to BiometricPrompt (introduced in Android 10) — it's Google's unified biometric API, optimized for newer sensor types. Here's a quick implementation snippet:

  // Prepare the prompt info
  val promptInfo = BiometricPrompt.PromptInfo.Builder()
      .setTitle("Verify Your Fingerprint")
      .setSubtitle("Confirm your identity to proceed")
      .setNegativeButtonText("Cancel")
      .build()
  
  // Create the biometric prompt
  val biometricPrompt = BiometricPrompt(
      this,
      ContextCompat.getMainExecutor(this),
      object : BiometricPrompt.AuthenticationCallback() {
          override fun onAuthenticationSucceeded(result: BiometricPrompt.AuthenticationResult) {
              super.onAuthenticationSucceeded(result)
              // Handle successful authentication here
          }
  
          override fun onAuthenticationFailed() {
              super.onAuthenticationFailed()
              // Handle failed attempt (e.g., show retry message)
          }
      }
  )
  
  // Trigger the authentication flow
  biometricPrompt.authenticate(promptInfo)
  

• Check Screen State: Under-display sensors require the screen to be active (either fully lit or in a low-power state) to detect touches. If your app tries to authenticate when the screen is off, it will fail. Use a WakeLock to temporarily wake the screen before initiating authentication:

  val powerManager = getSystemService(Context.POWER_SERVICE) as PowerManager
  val wakeLock = powerManager.newWakeLock(
      PowerManager.SCREEN_BRIGHT_WAKE_LOCK or PowerManager.ACQUIRE_CAUSES_WAKEUP,
      "MyApp:FingerprintWakeLock"
  )
  wakeLock.acquire(10000) // Keep screen awake for 10 seconds
  // Initiate fingerprint authentication here
  wakeLock.release()
  

• Avoid UI Overlays: If your app has full-screen dialogs, floating windows, or status bar overlays, they might block the under-display sensor's touch area. Ensure no custom UI elements cover the system's BiometricPrompt or the sensor's known position (you can check device specs to confirm the sensor's location if needed).
• Verify App Permissions: Some manufacturers (like VIVO and OnePlus) require explicit user approval for fingerprint access in system settings, even if you've declared the permission in the manifest. Guide users to check: Settings > Apps > [Your App] > Permissions > Fingerprint and ensure it's enabled.
• Test Against Manufacturer-Specific Behaviors: Occasionally, custom Android skins (like Funtouch OS for VIVO, OxygenOS for OnePlus) have unique biometric restrictions. For example, some devices block fingerprint authentication when the app is in the background. Make sure your app is in the foreground when initiating the flow.

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