Legacy Documentation: Version 2018.2 (Go to current version)
WebGL Networking
WebGL performance considerations
Other Versions

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 All AudioClip APIs are supported. APIs are supported:

Properties:

Methods:

  • Create. AudioClip.Create is supported partially: it will only work if the streaming parameter is set to false and the complete audio samples can be loaded at the time AudioClip.Create is called. It will then create the clip and load all samples before returning control.
  • SetData. AudioClip.SetData is supported partially: it will only work 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 here for a list of supported formats in different browsers.

Microphone

The Microphone class is not supported in WebGL.

Did you find this page useful? Please give it a rating:

WebGL Networking
WebGL performance considerations