Skip to main content

Troubleshooting

· I get errors about SuperAuth​

SuperAuth is no longer needed since version 2.0.0. If you are using an older version, we highly suggest you to update since this will be deprecated in the future. If you want to keep the old version you will need to setup your developer credentials for the API. Please read Super Auth

· I get Draco/DracoUnity errors in Unity 2022 WebGL builds​

The latest DracoUnity version released doesn't have support for Unity 2022 WebGL out-of-the-box. But you can follow the steps explained in this answer to make it work: DracoUnity Github Issue

· Missing dependencies errors​

When you add our SDK for the first time it automatically add the required packages dependencies. If for some reason the installation fails, you can add them again using the tool in the top bar (Union Avatars > Install Requirements). If that still doesn't work, you can try adding the following packages manually through UPM:

· Avatars don't load in the build, but they do in Editor (Build crashes but editor works)​

Most of the time this issue is related to missing shaders in your build. You can either create new shader variants files or add the shaders to the “Always Inlude Shaders” list in the build settings. Please check the Project Requirements and read the GLTFast documentation as it will explain all you need to get it running.

· The shaders look bad in the Build, but they look fine in the Editor​

You might have not added the correct shader to the “Always Inlude Shaders” list in the build settings. Please check the Project Requirements and follow the instructions.

Another cause, if you’re building for Android, could be the Normal Map Encoding. We are still looking for a reliable way to approach this, but as a workaround you can change the Normal Map Encoding in the Player Settings to “XYZ”.

· I’m getting CORS errors in WebGL​

If you are trying to host your project built with WebGL you will probably find Cross-Origin Request errors when calling the API. To work around this you should run your tests on “http://localhost:3000/” as it is the only origin we allow currently. If you wish to have your custom origin added, you can contact us on techsupport@unionavatars.com.

· The UI renders the background in HDRP​

Change the Color Buffer Format from R11G11B10 to R16G16B16A16 in your Render Pipeline Settings asset. Source


tip

Still having troubles setting up the SDK? Contact us: techsupport@unionavatars.com