Why this happens
Prior to Web SDK 4.1 and iOS SDK 8.0, WANNA experiences required each 3D model to have a single UV layout within the [0,1] coordinate space.
If a model contained multiple UV sets, it could not pass validation and would be rejected during upload.
In Web SDK 4.1 and iOS SDK 8.0 or later, models with multiple UV sets are supported.
However, if you work with earlier versions of the SDK, you must merge all UV maps into one before exporting the model.
How to fix it
1. Inspect the UV maps
- Open the model and check the number of UV channels it contains
- Identify which UV map is best suited for texturing, considering texel density, stretching, and optimization
2. Remove unnecessary UV maps
- Select the less optimized or unused UV map
- Delete it by selecting "Remove UV Map" in your 3D software
- Ensure that only one UV map remains and that it fits within the [0,1] UV space
3. Refine & optimize the UV layout
- Check that the remaining UV layout is correctly mapped and efficiently utilizes UV space
- Ensure that texel density is consistent across all parts of the model
- Avoid stretching or compression in high-visibility areas
-
If necessary, repack the UVs to maximize space usage
4. Verify & Test in WANNA Studio
- Once the UV layout is optimized, export the model and test it in WANNA Studio.
- Ensure that textures display correctly and that there are no mapping issues.