Gestione delle eccezioni del tracciatore AR piano

Questo articolo spiega come gestire le eccezioni del tracciatore AR piano di Weixin registrando callback.

Prima di iniziare

• Comprendi attraverso il flusso di lavoro MegaTracker:

  • Il tracciatore AR piano di xr-frame è essenzialmente un wrapper per la capacità 6DoF-piano di VisionKit.
  • Come funziona MegaTracker su xr-frame.

• Comprendi concetto e flusso della sessione AR

Perché si verificano eccezioni nel rilevamento dei piani

In condizioni specifiche (come grandi pareti bianche nell'inquadratura, fotocamera coperta a lungo, ecc.), il tracciatore AR piano di Weixin potrebbe funzionare in modo anomalo.

In questo caso, il tracciatore AR piano non può fornire correttamente la posa della fotocamera per ogni fotogramma (ovvero i dati 6DoF), causando l'arresto di MegaTracker.

Quando l'immagine torna normale (trama ricca, fotocamera scoperta) per un certo periodo, il tracciatore AR piano riprende a funzionare e anche MegaTracker si riattiva.

Configurare il comportamento in caso di errori di rilevamento piano

Registra una callback di gestione eccezioni tramite setPlaneDetectionErrorBehavior(behavior). Quando viene rilevata un'anomalia, questa callback viene attivata, consentendo agli sviluppatori di implementare avvisi personalizzati, nascondere contenuti 3D o altre logiche di gestione.

session.setPlaneDetectionErrorBehavior(() => {
    wx.showToast({
        icon: 'none',
        title: `Risultato anomalo del rilevamento piano di Weixin. Muovi la fotocamera sul piano per ripristinare il tracking`,
        duration: 2000,
    });
});

Questo esempio utilizza l'interfaccia setPlaneDetectionErrorBehavior(behavior) della sessione per registrare una callback che visualizza un Toast quando viene rilevata un'anomalia nel rilevamento del piano.