UD5工具箱
AR虚拟量尺 - 使用教程
在开始测量之前，请确保以下条件：
- 光线充足：确保被测物体周围有充足的光线，避免阴影和反光影响图像识别
- 稳定设备：尽量将设备放在稳定的位置，或用双手稳持，减少画面抖动
- 参考物准备：准备好一个已知尺寸的参考物，如信用卡、A4纸或硬币
- 浏览器权限：允许浏览器访问摄像头权限
- 网络连接：首次加载页面需要网络连接，之后可离线使用
最佳实践：将被测物体放在平坦的表面上，确保物体完全在摄像头画面内，并且与摄像头保持适当的距离（建议20-50厘米）。这样可以最大程度减少透视变形对测量精度的影响。
校准是保证测量精度的关键步骤。请按以下流程进行：
- 打开工具页面，允许摄像头权限后可以看到实时画面
- 在"参考物选择"区域选择您手边有的参考物类型
- 将参考物放在摄像头画面中，确保参考物完全可见
- 在画面上标记参考物的两个对角点或一条边
- 系统会自动计算像素密度并显示校准状态
不同参考物的使用建议：
- 信用卡：最推荐的校准方式，尺寸标准，便于携带。标记短边（53.98mm）精度最高
- A4纸：适合测量较大物体，标记长边（297mm）或短边（210mm）均可
- 一元硬币：小巧便携，但标记圆形边缘需要一定技巧
- iPhone：利用随身手机，但需要注意不同型号尺寸不同
提示：校准时尽量让参考物与被测物体在同一平面上，避免因透视变形导致精度下降。如果参考物和被测物体不在同一平面上，测量结果可能会有较大误差。
校准完成后即可开始测量。测量操作非常简单：
- 将摄像头对准被测物体
- 在画面上点击物体的一端作为测量起点
- 移动到物体的另一端，点击作为测量终点
- 系统会自动计算并显示两点之间的实际距离
- 测量线和距离值会实时显示在画面上
提高测量精度的技巧：
- 尽量从物体正上方拍摄，减少透视变形
- 标记点尽量放在物体的精确边缘位置
- 对于较长物体，可以分段测量后相加
- 使用冻结画面功能在静态图像上精确标记
- 多次测量取平均值可以提高可靠性
如果需要测量多个距离，可以继续点击添加新的测量点。所有测量结果会以列表形式显示在侧边栏中，支持单独删除或全部清除。
冻结画面功能可以将当前摄像头画面暂停，便于在静态图像上进行精确测量。使用方法：
- 调整摄像头角度，使被测物体清晰可见
- 点击"冻结画面"按钮，画面会暂停
- 在冻结的画面上精确标记测量起止点
- 查看测量结果
- 点击"解冻"按钮恢复实时画面
冻结画面特别适合以下场景：需要精确标记小尺寸物体的边缘、测量距离较远导致画面不稳定、以及需要在多个位置标记测量点的复杂测量任务。冻结后仍然可以添加新的测量点，所有操作都在当前冻结帧上进行。
测量完成后，您可以根据需要切换显示单位：
- 点击"mm"按钮切换到毫米单位，适合精密测量
- 点击"cm"按钮切换到厘米单位，日常测量最常用
- 点击"inch"按钮切换到英寸单位，适合英制单位需求
切换单位后，所有已测量的数据会自动转换为新单位显示，无需重新测量。测量结果支持一键复制到剪贴板，可以直接粘贴到笔记、消息或其他应用中使用。
此外，工具还提供测量历史记录功能，可以查看本次使用的所有测量数据。清除按钮可以一次性清除所有测量数据和校准信息，重新开始新的测量任务。
如果您的设备支持WebXR AR功能，可以体验增强现实测量模式：
- 点击"AR模式"按钮进入WebXR AR会话
- 按照屏幕提示移动设备，让系统扫描环境平面
- 在检测到的平面上放置虚拟标尺起点
- 移动设备或手指拖动标尺终点
- 虚拟标尺会固定在现实空间中，提供更直观的测量体验
AR模式要求：需要Android 8.0+（Chrome 79+）或iOS 12+（Safari 12+）设备，且设备需要支持ARCore或ARKit。如果设备不支持，按钮会显示为不可用状态。
AR模式的优势在于虚拟标尺直接叠加在现实世界中，不受摄像头视角和距离的限制，可以进行更大范围的空间测量。标记点会锚定在现实空间中的固定位置，即使移动设备也不会丢失。