Audio in WebGL 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.
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:
clip
dopplerLevel
ignoreListenerPause
ignoreListenerVolume
isPlaying
loop
maxDistance
minDistance
mute
pitch
playOnAwake
rolloffMode
time
timeSamples
velocityUpdateMode
volume
Methods:
Pause
Play
PlayDelayed
PlayOneShot
PlayScheduled
SetScheduledEndTime
SetScheduledStartTime
Stop
UnPause
PlayClipAtPoint
All AudioListener
APIs are supported.
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.
WWW.audioClip
should work in WebGL, if the audio clip is in a format which is natively supported by the browser. See here for a list of supported formats in different browsers.
The Microphone
class is not supported in WebGL.