UD5工具箱
AR虚拟量尺 - 常见问题
本工具的测量原理基于图像分析和比例标定。通过已知尺寸的参考物（如信用卡）建立像素与实际尺寸的对应关系（像素密度），然后测量目标物体两点之间的像素距离，乘以比例系数即得到实际距离。这本质上是通过计算机视觉算法实现的软件测量方案。精度取决于摄像头分辨率、参考物校准质量和拍摄角度等因素。虽然不如专业测量工具精确，但在日常场景中可以提供合理的参考值。
提高精度的方法包括：确保光线充足且均匀，避免强烈的阴影或反光干扰；从物体正上方垂直拍摄，减少透视变形；让参考物与被测物体在同一平面上；尽量将物体放在画面中心位置；使用较大的参考物（如A4纸代替硬币）进行校准，因为更长的参考边长意味着更小的相对误差；对同一物体进行多次测量取平均值；使用冻结画面功能在静态图像上精确标记；对于较长物体采用分段测量后相加的方式。遵循这些技巧可以显著提高测量的可靠性。
基础测量功能（摄像头模式）支持大多数现代智能设备。需要设备有摄像头且浏览器支持WebRTC getUserMedia API。兼容Chrome 53+、Firefox 36+、Safari 11+、Edge 12+等主流浏览器。Android和iOS手机、平板以及带有摄像头的笔记本电脑均可使用。WebXR AR增强模式需要更严格的设备支持：Android 8.0以上配合Chrome 79以上版本（需支持ARCore），或iOS 12以上配合Safari 12以上版本（需支持ARKit）。桌面端浏览器通常不支持AR模式，但基础测量功能不受影响。
完全安全。本工具的所有数据处理均在浏览器本地完成，摄像头视频流不会录制、存储或上传到任何外部服务器。工具通过WebRTC getUserMedia API获取视频流，通过Canvas API进行图像分析，所有计算均在用户设备上实时完成。视频数据在处理完毕后立即释放，不会持久化存储。关闭页面后，包括校准信息和测量结果在内的所有临时数据将被完全清除。本工具不使用任何第三方分析服务或追踪脚本，用户隐私得到最大程度的保护。
冻结画面功能允许用户暂停摄像头实时画面，在静态图像上进行精确的测量操作。这在以下场景中特别有用：需要精确标记小尺寸物体的边缘时，实时画面的微小抖动会影响标记精度；测量距离较远导致手持设备不稳定时；需要在多个位置标记测量点的复杂测量任务中。冻结后仍然可以添加新的测量点，所有操作都在当前冻结帧上进行。解冻后画面立即恢复，无需重新加载，不影响后续测量。这个功能对于提高标记精度非常有帮助。
参考物校准是必需的，因为图像中的像素距离与实际物理尺寸之间的比例关系受多种因素影响，包括摄像头分辨率、镜头焦距、拍摄距离和角度等。不同设备的摄像头参数不同，同一设备在不同距离拍摄时像素代表的实际尺寸也不同。如果没有校准，无法建立准确的比例关系。参考物校准就是在当前拍摄条件下建立这个比例关系的过程。这就好比用尺子量东西前需要先确认尺子的刻度是否准确。选择标准尺寸的参考物可以确保校准的准确性。
普通摄像头模式通过2D屏幕显示摄像头画面，用户在屏幕上标记测量点，系统计算像素距离并转换为实际尺寸。WebXR AR模式则利用设备的AR能力（ARCore/ARKit）将虚拟标尺直接叠加在现实世界中，提供3D空间中的测量体验。AR模式的优势在于：虚拟标尺固定在现实空间中，可以围绕物体从不同角度观察；支持更大范围的空间测量；提供更直观的深度感知。但AR模式对设备要求更高，不是所有设备都支持。不支持AR的设备会自动使用普通摄像头模式，基础测量功能不受影响。
本工具提供便捷的测量结果管理功能。所有测量结果会以列表形式显示在侧边栏中，每条记录包含测量距离和所用单位。用户可以一键复制单条测量结果到剪贴板，方便粘贴到笔记、消息或其他应用中使用。单位切换后所有数据会自动转换，无需重新测量。工具还提供清除功能，可以一次性清除所有测量数据和校准信息，重新开始新的测量任务。由于工具采用纯前端架构，数据存储在浏览器内存中，关闭页面后数据会自动清除。