摄像头扫码

解决的痛点

在仓库盘点或前台核验时，频繁扫描合同、单据上的二维码是常见操作。但让业务人员为此专门打开原生扫码 App 或安装桌面工具，往往意味着审批流程变长、现场等待时间增加。尤其是在工位电脑或手持终端上，浏览器内的轻量级方案能显著降低操作门槛。

工作原理

该技能基于 html5-qrcode 实现浏览器端扫码，核心流程如下：

• 用户手势触发：页面放置一个 div 容器和一个「开始扫码」按钮。出于安全策略，相机必须由明确的用户点击动作来唤醒。
• 环境校验：在非安全上下文中，浏览器会禁止调用摄像头。技能会明确提示用户必须在 HTTPS 或 localhost 环境下使用。
• 回调与停止：扫码成功后，系统回调文本并填充单号或打开详情。为节省电量与保护隐私，默认在成功一次后立即调用 stop 方法关闭相机。
• 异常处理：当权限被拒绝时，技能会给出清晰的中文引导，提示用户前往系统设置允许摄像头访问。

适用边界

该方案聚焦于单次、即时的现场扫码需求，不包含离线识别或连续批处理能力。隐私方面，技能不扫描用户相册整库，若需「选图识别」需提供单独按钮。

此外，严禁在未经提示的情况下持续后台录像，也禁止将扫码结果默认发送至不明外网。离开当前路由时，必须确保相机已停止。