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

Mega-Diagnosemodus

Der Mega-Diagnosemodus eignet sich für bereits veröffentlichte Apps oder WeChat Mini Programs, wenn keine Anwendungsentwickler an der Problemanalyse teilnehmen können. Die Anwendung muss ein SDK oder Mini-Program-Plugin integriert haben, das diese Funktion unterstützt.

Nachdem der Diagnosemodus für die Ziel-cloud localization library aktiviert und ein Gerät gebunden wurde, starten Sie die App oder das Mini Program neu, damit runtime data automatisch aufgezeichnet werden. Wenn während der normalen Nutzung ein Problem auftritt, speichern und laden Sie die Aufzeichnungen möglichst schnell über das Mega diagnostic tool hoch, damit der technische Support von EasyAR sie analysieren kann. Den vollständigen Ablauf finden Sie unter Mega-Diagnosemodus.

Wenn Anwendungsentwickler verfügbar sind, sollten EIF- oder dump-Daten gemäß den obigen Anleitungen zur runtime data collection bevorzugt aufgezeichnet werden.

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