如何在 Angular 项目中集成 zxing/ngx-scanner从安装到运行的保姆级教程【免费下载链接】ngx-scannerAngular QR code, Barcode, DataMatrix, scanner component using ZXing.项目地址: https://gitcode.com/gh_mirrors/ng/ngx-scanner在 Angular 项目中实现扫码功能最省心的方案就是集成zxing/ngx-scanner——这是一款基于 ZXing 的 Angular 扫码组件可以快速调用摄像头识别QR 码、条形码Barcode和 DataMatrix等一维/二维条码。本教程将带你从零开始一步步完成Angular 扫码组件安装、摄像头权限配置、扫码结果回调的全部流程即使你是新手也能照着跑通全程无需手写复杂的图像识别算法。一、zxing/ngx-scanner 是什么zxing/ngx-scanner是一个开源的 Angular 条码扫描组件底层使用 ZXing 库做解码。你只需在页面里放一个zxing-scanner标签它就会自动完成✅ 调用摄像头并显示实时预览画面✅ 自动识别画面中的二维码、条形码、DataMatrix 等✅ 把识别结果通过事件回调抛给你的业务代码整个组件的核心逻辑都在projects/zxing-scanner/src/lib/zxing-scanner.component.ts中它封装了摄像头枚举、权限申请、连续扫码等细节对外只暴露少量输入输出属性用起来非常轻量。官方仓库中也自带了一个完整可运行的 Demo位于projects/zxing-scanner-demo/src/app/目录下你可以直接参考其中的app.component.ts与app.component.html的写法。二、安装前的准备工作环境要求动手之前先确认你的环境满足下面 3 个条件否则后续会踩坑检查项要求Node.js / npm已安装且 npm 版本较新Angular CLI建议 18 及以上版本运行环境生产环境必须使用HTTPS浏览器安全策略限制⚠️ 特别提醒调用摄像头属于敏感权限HTTPS 或 localhost 之外的页面会被浏览器直接拦截。本地开发用ng servelocalhost没问题上线部署时请务必配置 HTTPS。版本兼容规则重要zxing/ngx-scanner的主版本号和 Angular 主版本号保持一致。例如zxing/ngx-scanner22.0.0对应 Angular 22你项目用的是 Angular 18就安装zxing/ngx-scanner18.x装错大版本会导致依赖冲突报错时优先检查这里。三、一键安装步骤npm 安装在项目根目录执行下面这条命令安装扫码组件及其依赖的 ZXing 运行库npm install zxing/ngx-scanner zxing/browser zxing/library其中zxing/ngx-scannerAngular 扫码组件本体zxing/browser浏览器端摄像头流管理zxing/libraryZXing 解码核心库安装完成后可以在projects/zxing-scanner/package.json中看到它的完整依赖清单peerDependencies包括angular/core、zxing/browser、zxing/library等这些都无需手动重复安装。四、最快配置方法模块导入扫码组件以模块形式提供在你的根模块如AppModule中导入ZXingScannerModule即可import { NgModule } from angular/core; import { BrowserModule } from angular/platform-browser; import { ZXingScannerModule } from zxing/ngx-scanner; import { AppComponent } from ./app.component; NgModule({ declarations: [AppComponent], imports: [ BrowserModule, ZXingScannerModule // 导入扫码模块 ], bootstrap: [AppComponent] }) export class AppModule { }模块的源码定义在projects/zxing-scanner/src/lib/zxing-scanner.module.ts它声明并导出了ZXingScannerComponent组件导入后就能在任意模板中使用zxing-scanner标签了。五、在页面中使用扫码组件在你的组件模板比如app.component.html里加上这一行zxing-scanner/zxing-scanner就这么简单组件默认会自动开启后置摄像头并开始持续扫码。当然更完整的用法是绑定事件、接收结果zxing-scanner [formats]formatsEnabled (scanSuccess)onCodeResult($event) (permissionResponse)onHasPermission($event) (camerasFound)onCamerasFound($event) (camerasNotFound)onCamerasNotFound() /zxing-scanner p识别结果{{ qrResultString }}/p对应的组件逻辑export class AppComponent { formatsEnabled [QR_CODE, EAN_13, CODE_128, DATA_MATRIX]; qrResultString ; onCodeResult(result: string) { this.qrResultString result; // 拿到扫码结果 } onHasPermission(has: boolean) { console.log(摄像头权限, has); } onCamerasFound(devices: MediaDeviceInfo[]) { console.log(发现摄像头, devices); } onCamerasNotFound() { alert(未找到可用摄像头); } }官方 Demo 中的完整写法可以对照projects/zxing-scanner-demo/src/app/app.component.ts与app.component.html里面还包含摄像头切换下拉框、结果展示等参考实现。六、摄像头权限配置与常见错误处理扫码组件已经帮你处理了大部分权限流程你只需要关心两个事件permissionResponse用户是否允许使用摄像头返回booleancamerasFound/camerasNotFound是否检测到可用摄像头建议在页面上根据这些事件给出友好提示比如!-- 等待授权 -- p *ngIfhasPermission undefined⏳ 等待授权摄像头权限…/p !-- 用户拒绝 -- p *ngIfhasPermission false 你拒绝了摄像头权限扫码功能无法使用/p !-- 没有摄像头 -- p *ngIfhasDevices false 未检测到摄像头设备/p常见报错速查表错误场景原因解决办法NotAllowedError用户拒绝授权引导用户在浏览器设置中重新授权NotFoundError未找到摄像头检查设备、更换浏览器测试NotReadableError摄像头被其他应用占用关闭占用摄像头的程序后重试页面一片空白非 HTTPS 环境改用 localhost 开发或部署 HTTPS七、进阶玩法多格式识别、手电筒与摄像头切换当基础扫码跑通后这些高频能力能让你的功能更完整1️⃣ 自定义识别的条码类型通过[formats]输入属性限制识别范围识别的准确率和速度会更好zxing-scanner [formats][QR_CODE, CODE_128, DATA_MATRIX] /zxing-scanner组件内部通过DecodeHintType.POSSIBLE_FORMATS提示 ZXing 只在这些格式中解码逻辑见zxing-scanner.component.ts中的formatssetter。2️⃣ 开启手电筒Torch部分设备支持闪光灯补光配合torchCompatible事件判断兼容性后再开启zxing-scanner [torch]torchEnabled (torchCompatible)onTorchCompatible($event) /zxing-scanner⚠️ 手电筒 API 在不同浏览器中稳定性不一建议先通过torchCompatible检测支持情况。3️⃣ 切换前后摄像头监听camerasFound拿到设备列表再通过[device]输入属性指定要使用的摄像头zxing-scanner [device]deviceCurrent (deviceChange)onDeviceChange($event) /zxing-scanner组件默认会优先选择后置摄像头通过 label 中的back、rear等关键词匹配没有匹配项时取最后一个设备。4️⃣ 其他实用属性一览属性作用默认值autostart是否自动启动扫码trueenable动态开关扫码truetryHarder开启困难模式提高识别率falsetimeBetweenScans两次解码尝试间隔毫秒500delayBetweenScanSuccess成功解码后的间隔毫秒500previewFitMode视频画面填充方式cover八、新手常见问题 FAQQ1扫码组件报错提示找不到模块检查版本兼容性zxing/ngx-scanner主版本必须与 Angular 主版本一致。Q2打开页面摄像头权限弹窗没有出现确认页面运行在 HTTPS 或 localhost 环境下同时浏览器地址栏的摄像头权限未被禁用。Q3二维码能扫但条形码识别不到在[formats]中显式加入目标格式如EAN_13、CODE_128并保持条码画面清晰、光线充足。Q4手机端全屏播放而不是内嵌预览组件视频标签已内置playsinline属性以适配 iOS Safari若仍有问题请升级到最新版本。Q5我想本地运行官方 Demo 看看效果克隆仓库后运行npm install再执行npm start即ng serve zxing-scanner-demo即可启动演示项目。九、总结至此你已经在 Angular 项目中完整集成了zxing/ngx-scanner 扫码组件从 npm 安装、模块导入、模板使用到权限配置、结果回调与多格式识别。整个过程只需十几行代码却能获得 ZXing 强大的解码能力覆盖二维码、条形码、DataMatrix等主流条码类型。无论是做扫码登录、商品条码识别还是票务核销这套方案都足够可靠快把它用到你的项目里试试吧【免费下载链接】ngx-scannerAngular QR code, Barcode, DataMatrix, scanner component using ZXing.项目地址: https://gitcode.com/gh_mirrors/ng/ngx-scanner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考