uni.scanCode在H5不支持，需用html5-qrcode或input方案；App/小程序需配置相机权限、调用uni.authorize并正确设置scanType等参数；自定义识别应避免uni.createCameraContext。
uni.scanCode 在绝大多数平台能直接扫码，但 H5 环境完全不支持——这不是你代码写错了，是浏览器根本没开放实时摄像头扫码的权限接口。
uni.scanCode 调用失败的常见原因和检查点
真机跑不起来、黑屏、报错 fail sys permission denied 或直接静默失败，90% 是权限或配置没到位：
- manifest.json 里没配相机权限：App 端要勾选「Camera(相机)」模块；Android 需确认
"permissions"数组含"android.permission.CAMERA"；iOS 要补"NSCameraUsageDescription"描述字段 - 微信小程序需在
mp-weixin节点下加 permission 配置：{"scope.camera": {"desc": "用于扫码"}} - 没先调
uni.authorize({ scope: 'scope.camera' })就直接扫——iOS 和部分安卓会直接拒绝，连弹窗都不给 - 用户之前点过“拒绝”，后续再调
uni.authorize不会再次弹窗，得引导去系统设置手动开启
H5 平台必须换方案：input + qrcode.js 或 html5-qrcode
uni.scanCode 在 H5 调用时会立刻进 fail 回调，错误信息是 not supported。你不能靠它，必须切换技术栈：
- 用
<input type="file" accept="image/*" capture="environment">拍照后识别：适合对实时性要求不高、允许用户手动触发的场景（比如上传截图） - 用
html5-qrcode库：它封装了getUserMedia+canvas+ 解码逻辑，能实现接近原生的实时扫码体验，且无需后端、纯前端运行 - 别用
qrcode.js单独解码——它只处理图片数据，不负责视频流采集，得自己搭 canvas 截帧逻辑，容易卡顿或漏帧
uni.scanCode 关键参数怎么设才靠谱
别全靠默认值，几个参数直接影响成功率和业务逻辑：
-
scanType：设成['qrCode']比默认全开更稳，避免误识别条形码；若需兼容一维码，加'barCode'即可 -
onlyFromCamera：设为true可禁用相册选图，适合签到、核销等强现场场景 -
autoDecodeCharSet：设为true能更好处理中文、特殊符号，尤其扫带中文参数的链接时别漏掉 - H5 平台传任何参数都无效——它压根不会执行，参数只是白写
想自定义扫码界面？别碰 uni.createCameraContext 做实时识别
uni.createCameraContext 仅支持 App 和微信小程序（基础库 ≥ 2.7.0），H5 完全不可用。而且它本身不提供解码能力，你还得自己接 jsqr 或类似库，再手动做 canvas 渲染、帧采样、灰度预处理——调试成本高、性能难控、小码识别率低。
真正稳定可控的做法是：
- App / 小程序端优先用
uni.scanCode（封装好、权限路径清晰、返回结构统一） - H5 端用
html5-qrcode（开箱即用、自动处理权限/设备选择/帧率控制/解码重试） - 需要长按识别图片？直接用
<image show-menu-by-longpress="true">，微信原生支持，无需 JS 解码
uni.authorize 必须在用户主动交互（如按钮点击）后调用，否则会被系统拦截；而 H5 的 html5-qrcode 初始化失败时，如果不显式 fallback 到 input 方案，整个扫码流程就断了。 
