.NET Maui 8.0中ZXing.Net.Maui无法识别FedEx PDF417条码

1. 确认扫描选项的格式配置是否正确 #

虽然你提到设置了“扫描所有格式”，但需明确枚举值是否包含PDF417。检查BarcodeReaderOptions初始化代码：

var options = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.PDF417 | BarcodeFormats.AllOneDimensional, // 显式指定PDF417
    AutoRotate = true,
    TryHarder = true, // 提升模糊/低分辨率条码的识别率
    AutoInvert = true
};
BarcodeReader.Options = options;

注意：BarcodeFormats.All理论上包含所有格式，但直接显式指定PDF417可避免枚举解析异常。

2. 检查CameraBarcodeReaderView核心属性 #

• 确保IsDetecting为true（若代码误设为false会停止扫描）：

  <zxing:CameraBarcodeReaderView x:Name="BarcodeReader" 
                                 IsDetecting="True"
                                 BarcodesDetected="OnBarcodesDetected"/>
  

• 启用自动对焦：二维条码对精度要求更高，添加AutoFocusEnabled="True"到控件属性。
• 设置CameraFacing="Back"，优先使用分辨率更高的后置摄像头。

3. 强制调整相机分辨率 #

PDF417条码密度高，低分辨率相机可能无法捕捉足够细节。通过选择高分辨率提升识别率：

BarcodeReader.CameraResolutionSelector = availableResolutions =>
{
    return availableResolutions.OrderByDescending(r => r.Width * r.Height).FirstOrDefault();
};

4. 验证平台权限配置 #

尽管一维条码可扫描，仍需确认各平台权限完整：

• Android：在AndroidManifest.xml中添加：

  <uses-permission android:name="android.permission.CAMERA" />
  <uses-feature android:name="android.hardware.camera" />
  <uses-feature android:name="android.hardware.camera.autofocus" />
  

• iOS：在Info.plist中添加相机权限描述：

  <key>NSCameraUsageDescription</key>
  <string>需要访问相机进行条码扫描</string>
  

5. 检查事件处理逻辑 #

确认BarcodesDetected事件未过滤PDF417结果：

private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
{
    var barcodes = e.Results;
    MainThread.BeginInvokeOnMainThread(() =>
    {
        foreach (var barcode in barcodes)
        {
            // 确保无只处理一维条码的过滤逻辑
            Console.WriteLine($"扫描到条码：{barcode.Format} - {barcode.Value}");
        }
    });
}

注意：必须通过MainThread更新UI，避免跨线程异常，但此操作不会导致事件不触发。

6. 排查测试样本与环境问题 #

• 若测试的是屏幕显示的FedEx标签，改用实体打印标签测试（屏幕反光、分辨率不足会影响识别）。
• 调整扫描距离：PDF417的最佳扫描距离通常比一维条码稍远，避免过近导致条码超出对焦范围。

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