Sammlung von Mega-Diagnosedaten

Dieser Leitfaden bietet standardisierte Anweisungen zum Sammeln von Daten über visueller Effekte Anomalien. Standardisierte Datenerfassung und Rückmeldung helfen Entwicklern, Probleme präzise zu beschreiben, und unterstützen das EasyAR-Technikteam dabei, technische Fehler im Zusammenhang mit visueller Lokalisierung effizient zu finden, zu reproduzieren und zu beheben.

Einführung

Bei der Integration des EasyAR Mega-Lokalisierungsdienst ist eine präzise Datenerfassung die zentrale Voraussetzung für die Problemdiagnose. Dieser Leitfaden behandelt die folgenden wichtigen Schritte:

• Problemerkennung: Klassifizierung und erste Bewertung häufiger Anomalien.
• Spezifikationen für Screenshots und Bildschirmaufnahmen: Methoden für visuelle Nachweise auf verschiedenen Geräteplattformen.
• Laufzeitdatenerfassung: Extraktion und Export von Laufzeitumgebungsdaten auf jeder Plattform.
• Standards für Rückmeldung information: Sicherstellen des "Mindestinformationssatz", das das Technikteam zur Reproduktion des Problems benötigt.

Anomalieklassifizierung und erste Einschätzung

Bevor Sie ein Problem melden, klären Sie die Anomalie anhand der folgenden Klassifizierung:

Häufige Anomaliesymptome

• Vollständig nicht lokalisierbar: Die Szene kann nicht erkannt werden, und der Status bleibt "NotFound".
• Abweichung der Lokalisierungsgenauigkeit: Lokalisierung ist erfolgreich, aber die Genauigkeit reicht nicht aus, mit deutlichem räumlicher Versatz.
• Unstable Lokalisierung: Das Bild Zittern oder Drift, oder Tracking geht häufig verloren.
• Regionale Anomalie: Lokalisierung funktioniert in bestimmten Bereichen oder an bestimmten Punkten schlecht.
• Unterschiede in der Gerätekompatibilität: Die Leistung ist auf bestimmten Gerätemodellen schlecht.

Mögliche Ursachenannahmen

• Szenenbezogen: Versatz bei Inhaltsplatzierung, schlechte Kartierungsqualität, spärliche Umgebungsbeleuchtung oder Merkmalspunkte (z. B. große weiße Wände) oder Störungen durch ähnliche Punkte.
• Technische Umgebung: Network Zittern, Dienstrückstände, QPS-Limitüberschreitung, Kompatibilität der SDK-Version oder Fehler in API-Aufruflogik.
• Hardwareberechtigungen: Gerätesensoren (IMU) unterstützen motion Tracking nicht, oder Kamera-/Speicher Berechtigungen sind nicht aktiviert.

Standardisierter Rückmeldeprozess

Um die Effizienz des Fehlerbehebung zu verbessern, empfehlen wir dringend, ein vollständigen Rückmeldepakets mit den folgenden drei Teilen einzureichen:

Checkliste Basisinformationen (Mindestinformationssatz)

• Ressourcenkennungen: Kontoinformationen, Mega AppId, Block Id.
• Versionsinformationen: EasyAR Sense SDK-Version oder Mini Program-Pluginversion.
• Problemdetails: Detaillierte Beschreibung der Anomalie und ihrer Auslösebedingungen.
• Umgebungsparameter: Gerätemodell, OS-Version, WeChat-Version und aktuelle network environment (4G/5G/WiFi).

Visuelle Nachweise (Videos und Screenshots)

• Bildschirmaufnahme des Reproduktionsprozesses: Zeichnen Sie den Lokalisierung Prozess vom Start bis zum Auftreten der Anomalie vollständig auf.
• Schlüsselframe Screenshots: Erfassen Sie Screenshots im Moment des Auftretens der Anomalie.
• Aufzeichnungen aus mehreren Winkeln: Stellen Sie visuelle Referenzen aus verschiedenen Positionen und unter unterschiedlichen Lichtbedingungen bereit.

Laufzeitdaten (zentrale Grundlage für Fehlerbehebung)

• EIF-Daten: Laufzeitaufzeichnungen auf Basis von EasyAR Sense, mit Unterstützung für Wiedergabe und Analyse auf dem PC.
• Dump-Daten: Snapshots des LaufzeitStatus speziell für WeChat Mini Program.
• Anwendungslogs: App-Laufzeitlogs (Logcat/Console) und Fehlerstacks.

Tipp

Weiterführende Lektüre: Wie man detaillierte Probleminformationen klar vermittelt

Kategorien für Laufzeitumgebung und Erfassungsmethoden

Datenerfassungsmethoden unterscheiden sich je nach running device und Plattform. Wählen Sie den passenden Leitfaden entsprechend Ihrer actual environment.

Gerätekategorien

• Mobilgeräte: Smartphones (iOS/Android).
• Headset-Geräte:
  • OST (Optical See-Through): Optical see-through, z. B. XREAL und Rokid.
  • VST (Video See-Through): Video see-through, z. B. Apple Vision Pro und PICO.

Leitfäden für Screenshot- und Bildschirmaufnahme

Plattformtyp	Referenzleitfaden
Telefon / WeChat Mini Program	Screenshot, screen Aufzeichnung und Export auf dem Telefon
OST headset	OST Aufzeichnung und Export
VST headset	VST Aufzeichnung und Export

Laufzeitdatenerfassung (EIF/Dump)

Szenariotyp	Erfassungslösung
EasyAR Sense native Anwendung	Telefon app EIF recording / Headset EIF recording
WeChat Mini Program	Mini Program Dump-Daten Aufzeichnung und Export
Schnellerfassungstools	Mega Toolbox EIF recording / Toolbox Dump recording

Automatische Erfassungsfunktion (demnächst)

Wir werden bald Unterstützung für automatische Erfassung und Rückmeldung bereitstellen und eine bequemere Möglichkeit zur Dateneinreichung anbieten:

• Hintergrundaufzeichnung: Starten der Hintergrundsammlung erforderlicher Datensätze nach Bedarf
• Automatisches Hochladen: Automatisches Packen und Hochladen der Daten an das EasyAR-Technikteam
• Erfassung bei Bedarf: Eigenständiges Echtzeit-Erfassen von abnormaler Zustände
• Progress Tracking: Klassifizierung und kontinuierliches Verfolgen des Fortschritt

Zusammenfassung der Bedienungsanleitung Navigation

Springen Sie entsprechend den Anforderungen Ihrer Geräteplattform direkt zum detailed Bedienungsanleitung:

Type	Bildschirmaufnahme and screenshot collection guide	Laufzeitdatenerfassung guide
Telefon application	Screenshot, screen Aufzeichnung und Export auf dem Telefon	Telefon app EIF recording, Mega Toolbox EIF recording, Anweisungen zum export von EIF-Daten
OST headset	OST Aufzeichnung und Export	Headset EIF Aufzeichnung und Export
VST headset	VST Aufzeichnung und Export	Headset EIF Aufzeichnung und Export
WeChat Mini Program	Screenshot, screen Aufzeichnung und Export auf dem Telefon	WeChat Mini Program Dump Aufzeichnung und Export, WeChat Mini Program Toolbox Dump recording

Empfehlungen für Best Practices

1. Vorbereitungsprozess: Vor dem Go-live des Projekts sollten Teammitglieder mit dem Datenerfassungsprozess vertraut sein.
2. Zuerst Selbstprüfung: Prüfen Sie vor dem Rückmeldung, ob Probleme der technischen Umgebung, Inhaltsplatzierung issues oder Geräteberechtigungsprobleme ausgeschlossen wurden.
3. Datenvollständigkeit: Sammeln Sie vollständige Daten standardisiert: Mindestinformationssatz für Rückmeldungen, Videos und Screenshots von visueller Anomalien sowie Laufzeitdaten.
4. Zeitnahe Kommunikation: Halten Sie nach dem Einreichen vollständiger Daten die Kommunikation mit dem EasyAR-Technikteam aufrecht.

Kanäle für technischen Support

• Hilfedokumentation: Lesen Sie Mega-Dokumentation oder Troubleshooting.
• Technischer Support: Jetzt kontaktieren oder senden Sie eine E-Mail an support@sightp.com.

Nächstes Thema: Methoden für screenshot, screen Aufzeichnung und Export auf dem Telefon