Version: 2020.1
WebGL Graphics
Embedded Resources on WebGL

Using Audio In WebGL

Audio in WebGLA JavaScript API that renders 2D and 3D graphics in a web browser. The Unity WebGL build option allows Unity to publish content as JavaScript programs which use HTML5 technologies and the WebGL rendering API to run Unity content in a web browser. More info
See in Glossary
is done differently then on all other platforms. On other platforms we use FMOD internally to supply audio playback and mixing. Since the WebGL platform does not support threads, we need to use a different implementation, which is internally based on the Web Audio API, which lets the browser handle audio playback and mixing for us.

Unfortunately, this limits audio functionality in Unity WebGL to supporting only the most basic features. This page will document what is expected to work. Anything not listed here is not currently supported on WebGL.

AudioSource

Audio sources support basic positional audio playback with pausing and resuming, panning, rolloff, pitch setting, and doppler effect support.

The following AudioSource APIs are supported:

Properties

Methods

AudioListener

All AudioListener APIs are supported.

AudioClip

Audio clips in WebGL will always be imported in the AAC format, as that is widely supported by different browsers.

The following AudioClip APIs are supported:

Properties

Methods

  • AudioClip.Create is supported partially: it only works if the streaming parameter is set to false and the complete audio samples can be loaded at the time AudioClip.Create is called. It then creates the clip and loads all samples before returning control.
  • AudioClip.SetData is supported partially: it only works for replacing the entire contents of the AudioClip. The offsetSamples parameter is ignored.

SystemInfo.supportsAudio

SystemInfo.supportsAudio is not implemented on WebGL and always returns true.

WWW.audioClip

WWW.audioClip should work in WebGL, if the audio clipA container for audio data in Unity. Unity supports mono, stereo and multichannel audio assets (up to eight channels). Unity can import .aif, .wav, .mp3, and .ogg audio file format, and .xm, .mod, .it, and .s3m tracker module formats. More info
See in Glossary
is in a format which is natively supported by the browser. See Mozilla’s documentation on supported media formats for a list of supported formats in different browsers.

Microphone

The Microphone class is not supported in WebGL.

WebGL Graphics
Embedded Resources on WebGL