如何在MAUI Blazor Hybrid中实现相机QR Code扫码读取功能

BlazorWebView承载的Razor页面属于沙盒化Web环境，直接套用常规Web端Blazor的二维码类库（包括BigIslandBarcoding、Web版ZXing）会碰到权限拦截、相机流不兼容问题，目前生产环境最稳定的实现思路是走原生桥接，完全不需要在Web层处理相机逻辑。

推荐方案：原生能力桥接（全平台兼容，识别性能和原生App一致） #

实现逻辑非常简单：扫码能力放在MAUI原生层实现，Razor页的按钮只负责触发原生调用，识别完成后结果直接回传给Blazor业务层，全程不用处理WebView的权限兼容问题。

• 依赖准备：在MAUI主项目引入MAUI平台适配的ZXing原生扫码包，不要引用Web版本的类库
• 权限配置：
  • Android：在AndroidManifest.xml中声明相机权限、震动权限，Android 13及以上版本补充对应版本的细粒度权限声明
  • iOS：在Info.plist中添加NSCameraUsageDescription字段，写明相机使用用途用于扫码功能
• 服务封装：在MAUI项目中定义统一的扫码服务接口，实现ScanQRCodeAsync方法：调用方法时直接弹出原生全屏扫码页，自动完成相机初始化、实时识别，识别到有效二维码后自动关闭扫码页返回结果字符串
• Razor层调用：在Razor页面注入扫码服务，按钮点击时直接调用服务方法即可，示例代码如下：

@inject IQrScanService QrScanService

<button @onclick="HandleScanClick">点击唤起扫码</button>
<div>扫码结果：@_result</div>

@code {
    private string _result = string.Empty;

    private async Task HandleScanClick()
    {
        _result = await QrScanService.ScanQRCodeAsync();
        // 拿到结果后直接处理业务逻辑，比如表单赋值、页面跳转均可
    }
}

这个方案不存在兼容坑点，相机启动速度、识别率和原生扫码能力一致，不需要额外处理WebView的特殊配置，是目前商用项目的主流实现方式。

不推荐方案：纯WebView层实现 #

如果坚持要在WebView内直接加载Web版扫码组件，需要额外做两个特殊配置：

• 重写BlazorWebView的权限请求事件，当Web上下文申请相机权限时，原生层直接放行授权，绕过WebView默认的权限申请弹窗（该弹窗在多数国产定制安卓系统上会被直接拦截，导致相机无法启动）
• 引入适配BlazorWebView的ZXing封装组件渲染相机预览层，需要额外处理应用前后台切换时的相机流断开重连逻辑，且iOS端部分系统版本下WebView相机流分辨率受限，识别率比原生方案低30%左右，维护成本很高。

避坑提示：不要直接把普通Blazor WebAssembly/Server项目里能用的扫码组件直接搬到MAUI Hybrid项目里，这类组件默认没有处理BlazorWebView的权限拦截逻辑，大概率会出现相机无响应、权限申请不弹窗的问题。

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