不能。uni-app中动态二维码展示与自动识别技术路径互斥:前者静态渲染,后者需实时摄像头流+帧解码;uni.scancode仅支持单次调起,无法实现连续识别;h5端须用html5-qrcode等纯前端方案并启用https;app/小程序端需依赖原生插件如uni-plugin-qrcode-scanner。

不能。uni-app 里“动态二维码展示”和“自动识别”是两个互斥需求——前者是静态渲染(生成后展示),后者依赖实时摄像头流+帧解码,技术路径完全不同,强行混用只会卡在 iOS App 截图为空、H5 权限静默失败、小程序无法连续识别这些坑里。
uni.scanCode 为什么不能用于“自动识别”
它只是调起系统扫码界面,不返回视频流、不提供预览层控制权、不支持连续回调。你点一次,它弹个原生窗口;扫完一个,就关闭;想扫第二个?得再点一次。所谓“自动识别”,本质是“持续捕获 + 实时解码”,uni.scanCode 压根没暴露这个能力。
- 真机上点不动、没反应?大概率是
manifest.json没配mp-weixin.permission.scope.userCamera或 App 端缺原生相机模块 - H5 调用后直接进
fail回调,err.errMsg是not supported—— 浏览器根本不允许前端直接访问摄像头流 - 哪怕配齐权限,在 iOS App 上用
uni.createCameraContext截帧,canvasToTempFilePath也大概率返回空图,这是 WebKit 的硬限制
H5 端唯一可行的自动识别方案
必须放弃 uni.scanCode,改用纯前端视频流方案:用 html5-qrcode(推荐)或 @zxing/browser,它们封装了 getUserMedia + canvas + 解码逻辑,能跑在 HTTPS 环境下。
- 安装:
npm install html5-qrcode --save - 初始化前必须确保页面已启用 HTTPS(HTTP 下
getUserMedia会被浏览器拒绝) - 扫码区域用
div占位,不要套canvas——html5-qrcode自己管理渲染 - 识别回调里拿到
result后,立刻调html5QrCode.clear(),否则会重复触发 - 别用
qrcode.js单独解码:它只处理图片数据,不负责采集,你得自己写截帧循环,极易卡顿漏帧
App / 小程序端要稳定,就得用原生插件
纯 JS 方案在 App 端(尤其 iOS)几乎不可行。DCloud 官方维护的 uni-plugin-qrcode-scanner 是目前唯一能兼顾三端、低延迟、支持连续识别的方案,它在原生层调用摄像头并实时解码,通过 onDecode 回调吐结果。
- 插件市场搜索 ID:12479(对应
uv-qrcode)或直接搜 “qrcode-scanner” - 配置
camera组件时,device-position="back"必须显式设置,iOS 默认前置 - 不要手动调
uni.createCameraContext+jsqr:iOS 截图为空、Android 帧率抖动、小码识别率低于 60% - 小程序端若坚持不用插件,只能退回到
uni.scanCode单次调起模式,谈不上“自动”
动态二维码展示本身没问题,但别和识别混在一起
生成动态二维码用 uqrcodejs 就够了,但它和“自动识别”完全无关。你传个 { uid: this.id, ts: Date.now() },它返 tempFilePath 或 base64,塞进 <image :src="qrcodeUrl"></image> 就完事。想让它“被自动识别”,得另起一套摄像头流程,二者不能共用同一 canvas 或同一变量。
-
uqrcodejs的text必须是字符串,JSON.stringify({})得自己做,否则扫出来是[object Object] - 中文内容必须
encodeURIComponent(),否则 H5 扫码跳转会乱码 - 小程序带
scene参数的码,前端根本生成不了,必须后端调微信/wxa/getwxacodeunlimit接口
真正容易被忽略的点是:H5 的自动识别强依赖 HTTPS,App 的连续识别强依赖原生插件,而小程序压根没有“自动识别”的官方 API。把“动态生成”和“自动识别”当成一件事来搞,90% 的时间会耗在平台兼容性调试上,而不是业务逻辑。











