Xamarin Forms Android端使用Plugin.Fingerprint实现人脸识别登录遇阻求助

问题本质 #

Android是支持系统级人脸识别的，你现在的情况不是不能实现，而是权限配置和Plugin参数没跟上Android的版本要求：

• Android 9及以下：只支持指纹识别，对应USE_FINGERPRINT权限
• Android 10及以上：支持指纹、人脸等多种生物识别，需要USE_BIOMETRIC权限，还要明确告诉Plugin要唤起人脸识别

具体改法 #

1. 补全AndroidManifest配置 #

把现有权限按API版本区分，再添加生物识别特性声明：

<!-- Android 10+使用的生物识别权限 -->
<uses-permission android:name="android.permission.USE_BIOMETRIC" android:minSdkVersion="29" />
<!-- Android 9及以下使用的指纹权限 -->
<uses-permission android:name="android.permission.USE_FINGERPRINT" android:maxSdkVersion="28" />

<!-- 声明应用支持生物识别硬件 -->
<uses-feature android:name="android.hardware.biometrics" android:required="false" />
<!-- 明确声明支持人脸识别（帮助系统识别应用需求） -->
<uses-feature android:name="android.hardware.biometrics.face" android:required="false" />

2. 修改识别请求的参数配置 #

创建AuthenticationRequestConfiguration时，指定允许的生物识别类型，加入人脸选项：

public async void BiometricClicked()
{
    if (!bioOn)
    {
        // 添加AllowedBiometricTypes，指定同时支持指纹和人脸
        var request = new AuthenticationRequestConfiguration("Biometric Setup.", "Setup Biometric Login")
        {
            AllowedBiometricTypes = BiometricType.Fingerprint | BiometricType.Face
        };
        var result = await CrossFingerprint.Current.AuthenticateAsync(request);

        // 后续激活逻辑保持不变...
    }
    else
    {
        // 关闭生物识别的逻辑保持不变...
    }
}

3. 确认设备基础条件 #

• 测试的Android设备必须硬件支持人脸识别，且已经在系统设置中录入人脸数据
• Android 9及以下设备没有系统级人脸识别功能，Plugin.Fingerprint无法适配这类设备的人脸识别需求，只能用第三方SDK实现

4. 动态权限检查（可选） #

虽然USE_BIOMETRIC不需要动态申请，但可以提前确认权限状态，避免异常：

var biometricStatus = await Permissions.CheckStatusAsync<Permissions.Biometric>();
if (biometricStatus != PermissionStatus.Granted)
{
    biometricStatus = await Permissions.RequestAsync<Permissions.Biometric>();
}

改后效果 #

Android 10+且支持人脸的设备，会直接弹出系统级人脸识别界面；如果设备无人脸识别功能，会自动 fallback 到指纹识别，不影响原有功能使用。

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