Problemas conocidos y limitaciones del complemento Mega para miniprogramas de WeChat

Este artículo presenta los problemas conocidos y limitaciones al utilizar el complemento Mega para miniprogramas.

Problemas conocidos de WeChat

Defectos confirmados actualmente en xr-frame o VisionKit de WeChat. Pueden causar fallos en la funcionalidad AR, por favor considere estos escenarios durante el desarrollo.

Detección anormal de planos en WeChat

En circunstancias específicas (como paredes blancas grandes en la imagen, cámara obstruida durante mucho tiempo), la detección de planos proporcionada por WeChat puede presentar estados anormales. En este estado, MegaTracker no funciona correctamente.

Consulte Manejo de errores del rastreador AR de plano para el tratamiento.

Tiempo de inicialización prolongado de la sesión

La sesión AR debe esperar a que WeChat complete la inicialización de la detección de planos antes de poder inicializarse. En algunos casos, la inicialización de la detección de planos de WeChat tarda más.

La razón por la que la sesión AR debe esperar a que el ARTracker de xr-frame se inicialice se explica en Cómo funciona MegaTracker en xr-frame.

Referencia de estado: Documentación de estado del rastreador AR para miniprogramas de WeChat.
Ejemplo de escucha:

<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 no se actualiza inmediatamente en el fotograma actual

En este ejemplo, trs.worldPosition no se actualiza a tiempo:

public onTick(delta, data) {
    const trs = this.el.getComponent(xrFrameSystem.Transform);
    // WorldPosition del nodo antes de actualizar
    console.log(`World Position before update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // LocalPosition del nodo antes de actualizar
    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 no se actualizó
    console.log(`World Position after update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // LocalPosition del nodo se actualizó
    console.log(`Local Position after update: ${trs.Position.x}, ${trs.Position.y}, ${trs.Position.z}`);
}

Se recomienda usar siempre LocalTransform durante el desarrollo, es decir, el.getComponent(xrFrameSystem.Transform).position y el.getComponent(xrFrameSystem.Transform).rotation.

Anomalía en el cambio de orientación de la pantalla

Si en la configuración global del miniprograma de WeChat app.json, dentro de window, se ingresa "auto".

Si el dispositivo sale del miniprograma en modo horizontal y luego vuelve a entrar en modo vertical, puede ocurrir un comportamiento anómalo en la escena AR.

Por lo tanto, nunca use "auto" en aplicaciones de miniprogramas AR.

Limitaciones de uso

Requisitos obligatorios para el funcionamiento. Si no se cumplen, la funcionalidad no estará disponible, pero puede evitarse ajustando la configuración o el entorno.

Limitaciones de modelos de dispositivos

Los dispositivos que ejecutan el complemento Mega para miniprogramas deben admitir al menos la Interfaz plana de WeChat VisionKit V1. Para obtener resultados óptimos, se recomienda usar dispositivos que admitan la Interfaz plana de WeChat VisionKit V2.

Lista de modelos compatibles: Consulte Lista de compatibilidad con la interfaz AR plana V2.
Método de verificación rápida:
1. Escanee el código QR de la muestra oficial del miniprograma de WeChat.
2. Después de ingresar al miniprograma, navegue a Interfaces > Capacidades visuales de VisionKit > AR de plano horizontal-v2 para verificar rápidamente si el dispositivo actual es compatible.

Si necesita usar servicios Mega en dispositivos no compatibles con VisionKit, consulte Mejores prácticas para escenarios de navegación para usar el Producto de navegación AR con visión+, compatible con casi todos los dispositivos.

Configuración forzada de PlaneMode

Debido a limitaciones en la compatibilidad de algunas interfaces de WeChat, planeMode debe establecerse en 1.

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

Limitaciones de la funcionalidad GPS

Actualmente no se admite alinear Block mediante GPS.

Actualmente no se admite colocar datos de anotación mediante GPS.

Table of Contents