Table of Contents

Mega häufig gestellte fragen

Probleme während der Entwicklung sind unvermeidlich. Dieser Leitfaden soll Ihnen helfen, häufige Probleme schnell zu identifizieren und zu lösen. Wir beginnen mit einer Liste häufig gestellter Fragen (FAQ). Sollten Sie hier keine Antwort finden, lesen Sie bitte die folgenden Abschnitte oder reichen Sie einen Problembericht bei uns ein.

Häufig gestellte fragen (FAQ)

Hier sind einige der häufigsten Probleme, auf die Entwickler bei der Integration und Nutzung von EasyAR Mega stoßen, sowie deren Lösungen.

F: Warum zeigt meine App "Invalid Key" an?

A: Dies wird normalerweise durch folgende Gründe verursacht:

  1. Lizenz ungültig oder abgelaufen
  2. Lizenz stimmt nicht mit Bundle ID/Package Name überein
  3. Headset-Geräte benötigen eine separate XR-Lizenz
  4. Benutzerdefinierte Kamerafunktionen erfordern eine Vollversion-Lizenz
F: Warum hat meine App einen Wasserzeichen?

A: Dies zeigt an, dass Sie eine Testversion-Lizenz und nicht die Vollversion verwenden.

F: Warum zeigt meine App einen Countdown-Hinweis (timeout within * seconds) an?

A: Dies ist eine Einschränkung während der Testproduktphase. Die Verwendung einer Vollversion-Lizenz für EasyAR Sense und des EasyAR Mega-Service in der Vollversion löst dieses Problem.

F: Warum öffnet sich meine App mit einem schwarzen Bildschirm?

A: In diesem Fall wird normalerweise die Fehlerursache in den Bildschirminformationen oder Protokollen ausgegeben. Sie können die Lösung basierend auf der spezifischen, vom System ausgegebenen Ursache vornehmen. Wenn Sie das Problem nicht lösen können, melden Sie bitte technische Informationen (einschließlich Protokolle, Screenshots, detaillierte Geräteinformationen usw.).

F: Warum kann sich meine App nicht lokalisieren und der Rückgabestatus bleibt "NotFound"?

A: Dies wird normalerweise durch folgende Gründe verursacht:

  1. Lokalisierungsdienst startet noch:
    Zu diesem Zeitpunkt hat der Lokalisierungsdienst noch nicht alle Mega-Karten vollständig geladen, daher kann eine erfolgreiche Lokalisierung in einem bestimmten Gebiet nicht garantiert werden.
  2. Außerhalb des Kartenabdeckungsbereichs:
    Stellen Sie sicher, dass sich Ihr aktueller physischer Standort innerhalb des Abdeckungsgebiets der von Ihnen geladenen Mega-Karte befindet.
  3. Fehlerhafte Konfiguration für Simulationstests:
    Sie sind nicht vor Ort, aber MegaLocationInputMode wurde fälschlicherweise auf Onsite gesetzt.
  4. Ungünstige Umgebungsbedingungen:
    Extreme Lichtverhältnisse (zu dunkel oder zu hell), großflächige einfarbige Wände oder Böden (z. B. weiße Wände, polierte Böden) beeinträchtigen die visuelle Lokalisierung.
F: Warum kann sich meine App nicht lokalisieren und der Rückgabestatus ist abnormal?

A: Dies wird normalerweise durch folgende Gründe verursacht:

  1. Anfragezeitüberschreitung:
    Das System gibt dann RequestTimeout zurück.
  2. Anfrageintervall zu kurz:
    Das System gibt dann RequestIntervalTooLow zurück.
  3. Andere unerwartete Fehler:
    Das System gibt dann UnknownError zurück. Solche Fehler entsprechen im Allgemeinen einem Fehler während des Verbindungsaufbaus oder der Übertragung oder deuten auf einen Fehler im Mega-Service selbst hin. Weitere Details können über die Schnittstelle MegaBlockLocalizationResponse.ErrorMessage abgerufen werden.
F: Warum ist meine Anfrage zur Nutzung des Mini-Programm-Plugins fehlgeschlagen?

A: Dies liegt daran, dass Mini-Programm-Plugins nicht im "Gastmodus" des WeChat-Entwicklertools verwendet werden können und auch nicht für Mini-Programme mit einer Einzelperson als Betreiber unterstützt werden. Bitte verwenden Sie die AppId eines WeChat-Mini-Programms mit einem Unternehmen als Betreiber für die Anfrage.

F: Warum wurde meine Mini-Programm-Autorisierung nicht genehmigt?

A: Sie müssen die Mega Mini-Programm-Plugin-Lizenz aus dem Entwicklungscenter beziehen und sicherstellen, dass Sie die gleiche AppId verwenden, die in der Lizenz angegeben ist.

F: Warum funktioniert mein Mini-Programm auf XX-Handys nicht?

A: Die Integration der Mega-Abhängigkeit in Mini-Programme nutzt die VisionKit-Komponente von WeChat. Die Systemanforderungen und die Liste der unterstützten Geräte finden Sie in der WeChat-Dokumentation.

F: Die Lokalisierung war erfolgreich, aber die Position des virtuellen Inhalts scheint ungenau oder driftet?

A: Probleme mit der Lokalisierungsqualität haben oft komplexe Ursachen. Mögliche Gründe sind:

  1. Probleme mit der Kartengenauigkeit:
    Die Mega-Karte für diesen Bereich selbst könnte Genauigkeitsfehler aufweisen. Dies tritt normalerweise während der Kartenerfassung oder Rekonstruktionsphase auf. Bitte wenden Sie sich an den Vertrieb, um dies zu bestätigen.
  2. Sprung bei der Initialisierung:
    In den ersten Sekunden der Lokalisierung kann es zu leichten Sprüngen in der Position kommen. Dies wird durch das SLAM-System des Geräts verursacht, das die Initialisierung noch nicht abgeschlossen hat. Dieser Prozess ist in WeChat Mini-Programmen besonders ausgeprägt (bei einigen Geräten kann er sogar recht lange dauern).
  3. Dynamische Umgebungsänderungen:
    Wenn sich die physische Umgebung signifikant verändert hat (z. B. durch das Verschieben großer Einrichtungen, das Hinzufügen temporärer Ausstellungswände), kann dies zu einer Nichtübereinstimmung zwischen Karte und Realität führen. In diesem Fall muss die Karte aktualisiert werden.
  4. Systematische Gerätefehler:
    Bei den meisten Geräten Geräten führt der kumulierte Fehler des SLAM-Systems nach längerem Dauerbetrieb zu Drift.
  5. Lokalisierungsfehler:
    Die visuelle Lokalisierung selbst hat eine Genauigkeitstoleranz. Normalerweise beeinträchtigt dieser Fehler nicht das visuelle Erlebnis des virtuellen Inhalts. Wenn der Fehler so groß ist, dass eine deutliche Abweichung oder Drift sichtbar ist, sind detaillierte Daten für Analyse und Lösung erforderlich. Befolgen Sie die Methoden im Kapitel Problemdiagnose und -berichterstattung, um Daten zu sammeln und Feedback zu geben.
F: Wie sammle und verwende ich EIF-Daten für Debugging-Zwecke?

A: EIF-Daten sind ein leistungsstarkes Debugging-Tool. Bitte lesen Sie die folgenden Kapitel:

  • Wie sammle ich: Lesen Sie Aufnahme von Simulationsdaten, um zu erfahren, wie Sie EIF-Dateien auf dem Handy oder Headset aufzeichnen.
  • Wie spiele ich sie ab: Je nach Ihrer Entwicklungsumgebung (Unity oder WeChat Mini-Programm) folgen Sie der entsprechenden Wiedergabeanleitung in diesem Kapitel.

Spezifischere hilfe finden

Wenn die oben genannten FAQ Ihr Problem nicht lösen konnten, besuchen Sie die folgenden themenspezifischen Seiten für tiefergehende Lösungen:

Ein neues problem melden

Wenn Sie auf ein Problem stoßen, das oben nicht abgedeckt ist und möglicherweise auf das SDK oder die Plattform selbst zurückzuführen ist, helfen Sie uns, das Produkt zu verbessern. Detaillierte Schritte oder Anleitungen finden Sie unter: Problembericht.

Stellen Sie vor der Einreichung sicher, dass Sie folgende Informationen bereit haben. Dies hilft uns enorm, das Problem zu lösen:

  1. Problembeschreibung: Beschreiben Sie klar die Symptome, die Häufigkeit des Auftretens und die Schritte zur Reproduktion des Problems.
  2. Geräteinformationen: Gerätemodell, Betriebssystemversion, EasyAR SDK-Version.
  3. EIF-daten: Bitte stellen Sie unbedingt die EIF-Aufnahmedatei bereit, mit der sich das Problem reproduzieren lässt. Dies ist die wichtigste Diagnosegrundlage.
  4. Protokolldatei: Vollständige Anwendungsprotokolle (Logcat- oder Konsolenausgabe).
  5. Bildschirmaufnahme oder screenshot: Eine Bildschirmaufnahme oder Screenshots zum Zeitpunkt des Problems.

Bitte übermitteln Sie die oben genannten Informationen über unser Forum, E-Mail oder Ihren Geschäftskontakt. Vielen Dank für Ihr Feedback!