UD5工具箱
什么是 Shape Detection API？
Shape Detection API 是一组浏览器原生 API，允许在客户端直接进行图像识别检测，包括人脸检测（FaceDetector）、条形码/二维码检测（BarcodeDetector）和文本检测（TextDetector）。所有检测均在浏览器本地完成，无需上传图像到服务器，保障隐私安全。相比传统第三方库（如 zxing-js、face-api.js），Shape Detection API 零依赖、性能优越（底层硬件加速）、不增加打包体积。本演示工具让开发者可以直观体验这三种检测 API 的实际效果。
哪些浏览器支持这些 API？
BarcodeDetector：Chrome 83+、Edge 83+、Opera 69+ 已稳定支持，Android Chrome 也全面支持。FaceDetector：需要在 Chrome 中开启 chrome://flags/#enable-experimental-web-platform-features 实验性标志。TextDetector：目前几乎没有浏览器原生支持，属于实验阶段。Firefox 和 Safari 目前均不支持这些 API。本工具在检测前会检查 API 可用性，给出明确的状态提示。
如何在 Chrome 中启用人脸检测？
在 Chrome 地址栏输入 chrome://flags/#enable-experimental-web-platform-features，将该选项设为 Enabled，然后重启浏览器。重启后 FaceDetector API 即可使用。注意这是实验性功能，可能不够稳定。启用后，本工具的人脸检测功能就能正常工作。如果不开启此标志，人脸检测会提示 API 不可用。
BarcodeDetector 支持哪些条形码格式？
BarcodeDetector 支持 13 种格式：QR Code、Aztec、Code 128、Code 39、Code 93、Codabar、Data Matrix、EAN-13、EAN-8、ITF、PDF417、UPC-A、UPC-E。其中 QR Code 和 Data Matrix 是最常用的二维码格式，EAN-13 和 UPC-A 是商品条形码常用格式。在本工具中，可以通过条形码格式过滤功能选择只检测特定格式，按住 Ctrl 键可以多选。
检测是在本地还是上传到服务器？隐私安全吗？
完全本地处理！所有检测均在您的浏览器中完成，图像数据不会上传到任何服务器。摄像头视频流和上传的图片仅在您的设备上处理。这也是 Shape Detection API 相比云端 API 的最大优势——零隐私泄露风险。本工具严格遵循这一原则，不发送任何网络请求，不收集任何用户数据。
实时摄像头扫描时为什么检测不到？
常见原因包括：光线不足，尝试在明亮环境下使用；条形码/二维码太小或模糊，尝试靠近或调整角度；摄像头对焦问题，保持稳定等待自动对焦；选择了错误的摄像头，扫描条形码建议使用后置摄像头；格式过滤设置过于严格，尝试选择全部格式。如果以上方法都无效，可能是浏览器不支持 BarcodeDetector API，可以尝试使用 Chrome 浏览器。
FaceDetector 的 fastMode 是什么意思？
快速模式（fastMode=true）检测速度更快，适合实时视频流处理，但可能漏检较小或侧脸。精确模式（fastMode=false）检测精度更高，能检测到更多人脸和侧脸，但处理时间稍长。对于静态图片建议关闭快速模式以获得更好的检测效果。在本工具中，可以通过人脸检测模式下的快速模式开关来对比两种模式的效果差异。
Shape Detection API 与传统方案相比有何优势？
三大核心优势：①零依赖——无需引入额外 JS 库，浏览器原生支持；②性能优越——底层使用硬件加速和系统级优化；③隐私安全——数据不出浏览器，零泄露风险。此外还有体积小（不增加打包体积）等优势。缺点是浏览器兼容性有限，目前主要在 Chrome 系浏览器中可用。对于兼容性要求不高的内部工具或 Chrome-only 场景，Shape Detection API 是最佳选择。
移动端使用有什么注意事项？
Android Chrome 对 BarcodeDetector 支持良好，适合扫码场景；iOS Safari 不支持这些 API，建议使用 Chrome；扫描条形码时使用后置摄像头效果更佳；移动端摄像头权限需要 HTTPS 连接或 localhost；在移动端扫描 QR 码时保持手机稳定，避免抖动。如果在移动端遇到问题，首先检查浏览器版本和摄像头权限设置。
检测到的条形码 rawValue 可以做什么？
rawValue 是条形码/二维码解码后的原始文本内容。如果是 URL 可以直接打开，如果是商品条码（EAN/UPC）可以查询商品信息，如果是文本信息可以复制使用。本工具提供了「已复制到剪贴板」功能，方便您使用检测结果。在实际应用中，可以根据 rawValue 的内容类型执行不同的操作——比如打开链接、查询数据库、跳转页面等。