Manejo de anomalías en el rastreador AR de plano

Este artículo explica cómo manejar anomalías en el rastreador AR de plano de WeChat mediante el registro de callbacks.

Antes de comenzar

• Comprende mediante el flujo de trabajo de MegaTracker:

  • El rastreador AR de plano de xr-frame es esencialmente un encapsulamiento de la capacidad de plano 6DoF de VisionKit.
  • Cómo funciona MegaTracker sobre xr-frame.

• Comprende el concepto y flujo de la sesión AR

Por qué ocurren anomalías en la detección de planos

En ciertas situaciones (como paredes blancas extensas en la imagen, cámara obstruida durante mucho tiempo, etc.), el rastreador AR de plano de WeChat puede presentar estados anómalos.

En estos casos, el rastreador AR de plano no puede generar correctamente la pose de la cámara por fotograma (es decir, datos 6DoF), lo que impide el funcionamiento de MegaTracker.

Cuando la imagen se normaliza (textura rica, cámara sin obstrucciones) durante un período, el rastreador AR de plano recupera su funcionamiento y MegaTracker también se restablece.

Configurar el comportamiento ante anomalías en la detección de planos

Registra un callback de manejo de anomalías mediante setPlaneDetectionErrorBehavior(behavior). Este callback se activará cuando se detecte una anomalía, permitiendo al desarrollador implementar alertas personalizadas, ocultar contenido 3D u otra lógica de manejo.

session.setPlaneDetectionErrorBehavior(() => {
    wx.showToast({
        icon: 'none',
        title: `Resultado anómalo en la detección de planos de WeChat. Por favor, mueva la cámara sobre una superficie plana para recuperar el seguimiento`,
        duration: 2000,
    });
});

Este ejemplo utiliza la interfaz setPlaneDetectionErrorBehavior(behavior) de la sesión para registrar un callback que muestra una ventana Toast cuando se detecta una anomalía en el plano.