Mega diagnostic data collection
This guide provides standardized instructions for collecting data about visual-effect anomalies. Standardized data collection and feedback help developers describe issues accurately and help the EasyAR technical team efficiently locate, reproduce, and resolve technical faults related to visual localization.
Introduction
When integrating the EasyAR Mega localization service, accurate data collection is the core prerequisite for issue diagnosis. This guide covers the following key steps:
- Issue identification: Classify and preliminarily assess common anomalies.
- Screenshot and screen recording specifications: Visual evidence methods for different device platforms.
- Runtime data collection: Extract and export runtime environment data on each platform.
- Feedback information standards: Ensure the "minimum information set" required for the technical team to reproduce the issue.
Anomaly classification and initial assessment
Before reporting an issue, use the following classification to clarify the anomaly:
Common anomaly symptoms
- Completely unable to localize: The scene cannot be recognized, and the status remains "NotFound".
- Localization accuracy deviation: Localization succeeds but accuracy is insufficient, with obvious spatial offset.
- Unstable localization: The image jitters or drifts, or tracking is frequently lost.
- Regional anomaly: Localization performs poorly in specific areas or at specific points.
- Device compatibility differences: Performance is poor on certain specific device models.
Possible cause assumptions
- Scene-related: Content placement offset, poor mapping quality, sparse environmental lighting or feature points (such as large white walls), or interference from similar points.
- Technical environment: Network jitter, service arrears, QPS limit exceeded, SDK version compatibility, or API call logic errors.
- Hardware permissions: Device sensors (IMU) do not support motion tracking, or camera/storage permissions are not enabled.
Standardized feedback process
To improve troubleshooting efficiency, we strongly recommend that you submit a complete feedback package containing the following three parts:
Basic information checklist (minimum information set)
- Resource identifiers: Account information, Mega AppId, Block Id.
- Version information: EasyAR Sense SDK version or Mini Program plugin version.
- Issue details: Detailed description of the anomaly and its trigger conditions.
- Environment parameters: Device model, OS version, WeChat version, and current network environment (4G/5G/WiFi).
Visual evidence (videos and screenshots)
- Screen recording of the reproduction process: Completely record the localization process from startup to anomaly occurrence.
- Key-frame screenshots: Capture screenshots at the moment the anomaly occurs.
- Multi-angle records: Provide visual references from different positions and under different lighting conditions.
Runtime data (core troubleshooting basis)
- EIF data: Runtime records based on EasyAR Sense, supporting playback and analysis on PC.
- Dump data: Runtime state snapshots specific to WeChat Mini Program.
- Application logs: App runtime logs (Logcat/Console) and error stacks.
Tip
Further reading: How to clearly communicate detailed issue information
Runtime environment and collection method categories
Data collection methods vary by running device and platform. Choose the corresponding guide according to your actual environment.
Device categories
- Mobile devices: Smartphones (iOS/Android).
- Headset devices:
- OST (Optical See-Through): Optical see-through, such as XREAL and Rokid.
- VST (Video See-Through): Video see-through, such as Apple Vision Pro and PICO.
Screenshot and screen recording guides
| Platform type | Reference guide |
|---|---|
| Phone / WeChat Mini Program | Phone screenshot, screen recording, and export |
| OST headset | OST recording and export |
| VST headset | VST recording and export |
Runtime data collection (EIF/Dump)
| Scenario type | Collection solution |
|---|---|
| EasyAR Sense native application | Phone app EIF recording / Headset EIF recording |
| WeChat Mini Program | Mini Program Dump data recording and export |
| Quick collection tools | Mega Toolbox EIF recording / Toolbox Dump recording |
Automatic collection feature (coming soon)
We will soon upgrade support for automatic collection and feedback, providing a more convenient way to submit data:
- Background recording: Start background collection of required datasets on demand
- Automatic upload: Automatically package and upload data to the EasyAR technical team
- On-demand capture: Capture abnormal states in real time by yourself
- Progress tracking: Classify and continuously track progress
Operation guide navigation summary
Jump directly to the detailed operation guide according to your device platform requirements:
| Type | Screen recording and screenshot collection guide | Runtime data collection guide |
|---|---|---|
| Phone application | Phone screenshot, screen recording, and export | Phone app EIF recording, Mega Toolbox EIF recording, EIF data export instructions |
| OST headset | OST recording and export | Headset EIF recording and export |
| VST headset | VST recording and export | Headset EIF recording and export |
| WeChat Mini Program | Phone screenshot, screen recording, and export | WeChat Mini Program Dump recording and export, WeChat Mini Program Toolbox Dump recording |
Best practice recommendations
- Pre-research process: Before the project goes live, it is recommended that team members become familiar with the data collection process.
- Self-check first: Before reporting, confirm whether technical environment issues, content placement issues, or device permission issues have been ruled out.
- Data completeness: Collect complete data in a standardized way: the minimum feedback information set, videos and screenshots of visual anomalies, and runtime data.
- Timely communication: After submitting complete data, keep communicating with the EasyAR technical team.
Technical support channels
- Help documentation: See Mega documentation or Troubleshooting.
- Technical support: Contact us now or send an email to support@sightp.com.
Next topic: Phone screenshot, screen recording, and export methods