算法与参数
算法怎么选
| 算法 | 推荐场景 | 主要限制 |
|---|---|---|
| SIFT | 日常使用、地图缩放或旋转存在小幅变化 | 低纹理区域仍可能无法定位,计算量较高 |
| TM | 小地图比例固定、画面清晰、目标区域较唯一 | 对比例变化、重复纹理和遮挡敏感 |
当前客户端只提供 SIFT 与模板匹配(TM)。历史版本曾提供 ORB,现已移除。
SIFT 缓存档位
SIFT 按已保存选区的 min(宽度, 高度) 直接定档:
| 选区短边 | 使用的缓存 |
|---|---|
135–139px | dynamic_136 |
140–147px | dynamic_144 |
148–157px | dynamic_152 |
158–163px | dynamic_160 |
164–192px | compact_165 |
193–256px | standard_220 |
257–512px | 以 16px 为间隔的动态大尺寸档位 |
>512px | 不支持 |
164×164px 会直接使用紧凑 165 档,不会生成动态缓存。模板匹配继续按实际画面调整候选尺度,不进入动态 SIFT 缓存流程。
首次生成动态缓存
确认选区后,客户端会先查找可用缓存。有匹配的缓存就直接使用;首次使用该尺寸时,选择“生成并使用当前尺寸”。生成期间,地图按 1024 像素分块处理,以降低内存占用。
以选区短边为例,273 像素使用 272 档,建议预留 2 GiB 可用内存;512 像素建议预留 3.5 GiB。提示值包含余量,实际占用随尺寸变化。所需磁盘空间以客户端提示为准。
生成可能需要数十秒到数分钟。中途取消会保留已确认的选区,下次启动追踪时可继续准备缓存。更新后已有的有效缓存可以直接使用。
刷新间隔
“刷新间隔”主要控制服务状态输出频率,并不等同于 SIFT 每秒识别次数。默认 50 ms 已兼顾响应和客户端解码负载。
不建议设置为 35 ms
较低间隔会增加 JSON、预览图和 UI 调度压力,却不会按比例提高定位能力。旧版本中,只有坐标的新帧还可能覆盖携带小地图图片的帧,使“力大飞砖”指针看起来停止更新。出现该问题时恢复 50–60 ms 并重启追踪。
SIFT 参数
- Match Ratio:越低通常越严格,误匹配减少,但更容易识别不到。
- 最小匹配点数:提高后更稳,但低纹理区域更难通过。
- RANSAC 阈值:控制几何一致性的容差。
- CLAHE 增强:改善亮度不均和阴影场景,不代表一定提升所有画面。
不清楚参数含义时使用“恢复默认”,一次只修改一个参数并在同一地点对比。
