WebGL Platform

Important

We do not officially support WebGL, but still include it as it may be useful for some people. We found too many issues with browser compatibility to continue supporting it

Plugin Specs

  • Compatibility
    • We have had especially troubling times with the Safari browser as it has very strict rules about content playback, and also mobile browsers
    • Web security features like CORS also make this platform difficult to support
    • The supported formats and features is dependant on the web browser capabilities
    • We have used it for playback of MP4 files, HLS and MPEG-DASH streams
    • The plugin supports extensions via the hls.js and dash.js libraries for browsers that do not have native support for these streaming formats
  • Rendering
    • The plugin supports both WebGL 1.0 and 2.0, however some browsers (notably Safari) do not support WebGL 2.0
  • Internals
    • Under the hood we’re just using the <video> browser tag
    • No 3rd-party libraries are used, however there is support for adding specific 3rd-party libraries (hls.js and dash.js)

Supported Media

See the Supported Media section for more information.

Streaming

See the Streaming section for more information.

Platform-Specific Options

See the Platform-Specific Options section for more information.

Troubleshooting

Compatibility

  • The Run in Background setting in Player Settings is best enabled as browsers can sometimes stop updating the Unity context which can lead to problems with state not being updated.

  • For best compatibility you can always force WebGL 1.0 instead of 2.0 (which is the default). This is done by going to Player Settings > Other Settings > Auto Graphics API and removing WebGL 2.0. We have tested successfully with the following browsers

    • macOS
      • Mozilla Firefox
      • Google Chrome
    • Windows
      • Microsoft Edge 38.14393.0.0
      • Mozilla Firefox 51.0
      • Google Chrome 56.0 - 62.0

  • The following browsers are not supported:

    • Internet Explorer 11 (any version), instead use the Microsoft Edge browser
  • iOS
    • All browsers on iOS are required to use WebKit and as a result exhibit the same behaviour as Safari, which at this time is not supported.