Problemi noti e limitazioni del plug-in Mega per mini-program WeChat

Questo articolo presenta i problemi noti e le limitazioni durante l'utilizzo del plug-in Mega per mini-program WeChat.

Problemi noti di WeChat

Difetti attualmente confermati in xr-frame o VisionKit di WeChat. Possono causare malfunzionamenti delle funzionalità AR: prestare attenzione agli scenari che li attivano durante lo sviluppo.

Anomalie nel rilevamento del piano di WeChat

In circostanze specifiche (come grandi pareti bianche nell'inquadratura, fotocamera oscurata a lungo, ecc.), il rilevamento del piano fornito da WeChat potrebbe diventare anomalo. In questo stato, MegaTracker non funziona correttamente.

Fare riferimento a Gestione delle anomalie del tracker AR per piani per le procedure di gestione.

Inizializzazione della sessione richiede più tempo

La sessione AR deve attendere il completamento dell'inizializzazione del rilevamento del piano di WeChat. In alcuni casi, questa inizializzazione richiede più tempo.

Il motivo per cui la sessione AR attende il completamento dell'inizializzazione di ARTracker di xr-frame è spiegato in Come funziona MegaTracker su xr-frame.

Riferimento sullo stato: Documentazione sullo stato del tracker AR per mini-program WeChat.
Esempio di ascolto:

<xr-ar-tracker id="xrARTracker" mode="Plane" bind:ar-tracker-state="handleARTrackerState"></xr-ar-tracker>

handleARTrackerState({detail}) {
    if (detail.value.state == xrFrameSystem.EARTrackerState.Detected) {
        console.log('Plane is now detected by XR-Frame ARTracker.');
    }
}

La worldPosition del nodo non viene aggiornata immediatamente nel frame corrente

In questo esempio, trs.worldPosition non viene aggiornato tempestivamente:

public onTick(delta, data) {
    const trs = this.el.getComponent(xrFrameSystem.Transform);
    // WorldPosition del nodo prima dell'aggiornamento
    console.log(`World Position before update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // LocalPosition del nodo prima dell'aggiornamento
    console.log(`Local Position before update: ${trs.Position.x}, ${trs.Position.y}, ${trs.Position.z}`);
    trs.position.x += 0.1;
    trs.position.y += 0.1;
    trs.position.z += 0.1;
    // WorldPosition del nodo non aggiornata
    console.log(`World Position after update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // LocalPosition del nodo aggiornata
    console.log(`Local Position after update: ${trs.Position.x}, ${trs.Position.y}, ${trs.Position.z}`);
}

Durante lo sviluppo, si consiglia di utilizzare sempre LocalTransform, ovvero el.getComponent(xrFrameSystem.Transform).position e el.getComponent(xrFrameSystem.Transform).rotation.

Anomalie nel cambio di orientamento dello schermo

Se in app.json (configurazione globale del mini-program WeChat) la sezione window contiene "auto":

Quando il dispositivo esce dal mini-program in modalità orizzontale e vi rientra in modalità verticale, potrebbe verificarsi un'anomalia nella visualizzazione AR.

Pertanto, non utilizzare mai "auto" nelle applicazioni AR per mini-program.

Limitazioni d'uso

Requisiti tecnici per il funzionamento. Se non soddisfatti, le funzionalità non sono disponibili, ma possono essere evitate modificando configurazione o ambiente.

Limitazioni dei dispositivi

I dispositivi che eseguono il plug-in Mega per mini-program devono supportare almeno l'interfaccia per piani di VisionKit V1 di WeChat. Per risultati ottimali, si consigliano dispositivi che supportano l'interfaccia per piani di VisionKit V2 di WeChat.

Elenco dispositivi supportati: fare riferimento a Elenco supporto interfaccia AR per piani V2.
Metodo rapido di verifica:
1. Scansionare il codice QR dello Sample ufficiale di WeChat.
2. Nel mini-program, navigare in Interfacce > Capacità visive di VisionKit > AR per piani orizzontali-v2 per verificare rapidamente il supporto del dispositivo corrente.

Per utilizzare il servizio Mega su dispositivi non supportati da VisionKit, fare riferimento alle Migliori pratiche per scenari di navigazione per utilizzare il prodotto di navigazione AR Vis+, compatibile con quasi tutti i dispositivi.

Configurazione obbligatoria di PlaneMode

A causa di limitazioni nel supporto di alcune interfacce WeChat, planeMode deve essere impostato su 1.

<xr-scene ar-system="modes:Plane; planeMode: 1" bind:ready="handleReady">

Limitazioni delle funzionalità GPS

Non è ancora supportato l'allineamento dei Block tramite GPS.

Non è ancora supportato il posizionamento di dati annotati tramite GPS.

Table of Contents