Traitement des anomalies du tracker AR planaire

Cet article explique comment gérer les anomalies du tracker AR planaire WeChat en enregistrant des callbacks.

Commencer par

• Comprendre via le workflow MegaTracker :

  • Le tracker AR planaire de xr-frame est essentiellement un encapsulage de la fonctionnalité planaire 6DoF de VisionKit.
  • Comment fonctionne MegaTracker sur xr-frame.

• Comprendre le concept et processus des sessions AR

Pourquoi des anomalies de détection plane surviennent

Dans certaines situations (comme un mur blanc occupant une grande partie de l'image, une caméra obstruée longtemps, etc.), le tracker AR planaire WeChat peut présenter des anomalies d'état.

Dans ce cas, le tracker AR planaire ne peut pas produire normalement la pose de caméra par image (données 6DoF), empêchant MegaTracker de fonctionner.

Lorsque l'image redevient normale (textures riches, caméra non obstruée) pendant un certain temps, le tracker AR planaire reprend son fonctionnement et MegaTracker aussi.

Configurer le comportement en cas d'anomalie de détection plane

Enregistrez un callback de gestion d'anomalie via setPlaneDetectionErrorBehavior(behavior). Lorsqu'une anomalie est détectée, ce callback est déclenché, permettant aux développeurs d'implémenter des alertes personnalisées, masquer du contenu 3D ou d'autres logiques de traitement.

session.setPlaneDetectionErrorBehavior(() => {
    wx.showToast({
        icon: 'none',
        title: `La détection plane WeChat est anormale, veuillez déplacer la caméra sur une surface plane pour rétablir le suivi`,
        duration: 2000,
    });
});

Cet exemple utilise l'interface setPlaneDetectionErrorBehavior(behavior) de session pour enregistrer un callback affichant une fenêtre Toast lors d'anomalies de détection plane.