Class: Sound

Constructor

new Sound(zzfxSound, rangeopt, taperopt)

Create a sound object and cache the zzfx samples for later use

Parameters:

Name	Type	Attributes	Default	Description
`zzfxSound`	Array			Array of zzfx parameters, ex. [.5,.5]
`range`	number	<optional>	soundDefaultRange	World space max range of sound
`taper`	number	<optional>	soundDefaultTaper	At what percentage of range should it start tapering

Source: src/engineAudio.js, line 57

Example

// create a sound
const sound_example = new Sound([.5,.5]);

// play the sound
sound_example.play();

Members

loadedPercent

Properties

Type	Description
number	Percentage of this sound currently loaded

Source: src/engineAudio.js, line 77

randomness

Properties

Type	Description
number	How much to randomize frequency each time sound plays

Source: src/engineAudio.js, line 73

range

Properties

Type	Description
number	World space max range of sound

Source: src/engineAudio.js, line 69

sampleRate

Properties

Type	Description
number	Sample rate for this sound

Source: src/engineAudio.js, line 75

taper

Properties

Type	Description
number	At what percentage of range should it start tapering

Source: src/engineAudio.js, line 71

Methods

getDuration() → {number}

Get how long this sound is in seconds

Source: src/engineAudio.js, line 158

Returns:

How long the sound is in seconds (undefined if loading)

Type:: number

isLoaded() → {boolean}

Check if sound is loaded, for sounds fetched from a url

Source: src/engineAudio.js, line 164

Returns:

True if sound is loaded and ready to play

Type:: boolean

play(posopt, volumeopt, pitchopt, randomnessScaleopt, loopopt, pausedopt) → {SoundInstance}

Play the sound Sounds may not play until a user interaction occurs

Parameters:

Name	Type	Attributes	Default	Description
`pos`	Vector2	<optional>		World space position to play the sound if any
`volume`	number	<optional>	1	How much to scale volume by
`pitch`	number	<optional>	1	How much to scale pitch by
`randomnessScale`	number	<optional>	1	How much to scale pitch randomness
`loop`	boolean	<optional>	false	Should the sound loop?
`paused`	boolean	<optional>	false	Should the sound start paused

Source: src/engineAudio.js, line 104

Returns:

The audio source node

Type:: SoundInstance

playMusic(volumeopt, loopopt, pausedopt) → {SoundInstance}

Play a music track that loops by default

Parameters:

Name	Type	Attributes	Default	Description
`volume`	number	<optional>	1	Volume to play the music at
`loop`	boolean	<optional>	true	Should the music loop?
`paused`	boolean	<optional>	false	Should the music start paused

Source: src/engineAudio.js, line 139

Returns:

The audio source node

Type:: SoundInstance

playNote(semitoneOffset, posopt, volumeopt) → {SoundInstance}

Play the sound as a musical note with a semitone offset This can be used to play music with chromatic scales

Parameters:

Name	Type	Attributes	Default	Description
`semitoneOffset`	number			How many semitones to offset pitch
`pos`	Vector2	<optional>		World space position to play the sound if any
`volume`	number	<optional>	1	How much to scale volume by

Source: src/engineAudio.js, line 149

Returns:

The audio source node

Type:: SoundInstance