new HTML5AudioSound(manager, key, [config])
name | type | arguments | Default | description |
---|---|---|---|---|
manager | Phaser.Sound.HTML5AudioSoundManager |
Reference to the current sound manager instance. |
||
key | string |
Asset key for the sound. |
||
config | Phaser.Types.Sound.SoundConfig | <optional> | {} |
An optional config object containing default sound settings. |
Currently playing marker. 'null' if whole sound is playing.
The detune value of this Sound, given in cents. The range of the value is -1200 to 1200, but we recommend setting it to 50.
A value representing the duration, in seconds. It could be total sound duration or a marker duration.
Flag indicating if sound is currently paused.
Flag indicating if sound is currently playing.
Asset key for the sound.
Flag indicating whether or not the sound or current sound marker will loop.
Object containing markers definitions.
Boolean indicating whether the sound is muted or not. Gets or sets the muted state of this sound.
Gets or sets the pan of this sound, a value between -1 (full left pan) and 1 (full right pan).
Has no audible effect on HTML5 Audio Sound, but still generates the PAN Event.
Rate at which this Sound will be played. Value of 1.0 plays the audio at full speed, 0.5 plays the audio at half speed and 2.0 doubles the audios playback speed.
Property representing the position of playback for this sound, in seconds. Setting it to a specific value moves current playback to that position. The value given is clamped to the range 0 to current marker duration. Setting seek of a stopped sound has no effect.
The total duration of the sound in seconds.
A property that holds the value of sound's actual playback rate, after its rate and detune values has been combined with global rate and detune values.
Gets or sets the volume of this sound, a value between 0 (silence) and 1 (full volume).
Add a listener for a given event.
name | type | arguments | Default | description |
---|---|---|---|---|
event | string | symbol |
The event name. |
||
fn | function |
The listener function. |
||
context | * | <optional> | this |
The context to invoke the listener with. |
this
.
Adds a marker into the current sound. A marker is represented by name, start time, duration, and optionally config object. This allows you to bundle multiple sounds together into a single audio file and use markers to jump between them for playback.
name | type | description |
---|---|---|
marker | Phaser.Types.Sound.SoundMarker |
Marker object. |
Whether the marker was added successfully.
Method used internally for applying config values to some of the sound properties.
Method used internally to calculate total playback rate of the sound.
Calls Phaser.Sound.BaseSound#destroy method and cleans up all HTML5 Audio related stuff.
Calls each of the listeners registered for a given event.
name | type | arguments | description |
---|---|---|---|
event | string | symbol |
The event name. |
|
args | * | <optional> |
Additional arguments that will be passed to the event handler. |
true
if the event had listeners, else false
.
Return an array listing the events for which the emitter has registered listeners.
Return the number of listeners listening to a given event.
name | type | description |
---|---|---|
event | string | symbol |
The event name. |
The number of listeners.
Return the listeners registered for a given event.
name | type | description |
---|---|---|
event | string | symbol |
The event name. |
The registered listeners.
Remove the listeners of a given event.
name | type | arguments | description |
---|---|---|---|
event | string | symbol |
The event name. |
|
fn | function | <optional> |
Only remove the listeners that match this function. |
context | * | <optional> |
Only remove the listeners that have this context. |
once | boolean | <optional> |
Only remove one-time listeners. |
this
.
Add a listener for a given event.
name | type | arguments | Default | description |
---|---|---|---|---|
event | string | symbol |
The event name. |
||
fn | function |
The listener function. |
||
context | * | <optional> | this |
The context to invoke the listener with. |
this
.
Add a one-time listener for a given event.
name | type | arguments | Default | description |
---|---|---|---|---|
event | string | symbol |
The event name. |
||
fn | function |
The listener function. |
||
context | * | <optional> | this |
The context to invoke the listener with. |
this
.
Pauses the sound.
Whether the sound was paused successfully.
Play this sound, or a marked section of it. It always plays the sound from the start. If you want to start playback from a specific time you can set 'seek' setting of the config object, provided to this call, to that value.
name | type | arguments | Default | description |
---|---|---|---|---|
markerName | string | Phaser.Types.Sound.SoundConfig | <optional> | '' |
If you want to play a marker then provide the marker name here. Alternatively, this parameter can be a SoundConfig object. |
config | Phaser.Types.Sound.SoundConfig | <optional> |
Optional sound config object to be applied to this marker or entire sound if no marker name is provided. It gets memorized for future plays of current section of the sound. |
Whether the sound started playing successfully.
Remove all listeners, or those of the specified event.
name | type | arguments | description |
---|---|---|---|
event | string | symbol | <optional> |
The event name. |
this
.
Remove the listeners of a given event.
name | type | arguments | description |
---|---|---|---|
event | string | symbol |
The event name. |
|
fn | function | <optional> |
Only remove the listeners that match this function. |
context | * | <optional> |
Only remove the listeners that have this context. |
once | boolean | <optional> |
Only remove one-time listeners. |
this
.
Removes a marker from the sound.
name | type | description |
---|---|---|
markerName | string |
The name of the marker to remove. |
Removed marker object or 'null' if there was no marker with provided name.
Method used internally for resetting values of some of the config properties.
Resumes the sound.
Whether the sound was resumed successfully.
Sets the detune value of this Sound, given in cents. The range of the value is -1200 to 1200, but we recommend setting it to 50.
name | type | description |
---|---|---|
value | number |
The range of the value is -1200 to 1200, but we recommend setting it to 50. |
This Sound instance.
Sets the loop state of this Sound.
name | type | description |
---|---|---|
value | boolean |
|
This Sound instance.
Sets the muted state of this Sound.
name | type | description |
---|---|---|
value | boolean |
|
This Sound instance.
Sets the pan of this sound, a value between -1 (full left pan) and 1 (full right pan).
Has no audible effect on HTML5 Audio Sound, but still generates the PAN Event.
name | type | description |
---|---|---|
value | number |
The pan of the sound. A value between -1 (full left pan) and 1 (full right pan). |
This Sound instance.
Sets the playback rate of this Sound.
For example, a value of 1.0 plays the audio at full speed, 0.5 plays the audio at half speed and 2.0 doubles the audios playback speed.
name | type | description |
---|---|---|
value | number |
The playback rate at of this Sound. |
This Sound instance.
Seeks to a specific point in this sound.
name | type | description |
---|---|---|
value | number |
The point in the sound to seek to. |
This Sound instance.
Sets the volume of this Sound.
name | type | description |
---|---|---|
value | number |
The volume of the sound. |
This Sound instance.
Removes all listeners.
Stop playing this sound.
Whether the sound was stopped successfully.
Update method called automatically by sound manager on every game step.
name | type | description |
---|---|---|
time | number |
The current timestamp as generated by the Request Animation Frame or SetTimeout. |
Updates previously added marker.
name | type | description |
---|---|---|
marker | Phaser.Types.Sound.SoundMarker |
Marker object with updated values. |
Whether the marker was updated successfully.