uni-app h5页面无法直接调用相机等原生api，因其运行在纯浏览器环境，缺乏系统级权限和jsbridge桥接；仅当被嵌入原生webview容器且容器主动注入桥接对象时才可能支持。
不能直接调用。uni-app 生成的 H5 页面本质是普通网页，运行在浏览器环境里，没有权限访问相机、相册、支付 SDK 等原生能力——除非它被嵌入到一个原生容器（如 Android/iOS WebView 或 Flutter WebView）中，且该容器主动提供了 JSBridge。
uni-app H5 页面为什么调用不了 uni.scanCode 或 uni.chooseImage
这些 API 在 H5 平台默认降级为 noop（空函数）或抛出“not supported”的错误，因为浏览器环境无法提供对应硬件或系统级能力。你看到的文档里写着“H5 支持”，实际指的是“H5 + 原生 WebView 容器”场景下，由容器桥接后支持，不是纯浏览器支持。
- 在微信内置浏览器打开 H5 页面：
uni.scanCode会报错scanCode:fail api not exists - 在 Chrome 桌面版访问同一地址：
uni.chooseImage返回空数组或直接静默失败 - 即使加了
uni.getEnv()判断为h5，也不代表能用原生 API —— 它只说明当前运行在 H5 构建产物里，不说明宿主环境是否具备桥接能力
哪些情况下 H5 才能调用原生能力
必须满足两个前提：H5 页面被原生容器加载 + 容器在 WebView 初始化时注入了可用的 JSBridge 对象。
- Android：原生侧调用
addJavascriptInterface注入对象（如window.android），且方法需加@JavascriptInterface注解 - iOS：原生侧通过
WKScriptMessageHandler注册messageHandlers（如window.webkit.messageHandlers.share） - Flutter：通过
JavascriptChannel创建通道（如window.FlutterBridge.postMessage） - uni-app 自己的
web-view组件（App 端）：内部已封装桥接，H5 页面可通过uni.webView.postMessage发送消息，App 原生层监听并响应
怎么安全判断并调用原生能力
别写 if (uni.getEnv().h5) { uni.scanCode() } —— 这在纯浏览器里必然失败。正确做法是先探测桥接对象是否存在，再调用封装好的适配函数。
- 检查
window.android?.share或window.webkit?.messageHandlers?.scan是否为函数 - 避免直接
eval("doSomething()")：原生侧调用 H5 函数前，必须等UniAppJSBridgeReady事件触发（uni-app 内部会发这个事件） - 参数传递要用
JSON.stringify包装，避免特殊字符（如+、/）被 URL 解析破坏；原生侧负责 decode - H5 页面启动时立刻解析
location.search获取 token/uid，不要依赖localStorage或document.referrer—— WebView 初始化阶段它们不可靠
常见错误和绕不过去的限制
很多开发者卡在“明明写了 bridge 调用，却没反应”，问题往往不在 JS 代码本身。
-
window.android?.share是undefined：原生未注入，或注入时机太晚（必须在页面 load 前完成） - iOS 上
window.webkit.messageHandlers是空对象：WKWebView 配置漏了userContentController.add，或启用了allowsInlineMediaPlayback导致 message 被拦截 - Android 4.2+ 报
Method not found：Java 方法缺@JavascriptInterface注解 - Flutter 里
window.kjToLessonSubmit报错：Dart 侧JavascriptChannel.name和 JS 里写的字符串不一致（大小写敏感）
真正决定 H5 能否调用原生能力的，从来不是 uni-app 的 JS 代码，而是原生容器有没有把桥接准备好、什么时候准备好的、以及是否暴露了正确的入口。JS 层只是消费者，不是生产者。
