Table of Contents

Mega diagnostische datenerfassung

Dieser Leitfaden bietet standardisierte Anleitungen zur Sammlung von Daten bei visuellen Anomalien. Durch standardisierte Datenerfassung und Rückmeldungen sollen Entwickler Probleme präzise beschreiben und das EasyAR-Technologie-Team bei der effizienten Identifizierung, Reproduktion und Lösung von technischen Störungen im Zusammenhang mit der visuellen Positionierung unterstützen.

Inhaltsübersicht

Bei der Integration des EasyAR Mega-Positionierungsdienstes ist die genaue Datenerfassung die Kernvoraussetzung für die Problemdiagnose. Dieser Leitfaden deckt folgende Schlüsselbereiche ab:

  • Problemidentifikation: Klassifizierung und erste Bewertung häufiger Anomalien.
  • Bildschirmfoto- und Bildschirmaufnahmestandards: Visuelle Erfassungsmethoden für verschiedene Geräteplattformen.
  • Laufzeitdatenerfassung: Extraktion und Export von Laufzeitumgebungsdaten auf verschiedenen Plattformen.
  • Informationsrückmeldestandards: "Minimaler Informationssatz", der benötigt wird, damit das Technikteam Probleme reproduzieren kann.

Anomalieklassifizierung und ersteinschätzung

Identifizieren Sie vor der Problemrückmeldung die Anomalie anhand folgender Kategorien:

Häufige anormale erscheinungen

  • Völlig fehlgeschlagene positionierung: Szenenerkennung unmöglich, Status dauerhaft "NotFound".
  • Positionierungsgenauigkeitsabweichung: Positionierung erfolgreich, aber ungenau, mit deutlicher räumlicher Verschiebung.
  • Instabile positionierung: Bildwackeln, Driften oder häufiger Trackingverlust.
  • Regionale anomalien: Schlechte Positionierungsleistung in bestimmten Bereichen oder an bestimmten Punkten.
  • Gerätekompatibilitätsunterschiede: Schlechtere Leistung auf bestimmten Gerätemodellen.

Mögliche ursachen

  • Szenenbezogen: Versetzte Inhaltsplatzierung, geringe Kartierungsqualität, schlechte Umgebungsbeleuchtung oder spärliche Merkmalspunkte (z.B. große weiße Wände), Störungen durch ähnliche Punkte.
  • Technische umgebung: Netzwerkstörungen, unbezahlte Dienste, QPS-Limitüberschreitung, SDK-Versionskompatibilität, API-Aufruflogikfehler.
  • Hardwareberechtigungen: Gerätesensoren (IMU) unterstützen keine Bewegungserfassung, Kameraberechtigungen oder Speicherberechtigungen nicht aktiviert.

Standardisiertes rückmeldeverfahren

Um die Fehlerbehebungseffizienz zu erhöhen, empfehlen wir dringend, ein vollständiges Feedback-Paket mit folgenden drei Teilen einzureichen:

Grundinformationsliste (minimaler informationssatz)

  • Ressourcenkennung: Kontoinformationen, Mega AppId, Block Id.
  • Versionsinformationen: EasyAR Sense SDK-Version oder Mini-Programm-Plugin-Version.
  • Problemdetaillierung: Detaillierte Beschreibung der Anomalie und ihrer Auslösebedingungen.
  • Umgebungsparameter: Gerätemodell, Betriebssystemversion, WeChat-Version, aktuelles Netzwerkumfeld (4G/5G/WiFi).

Visuelle beweise (video und bildschirmfotos)

  • Reproduktionsprozessaufzeichnung: Vollständige Aufnahme des Positionierungsprozesses vom Start bis zum Auftreten der Anomalie.
  • Schlüsselbild-screenshots: Schnappschüsse des Bildschirms im Moment des Auftretens der Anomalie.
  • Mehrwinkelaufzeichnungen: Visuelle Referenzen aus verschiedenen Positionen und unter verschiedenen Lichtbedingungen.

Laufzeitdaten (kernbasis für die fehlersuche)

  • EIF-Daten: Auf EasyAR Sense basierende Laufzeitaufzeichnung, unterstützt die Wiedergabeanalyse auf dem PC.
  • Dump-Daten: Laufzeitzustandsschnappschuss spezifisch für WeChat Mini-Programme.
  • Anwendungsprotokolle: App-Laufzeitprotokolle (Logcat/Console) und Fehlerstapel.
Tipp

Weiterführende Lektüre: Wie man Probleme klar kommuniziert

Laufzeitumgebung und sammelmethodenklassifizierung

Die Datenerfassungsmethode variiert je nach Betriebsgerät und Plattform. Wählen Sie die entsprechende Anleitung basierend auf Ihrer tatsächlichen Umgebung.

Geräteklassifizierungserläuterung

  • Mobile geräte: Smartphones (iOS/Android).
  • Head-mounted displays (HMDs):
    • OST (Optisches Durchsichtdisplay): Optical See-Through (z.B. XREAL, Rokid).
    • VST (Videodurchsichtdisplay): Video See-Through (z.B. Apple Vision Pro, PICO)

Bildschirmfoto- und aufnahmeanleitung

Plattformtyp Referenzanleitung
Smartphone / WeChat Mini-Programm Smartphone-Bildschirmfotos, -aufnahmen und Export
OST HMD OST-Aufnahme und Export
VST HMD VST-Aufnahme und Export

Laufzeitdatenerfassung (EIF/Dump)

Szenariotyp Erfassungslösung
Native EasyAR Sense-Anwendung Smartphone-App EIF-Aufnahme / HMD EIF-Aufnahme
WeChat Mini-Programm Mini-Programm Dump-Datenerfassung und Export
Schnellerfassungstool Mega Toolbox EIF-Aufnahme / Toolbox Dump-Aufnahme

Automatische erfassungsfunktion (in kürze verfügbar)

Wir werden bald die Unterstützung für automatische Erfassung und Rückmeldung aktualisieren, um eine bequemere Dateneinreichung zu ermöglichen:

  • Hintergrundaufzeichnung: Bedarfsgesteuerter Start der Hintergrunddatenerfassung.
  • Automatischer upload: Automatisches Packen und Hochladen an das EasyAR-Technologie-Team.
  • Bedarfsgesteuerte erfassung: Selbstbedienung in Echtzeit zum Erfassen anormaler Zustände.
  • Fortschrittsverfolgung: Kategorisierung und kontinuierliche Verfolgung.

Springen Sie basierend auf Ihren Geräteplattformanforderungen direkt zur detaillierten Bedienungsanleitung:

Typ Anleitung zur Bildschirmfoto-/Aufnahmeerfassung Anleitung zur Laufzeitdatenerfassung
Smartphone-App Smartphone-Bildschirmfotos, -aufnahmen und Export Smartphone-App EIF-Aufnahme, Mega Toolbox EIF-Aufnahme, EIF-Datenexportanleitung
OST HMD OST-Aufnahme und Export HMD EIF-Aufnahme und Export
VST HMD VST-Aufnahme und Export HMD EIF-Aufnahme und Export
WeChat Mini-Programm Smartphone-Bildschirmfotos, -aufnahmen und Export WeChat Mini-Programm Dump-Aufnahme und Export, WeChat Mini-Programm Toolbox Dump-Aufnahme

Best-practice-empfehlungen

  1. Vorabprüfprozess: Vor dem Projekt-Go-Live sollten Teammitglieder mit dem Datenerfassungsprozess vertraut sein.
  2. Vorabselbstprüfung: Vor der Rückmeldung prüfen, ob technische Umgebungsprobleme, Inhaltsplatzierungsprobleme oder Geräteberechtigungsprobleme ausgeschlossen wurden.
  3. Datenganzheitlichkeit: Normgerechte Erfassung vollständiger Daten: Rückmeldung des minimalen Informationssatzes, visuelle Anomalievideos und Screenshots, Laufzeitdaten.
  4. Zeitnahe kommunikation: Halten Sie nach Einreichung vollständiger Daten die Kommunikation mit dem EasyAR-Technologie-Team aufrecht.

Technischer unterstützungskanal

Nächstes thema: Methode für Smartphone-Bildschirmfotos, -aufnahmen und Export