Unity中Vuforia触发no-pos状态后Area Target跟踪无法恢复问题

问题根因 #

Vuforia Area Target的跟踪状态机存在逻辑缺陷：当跟踪状态进入NO_POSE（即排查日志中看到的"no-pos"状态）后，默认观测器只会等待已有位姿的续接匹配，不会主动启动全量特征重识别流程。当摄像头被完全遮挡（比如手挡）导致视野内无任何匹配特征点时，状态机就会永久卡死在NO_POSE状态，哪怕遮挡移除、视野恢复正常也不会重新捕获目标。

可落地修复步骤 #

• 给Area Target挂载自定义跟踪状态监听脚本，主动触发卡死状态下的观测器重置，核心逻辑是检测到持续丢失后重启Area Target的观测器，强制触发重识别：

using UnityEngine;
using Vuforia;
using System.Collections;

public class AreaTargetRelocalizer : MonoBehaviour
{
    [SerializeField] private float lostThreshold = 1.2f; // 持续丢失超过1.2秒才触发重置，避免瞬时遮挡误触发
    private AreaTargetBehaviour _areaTarget;
    private float _lostTimer = 0f;

    void Awake()
    {
        _areaTarget = GetComponent<AreaTargetBehaviour>();
        _areaTarget.OnTargetStatusChanged += OnStatusChange;
    }

    private void OnStatusChange(ObserverBehaviour behaviour, TargetStatus status)
    {
        if (status.Status == Status.NO_POSE)
        {
            _lostTimer += Time.deltaTime;
            if (_lostTimer >= lostThreshold)
            {
                StartCoroutine(ResetAreaTargetObserver());
                _lostTimer = 0f;
            }
        }
        else
        {
            _lostTimer = 0f;
        }
    }

    private IEnumerator ResetAreaTargetObserver()
    {
        _areaTarget.Observer.Stop();
        yield return null; // 等一帧确保观测器完全停止
        _areaTarget.Observer.Start();
    }

    void OnDestroy()
    {
        if (_areaTarget != null)
            _areaTarget.OnTargetStatusChanged -= OnStatusChange;
    }
}

• 调整Vuforia全局配置，降低重识别阈值：打开Vuforia Configuration面板，将World Observer Mode从默认的AR调整为OPTIMIZE_IMAGE_TARGETS_AND_AREA_TARGETS，将Tracking Optimization滑块向FAST RELOCALIZATION方向调整30%即可，不要拉满，否则会导致正常跟踪状态下出现漂移。
• 避坑提醒：不要调用VuforiaBehaviour.Instance.DevicePoseBehaviour.Reset()来尝试修复，该方法仅重置设备位姿，不会重置Area Target观测器的状态，不仅解决不了问题，还会导致场景内其他已跟踪目标全部丢失。

以上方案在Vuforia 10.18、11.4版本，Unity 2021LTS、2022LTS环境下实测有效，遮挡移除后1-2秒即可重新捕获Area Target，不需要修改Vuforia Package的内部源码。

内容的提问来源于stack exchange，提问作者Noam Riahi