Bekannte probleme und einschränkungen des WeChat Mini Program Mega-Plugins

Dieser Artikel beschreibt bekannte Probleme und Einschränkungen bei der Verwendung des Mega-Plugins für Mini-Programme.

Bekannte WeChat-Probleme

Aktuell bestätigte Mängel im WeChat xr-frame oder VisionKit. Diese können zur Deaktivierung der AR-Funktionalität führen. Entwickler sollten auf potenzielle Auslöseszenarien achten.

Anormale ebenenerkennung in WeChat

Unter bestimmten Umständen (z.B. große weiße Wandflächen im Bild, längere Kamerablockade) kann die von WeChat bereitgestellte Ebenenerkennung in einen anormalen Zustand geraten. In diesem Zustand funktioniert der MegaTracker nicht.

Behandlungsmethoden finden Sie unter Anormale behandlung des ebenen AR-Trackers.

Lange initialisierungszeit der session

Die AR-Session muss warten, bis die Initialisierung der WeChat-Ebenenerkennung abgeschlossen ist. In manchen Fällen dauert dieser Initialisierungsprozess unerwartet lange.

Der Grund, warum die AR-Session auf die Initialisierung des xr-frame ARTrackers warten muss, wird unter Wie der MegaTracker im xr-frame arbeitet erläutert.

Statusreferenz: Dokumentation zum Status des WeChat Mini Program AR-Trackers.
Überwachungsbeispiel:

<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 von knoten wird nicht sofort im aktuellen frame aktualisiert

In diesem Beispiel wird trs.worldPosition nicht rechtzeitig aktualisiert:

public onTick(delta, data) {
    const trs = this.el.getComponent(xrFrameSystem.Transform);
    // WorldPosition des Knotens vor der Aktualisierung
    console.log(`World Position before update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // LocalPosition des Knotens vor der Aktualisierung
    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 des Knotens wurde nicht aktualisiert
    console.log(`World Position after update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // LocalPosition des Knotens wurde aktualisiert
    console.log(`Local Position after update: ${trs.Position.x}, ${trs.Position.y}, ${trs.Position.z}`);
}

Es wird empfohlen, während der Entwicklung stets die LocalTransform zu verwenden, also el.getComponent(xrFrameSystem.Transform).position und el.getComponent(xrFrameSystem.Transform).rotation.

Anormale bildschirmausrichtungsänderung

Wenn in der globalen Konfiguration app.json von WeChat Mini Programs unter window der Wert "auto" eingetragen ist:

Wenn das Gerät im Querformat das Mini-Programm verlässt und dann im Hochformat erneut betritt, kann es zu anormalen AR-Bilddarstellungen kommen.

Daher sollte nie "auto" in AR-Mini-Programmen verwendet werden.

Nutzungseinschränkungen

Harte Voraussetzungen für den Funktionsbetrieb. Wenn nicht erfüllt, ist die Funktion nicht verfügbar, kann aber durch Anpassung der Konfiguration oder der Umgebung vermieden werden.

Geräteeinschränkungen

Geräte, die das Mega-Plugin für Mini-Programme ausführen, müssen mindestens die WeChat VisionKit V1-Ebenenschnittstelle unterstützen. Für optimale Ergebnisse wird ein Gerät mit Unterstützung für die WeChat VisionKit V2-Ebenenschnittstelle empfohlen.

Liste unterstützter Geräte: Siehe Liste der unterstützten Geräte für die V2-Ebenen-AR-Schnittstelle.
Schnellüberprüfung:
1. Scannen Sie den offiziellen Beispiel-QR-Code des WeChat Mini Programs.
2. Navigieren Sie im Mini-Programm zu Schnittstelle > VisionKit-Visualisierungsfunktionen > Horizontale Ebene AR-v2, um schnell zu prüfen, ob das aktuelle Gerät unterstützt wird.

Falls Mega-Dienste auf nicht VisionKit-fähigen Geräten genutzt werden sollen, konsultieren Sie Bewährte praxis für navigationsszenarien zur Nutzung des SightPlus AR-Navigationsprodukts, das fast alle Geräte unterstützt.

Erzwungene planemode-konfiguration

Aufgrund von Einschränkungen bestimmter WeChat-Schnittstellen muss planeMode auf 1 gesetzt werden.

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

Gps-funktionseinschränkungen

Eine Ausrichtung von Blocks über GPS wird derzeit nicht unterstützt.

Das Platzieren von Anmerkungsdaten über GPS wird derzeit nicht unterstützt.

Table of Contents