How to clearly communicate visual anomaly issues
This section explains how to clearly communicate visual anomaly issues to provide an effective basis for problem identification.
Specify device information
The core purpose of providing device information is to troubleshoot hardware compatibility issues.
Since AR positioning performance is highly dependent on device hardware configuration (e.g., camera, sensors) and system version, it is essential to accurately provide the phone model and system version information used.
Check content placement
The core purpose is to confirm whether the deviation issue is caused by improper content placement. When AR digital content appears misaligned, the reason is often not a fault in the AR positioning algorithm but inaccurate virtual content placement, such as deviations in model coordinates. Therefore, before submitting feedback, ensure the digital content aligns precisely with the positioning reference.
❌ Negative example: The cube is not placed along a clear, specific position, making it ineffective as a reference for judging visual errors during actual experience.
Verify environmental changes
Verify environmental changes to determine if positioning anomalies are affected by environmental factors. AR positioning performance relies on the surrounding environment, and differences between the testing environment and the image-capturing environment can easily lead to positioning deviations or poor performance. Therefore, ensure the two environments are consistent to avoid positioning failures caused by environmental differences.
Accurately describe the issue
First, clarify the expected presentation effect, then describe the actual presentation effect, and precisely annotate the specific details of the positional deviation. Additionally, provide a detailed explanation of the actual positioning anomalies of the AR digital content, focusing on the exact time nodes in the video where the deviation occurs.
✅ Example: The expected effect is for the panda to move along the road path; in the actual effect, at the 55-second mark, the panda's path deviates, leading toward the grassy area.
❌ Negative example: The panda is off track.
Note
Capture the anomaly in the video and mark the time and phenomenon to help others quickly locate the issue.
Provide reproduction data
When submitting an issue, also provide reproduction data. To confirm whether the data can effectively reproduce the issue, refer to this article: Confirm that the recorded data can reproduce your issue.
The core purpose of this step is to ensure the data you provide accurately reproduces the described anomaly. It is recommended to verify the data yourself before submission to confirm it fully reproduces the issue you encountered.
Related topics
Collect mobile screenshots and screen recording data