升级Vuforia至10.22.5后，如何稳定原生应用的地面平面追踪？

一、核心配置调整 #

• 将Plane Finder的Quality Mode从FAST改为QUALITY，更高的质量模式会启用更精细的特征检测逻辑，有效减少抖动。
• 开启Plane Manager的Continuous Plane Detection选项，让Vuforia持续优化平面的位置与姿态，避免单次识别后的漂移。
• 在Ground Plane配置中，将Tracking Stability权重设为0.7-0.9（范围0-1），降低模型对瞬时姿态变化的敏感度。

二、环境与使用场景优化 #

• 优先选择纹理丰富的地面（如带花纹的地板、地毯），纯色/低纹理地面会导致Vuforia特征点不足，加剧抖动。
• 引导用户避免快速移动设备，Vuforia 10.x的单追踪模式对快速运动的容错性低于旧版本，缓慢移动能提升追踪稳定性。
• 确保环境光照均匀，避免强光直射或过暗场景，极端光照会干扰相机曝光，影响特征点提取精度。

三、代码层面优化 #

• 对Vuforia返回的姿态数据做滑动加权平均处理，过滤瞬时抖动。示例伪代码：

std::vector<Pose> poseHistory;
const int HISTORY_FRAMES = 7;

Pose getSmoothedPose(Pose newPose) {
    poseHistory.push_back(newPose);
    if (poseHistory.size() > HISTORY_FRAMES) {
        poseHistory.erase(poseHistory.begin());
    }

    Pose smoothedPose;
    float totalWeight = 0.0f;
    // 越新的帧权重越高，提升实时性的同时平滑抖动
    for (int i = 0; i < poseHistory.size(); i++) {
        float weight = i + 1;
        smoothedPose += poseHistory[i] * weight;
        totalWeight += weight;
    }
    return smoothedPose / totalWeight;
}

• 若应用帧率过高（>60fps），可将模型姿态更新频率降至每2帧一次，减少高频抖动对视觉的影响。

四、额外排查项 #

• 确认应用已获取CAMERA权限，且相机分辨率设置为Vuforia推荐的1080p，低分辨率会导致特征点数量不足。
• 测试目标用户群体的设备型号，排查是否存在老旧设备的兼容性问题，Vuforia 10.x对部分低端设备的追踪逻辑做了调整。
• 在应用启动或场景切换时调用Vuforia::reset()重置引擎，清除旧追踪数据残留，避免干扰新的平面识别。

内容的提问来源于stack exchange，提问作者Yuki.H