UD5工具箱
准备工作
在开始使用离线扫码器之前，请确保满足以下基本条件：
- 使用支持 WebAssembly 和 MediaDevices API 的现代浏览器（推荐 Chrome 57+、Firefox 52+、Safari 11+、Edge 16+）
- 确保浏览器已允许工具页面访问摄像头（首次使用时浏览器会弹出权限请求弹窗，请点击"允许"）
- 若使用图片上传或剪贴板粘贴功能，请确保浏览器已允许工具页面访问文件系统和剪贴板
- 确保设备摄像头工作正常，无物理遮挡或驱动问题
场景一：实时摄像头扫描
这是最常用的扫码方式，适用于可以直接对准条码进行扫描的场景。以下是详细操作步骤：
- 打开工具页面：在浏览器地址栏中输入离线扫码器的网址，加载并进入工具主页。页面加载完成后，可以看到"实时扫描"、"图片上传"和"剪贴板粘贴"三个功能入口选项卡。
- 切换到实时扫描模式：点击"实时扫描"选项卡（默认已选中）。此时页面会显示摄像头预览区域以及相关的控制按钮。
- 授权摄像头权限：首次使用时，浏览器会在地址栏附近弹出摄像头权限请求弹窗。请点击"允许"按钮以授权工具访问您的摄像头。如果之前拒绝过权限，可以点击浏览器地址栏左侧的锁形图标，在弹出的权限设置中手动开启摄像头权限。
- 启动扫描：点击"开始扫描"按钮，系统将启动摄像头并开始实时检测画面中的二维码或条形码。请将摄像头对准要扫描的码，保持适当的距离（通常为 10-30 厘米），确保码的画面清晰且完整地出现在预览区域内。
- 切换摄像头（可选）：如果设备支持前后摄像头切换（常见于手机和平板），可以点击"切换摄像头"按钮在前后摄像头之间切换。当对准自己的码不在当前摄像头视角内时，切换摄像头非常有用。
- 获取扫描结果：当系统成功识别到画面中的二维码或条形码时，会立即在页面上弹出扫描结果卡片，显示解码后的文本内容、条码格式类型以及时间戳。您可以根据需要选择"复制结果"、"打开链接"（仅限 URL 类型结果）或"网络搜索"等后续操作。
- 连续扫描：实时扫描模式下，识别成功后扫描不会自动停止。您可以继续对准下一个码进行扫描，系统会自动记录每一次成功的识别结果。所有扫描结果都会被追加到扫描历史列表中。
- 停止扫描：点击"停止扫描"按钮即可关闭摄像头并停止实时检测。关闭摄像头可以节省设备电量并释放系统资源。
场景二：图片上传识别
当您已经将二维码或条形码保存为图片文件时，可以使用此方式进行识别。操作步骤如下：
- 切换到图片上传模式：点击页面上的"图片上传"选项卡，切换到图片上传识别界面。
- 选择图片文件：点击"选择图片"按钮或直接将图片文件拖拽到指定的上传区域。系统支持 JPG、PNG、BMP、WebP 等常见图片格式。您也可以直接点击上传区域来打开文件选择对话框。
- 等待识别完成：图片上传后，系统会自动进行解码处理。整个过程通常在毫秒级别完成，具体速度取决于图片大小和码的复杂度。
- 查看与处理结果：识别成功后，结果展示方式与实时扫描模式相同。您可以选择复制、打开链接或进行搜索。
提示：为了获得最佳识别效果，请确保上传的图片中二维码或条形码的画面清晰、完整、无严重变形或模糊。如果图片中包含多个码，系统通常会识别画面中最大或最清晰的那一个。
场景三：剪贴板粘贴识别
当您从聊天软件、邮件或其他来源接收到二维码图片并复制到剪贴板时，可以使用此方式快速识别。操作步骤如下：
- 复制图片到剪贴板：在来源应用程序中选中二维码图片，使用 Ctrl+C（macOS 为 Cmd+C）将图片复制到系统剪贴板。对于手机端，可以长按图片后选择"复制图片"。
- 切换到剪贴板粘贴模式：点击页面上的"剪贴板粘贴"选项卡，切换到粘贴识别界面。
- 粘贴图片：在粘贴识别界面的指定区域中，使用 Ctrl+V（macOS 为 Cmd+V）将剪贴板中的图片粘贴进去。手机端用户可以长按粘贴区域后选择"粘贴"。此外，您也可以直接点击"从剪贴板粘贴"按钮来触发粘贴操作。
- 查看与处理结果：系统会自动识别粘贴进来的图片中的二维码或条形码，并展示解码结果。后续操作方式与其他扫描模式相同。
使用格式选择器
在所有扫描模式的界面中，都提供了一个格式选择下拉菜单。通过合理使用格式选择器，可以显著提升识别效率：
- 自动识别（默认）：系统将尝试所有支持的格式进行解码，通用性最强但速度相对稍慢
- 指定格式：当您明确知道目标码的类型时（例如扫描超市商品的 EAN-13 条码），选择对应格式可以跳过不相关的格式检测，大幅提升识别速度和准确率
注意：选择错误的格式可能导致识别失败。如果您不确定目标码的格式，请保持"自动识别"模式。
查看和管理扫描历史
所有成功识别的条码内容都会自动保存到扫描历史中。以下是管理历史记录的操作方法：
- 查看历史记录：在工具页面的底部或侧边栏区域，可以找到"扫描历史"面板。历史记录按照时间倒序排列，最新的记录显示在最上方。
- 查看详细信息：点击任意一条历史记录，可以展开查看完整的扫描内容、条码格式以及扫描时间。
- 复制历史内容：每条历史记录旁都提供了"复制"按钮，点击后可将该条记录的内容复制到剪贴板。
- 删除单条记录：点击历史记录旁的"删除"图标可以移除单条不需要的记录。
- 清空全部历史：点击"清空历史"按钮可以一次性删除所有历史记录。此操作不可撤销，请谨慎使用。
历史记录最多保留 50 条。当数量达到上限时，系统会自动删除最早的记录以为新记录腾出空间。所有数据仅存储在浏览器的 localStorage 中，清空浏览器数据或切换浏览器后历史记录将不可恢复。
常见问题处理技巧
在使用过程中，如果遇到识别困难，可以尝试以下技巧来提升识别成功率：
- 确保条码或二维码的画面平整，无褶皱、反光或阴影遮挡
- 调整摄像头与目标码之间的距离，保持画面清晰且码占据画面适当比例
- 在光线充足的环境下进行扫描，避免过暗或过亮的极端光照条件
- 尝试使用格式选择器指定正确的条码格式
- 如果实时扫描持续失败，可以尝试将码保存为图片后使用图片上传方式识别
- 对于模糊或低分辨率的图片，可以先尝试使用图片编辑工具提升对比度后再上传识别