uni-app扫码功能实现 uni-app如何调用扫一扫API

uni.scanCode 在真机上没反应需检查平台兼容性：H5 端不可用，微信小程序需配置 permission，App 端需原生支持；扫码后回调需处理 success/fail/complete；result 格式依 scanType 而异，须先判断再解析；App 端可优化参数提升识别率。

uni.scanCode 在真机上没反应？检查平台兼容性

uni.scanCode 是 uni-app 提供的统一扫码 API，但它在不同平台行为差异很大。H5 端根本不可用（浏览器无硬件访问权限），微信小程序需在 manifest.json 中配置 "mp-weixin" 的 permission 字段，App 端则依赖原生层是否集成 ZXing 或系统相机模块。

• 微信小程序必须在 manifest.json 里加：

  {"mp-weixin": {"permission": {"scope.userCamera": {"desc": " 用于扫码 "}}}}

• App 端 iOS 需开启 NSCameraUsageDescription 权限描述；Android 6.0+ 需动态申请 android.permission.CAMERA
• H5 端调用 uni.scanCode 会静默失败，控制台无报错，只返回 fail 回调 —— 这是最常被忽略的“假成功”场景

扫码后 callback 不触发？注意 success/fail/complete 的执行时机

uni.scanCode 是异步 API，但它的回调不是 Promise，也不支持 await（除非自行封装）。很多人把逻辑全塞进 success，却没处理 fail 或 complete，导致扫码取消、用户拒权、系统中断等情况完全无感知。

• fail 会在用户主动取消、权限拒绝、系统异常时触发，错误码如 1002（用户取消）、1003（权限被拒绝）
• complete 总是执行，适合做 loading 关闭、按钮状态重置等兜底操作
• 不要依赖 success 唯一出口，尤其在 App 端，部分安卓机型扫码后可能直接走 complete 而不进 success

扫码结果里的 result 格式不一致？解析前先看 scanType

不同码类型返回的 result 内容格式不同：二维码通常是纯文本 URL 或 JSON 字符串，而条形码（如 EAN-13）返回的是数字字符串，微信小程序还可能返回带 weapp 字段的小程序码对象。直接 JSON.parse(result) 会炸。

• 务必先读取 res.scanType，常见值："qr"、"bar"、"datamatrix"、"weapp"
• 对 weapp 类型，要取 res.result 下的 path 和 extraData，不能直接当 URL 处理
• 条形码结果不含协议头，拼接跳转链接时得自己补 https://，否则 uni.navigateTo 会失败

App 端扫码卡顿或识别率低？别硬扛默认参数

uni-app 的 uni.scanCode 在 App 端底层调用的是 DCloud 封装的原生模块，默认启用自动对焦和闪光灯检测，但某些低端 Android 机型反而因此卡顿。识别率低往往不是算法问题，而是画面没对准或环境光不足。

• 加 onlyFromCamera: true 强制走相机，禁用相册选图（避免用户误点相册后流程断裂）
• 设 scanType: ['qr', 'bar'] 明确限定类型，比默认全开快 200ms 左右
• 真机调试时发现预览框模糊，大概率是没调用 uni.startSensing 或相机初始化失败，此时应捕获 fail 并提示“请检查摄像头权限”

实际项目里最麻烦的不是调不通，而是 H5 和小程序共用一套代码时，扫码逻辑在 H5 端悄悄失效，又没 fallback 方案。得提前判断 uni.getSystemInfoSync().platform，该降级就降级，比如 H5 改成手动输入框 + 粘贴识别。