Problemi noti e limitazioni del plugin Mega per WeChat Mini Program

Questo articolo descrive i problemi noti e le limitazioni del plugin Mega Mini Program durante l'uso.

Problemi noti di WeChat

Difetti attualmente confermati in WeChat xr-frame o VisionKit. Quando si verificano, la funzionalità AR non funziona. Prestare attenzione agli scenari di attivazione correlati durante lo sviluppo.

Eccezione di rilevamento piano WeChat

In casi specifici, ad esempio quando nell'immagine compare una grande parete bianca o la camera rimane coperta a lungo, il rilevamento del piano fornito da WeChat può entrare in uno stato anomalo. In questo stato, MegaTracker non può funzionare normalmente.

Per il metodo di gestione, vedere Gestione eccezione Plane AR tracker.

Tempo di inizializzazione di Session lungo

AR Session può completare l'inizializzazione solo dopo il completamento dell'inizializzazione del rilevamento piano WeChat. In alcuni casi, l'inizializzazione del rilevamento piano WeChat richiede molto tempo.

Per il motivo per cui AR Session deve attendere il completamento dell'inizializzazione di xr-frame ARTracker, vedere Come MegaTracker funziona su xr-frame.

Riferimento stato: Documentazione stato AR tracker di WeChat Mini Program.
Esempio di listening:

<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.');
    }
}

worldPosition del nodo non viene aggiornato immediatamente nel frame corrente

In questo esempio, trs.worldPosition non viene aggiornato in tempo:

public onTick(delta, data) {
    const trs = this.el.getComponent(xrFrameSystem.Transform);
    // WorldPosition di questo nodo prima dell aggiornamento
    console.log(`World Position before update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // LocalPosition di questo 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 di questo nodo non e stato aggiornato
    console.log(`World Position after update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // LocalPosition di questo nodo e stato aggiornato
    console.log(`Local Position after update: ${trs.Position.x}, ${trs.Position.y}, ${trs.Position.z}`);
}

Durante lo sviluppo, si consiglia di usare sempre LocalTransform, cioè el.getComponent(xrFrameSystem.Transform).position e el.getComponent(xrFrameSystem.Transform).rotation.

Eccezione nel cambio di orientamento schermo

Se "auto" viene impostato in window nella configurazione globale app.json di WeChat Mini Program,

dopo che il device esce dal Mini Program in modalità landscape e rientra in modalità portrait, la vista AR può diventare anomala.

Pertanto, non usare mai "auto" nelle applicazioni AR Mini Program.

Limitazioni d'uso

Requisiti obbligatori per il funzionamento della funzione. Se non sono soddisfatti, la funzione non è disponibile, ma è possibile evitarlo regolando configurazione o ambiente.

Limitazioni dei device

I device che eseguono il plugin Mega Mini Program devono supportare almeno la WeChat VisionKit V1 plane interface. Per ottenere risultati ideali, si consiglia di usare device che supportano la WeChat VisionKit V2 plane interface.

Elenco dei device supportati: vedere lista di supporto V2 plane AR interface.
Metodo di verifica rapida:
1. Scansionare il QR code ufficiale Sample di WeChat Mini Program.
2. Dopo essere entrati nel Mini Program, navigare a Interface > VisionKit visual capability > Horizontal plane AR-v2 per determinare rapidamente se il device corrente è supportato.

Se è necessario usare i servizi Mega su device che non supportano VisionKit, vedere best practice per scenari di navigazione e usare EasyAR Sense AR navigation product, che supporta quasi tutti i device.

Configurazione obbligatoria di PlaneMode

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

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

Limitazioni della funzione GPS

L'allineamento di Block tramite GPS non è ancora supportato.

Il posizionamento dei dati di annotazione tramite GPS non è ancora supportato.

Table of Contents