Audio

ecs.Audio

Description

The Audio component defines the audio behavior of an entity.

Functions

See component schema.

Schema

Property	Type	Default	Required	Description
url	String	-	true	The source url.
volume	Number	1	false	How loud the audio will be played. A value between 0 and 1
loop	Boolean	false	false	Whether the audio restarts after it finishes playing or not.
paused	Boolean	false	false	Whether the audio is paused or currently playing.
pitch	Number	1	false	The factor used to change the audio's pitch, with 1.0 being the audio's default, 2.0 being one octave higher, 0.5 one octave lower, etc.
positional	Boolean	false	false	Whether the audio is positional (considers position relative to the listener) or not.
refDistance	Number	1	false	Only applied if positional is true. The value indicating at what distance the volume from this source will start reducing as the listener moves away. Must be a non-negative value.
distanceModel	Name of the distance model	'inverse'	false	Only applied if positional is true. The algorithm used to reduce volume as the distance increases between this audio source and the listener. Possible values include linear, inverse, and exponential.
rolloffFactor	Number	1	false	Only applied if positional is true. How quickly volume is reduced as distance increases between this audio source and the listener. The acceptable range of values changes depending on the distanceModel, shown by the following: linear: 0 to 1, inverse: 0 to Infinity, exponential: 0 to Infinity
maxDistance	Number	10000	false	Only applied if positional is true and distanceModel equals linear. The max distance between this audio source and the listener. Volume is not reduced after this point. Must be a positive value.