扫描模式 API
在 WebViewGold for iOS 中微调 QR 码和条形码扫描器的相机扫描行为。
如果您的 Web 应用在屏幕上呈现待扫描的信息（例如二维码），那么将屏幕亮度调到 100% 并防止屏幕休眠会很有帮助。WebViewGold 提供了 Scanning Mode API，可动态启用这些最佳的扫描条件。
该 API 包含 3 个命令：
- "auto" = 开启扫描模式，并在页面跳转时自动关闭。
- "on" = 开启扫描模式，页面跳转后仍保持开启。
- "off" = 关闭扫描模式。
链接到此类 URL 即可使用 Scanning Mode API：
<a href="scanningmode://auto">Enable Scanning Mode; will automatically disable on page redirect</a>
<a href="scanningmode://on">Enable Scanning Mode; will persist until manually disabled</a>
<a href="scanningmode://off">Disable Scanning Mode</a>
SDK 风格的实现说明
将此功能视为向 Web 层公开的原生能力：将生产网站或 PWA 作为唯一可信来源，然后使用文档中的 WebViewGold 配置标志、URL 命令和 JavaScript 桥接调用，仅在能够带来价值的地方启用原生 iOS 行为。这种方式让代码库易于维护，因为同一个 Web 应用只需极少的条件逻辑即可同时服务于浏览器、WebViewGold for iOS 以及其他 WebViewGold 平台。
为获得可靠的结果，建议优先使用 HTTPS 端点、稳定的路由名称、在界面中明确的成功/错误状态，以及封装原生调用的小型 JavaScript 辅助函数。例如，使用 jQuery Mobile、Lovable、Base44、Bolt、WordPress、Bubble、自定义 React/Vue/Angular 技术栈或静态 HTML 构建的 Web 应用，可以提供单个按钮或事件处理程序来触发原生 WebViewGold API，同时仍为浏览器提供优雅的回退方案。
- 推荐的集成模式：检测应用上下文，调用 WebViewGold API，然后在原生回调或路由变更后更新 Web 界面。
- 测试清单：在真机或打包构建上验证该功能，检查权限和商店审核文案，并确认仅使用浏览器的用户仍能获得有用的回退方案。
- SEO 优势：让功能页面、路由标题和结构化内容在您的网站上保持可被索引，同时由 WebViewGold 为 iOS 用户提供原生应用外壳。