Version: 2019.4
Using Audio In WebGL
Embedded Resources on WebGL

WebGL performance considerations

What kind of performance can you expect on WebGL?

In general, you should get performance close to native apps on the GPU, because the WebGL graphics API uses your GPU for hardware-accelerated rendering. There is a small amount of overhead for translating WebGL API calls and shaders to your OS graphics API (typically DirectX on Windows or OpenGL on Mac or Linux).

On the CPU, Emscripten translates your code into WebAssembly, so performance depends on the web browser. For more information, see the Unity blog post WebAssembly Load Times and Performance.

There are some other considerations you need to be aware of. The JavaScript language does not support multi-threading or SIMD. Any code that benefits from these features are likely to be slower then other code. You cannot write threading or SIMD code in WebGL in your scripts, but some engine parts are normally multi-threaded or SIMD optimized, and therefore with lower performance on WebGL. An example is the skinning code, which is both multi-threaded and SIMD-optimized.

You can use the new timeline Profiler in Unity to see how Unity distributes work to different threads on non-WebGL platforms.

WebGL-specific settings which affect performance

For best performance, set the optimization level to Fastest in the Build Player dialog, and set Exception support to None in the Player settings for WebGL.

Profiling WebGL

WebGL supports the Unity profiler. See documentation on the Profiler to learn how to set it up.

WebGL content in background tabs

If Run in background is enabled in the Player settings for the WebGL platform, or if you enable Application.runInBackground, your content continues to run when the canvas or the browser window loses focus.

However, some browsers can throttle content running in background tabs. If the tab with your content is not visible, your content only updates once per second in most browsers. Note that this causes Time.time to progress slower than usual with the default settings, as the default value of Time.maximumDeltaTime is lower than one second.

Throttling WebGL performance

You might want to run your WebGL content at a lower frame rate in some situations to reduce CPU usage. Like on other platforms, you can use the Application.targetFrameRate API to do so.

When you don’t want to throttle performance, set this API to the default value of –1, rather then to a high value. This allows the browser to adjust the frame rate for the smoothest animation in the browser’s render loop, and might produce better results than Unity trying to do its own main loop timing to match a target frame rate.

  • 2019–06–10 Page amended
Using Audio In WebGL
Embedded Resources on WebGL