phaser - v4.0.0-rc.4
    Preparing search index...

    Class NoAudioSoundManager

    No-audio implementation of the Sound Manager. It is used if audio has been disabled in the game config or the device doesn't support any audio.

    It represents a graceful degradation of Sound Manager logic that provides minimal functionality and prevents Phaser projects that use audio from breaking on devices that don't support any audio playback technologies.

    Hierarchy (View Summary)

    Index

    Constructors

    Properties

    detune: number

    Global detuning of all sounds in cents. The range of the value is -1200 to 1200, but we recommend setting it to 50.

    game: Game

    Local reference to game.

    gameLostFocus: boolean

    Flag used to track if the game has lost focus.

    jsonCache: BaseCache

    Local reference to the JSON Cache, as used by Audio Sprites.

    listenerPosition: Math.Vector2

    The Spatial Audio listener position.

    Only available with WebAudio.

    You can modify the x/y properties of this Vec2 directly to adjust the listener position within the game world.

    locked: boolean

    Mobile devices require sounds to be triggered from an explicit user action, such as a tap, before any sound can be loaded/played on a web page. Set to true if the audio system is currently locked awaiting user interaction.

    mute: boolean

    Global mute setting.

    pauseOnBlur: boolean

    Flag indicating if sounds should be paused when game looses focus, for instance when user switches to another tab/program/app.

    rate: number

    Global playback rate at which all the sounds 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 audio's playback speed.

    volume: number

    Global volume setting.

    Methods

    • Add a listener for a given event.

      Parameters

      • event: string | symbol

        The event name.

      • fn: Function

        The listener function.

      • Optionalcontext: any

        The context to invoke the listener with. Default this.

      Returns this

    • Calls each of the listeners registered for a given event.

      Parameters

      • event: string | symbol

        The event name.

      • ...args: any[]

        Additional arguments that will be passed to the event handler.

      Returns boolean

    • When a key is given, returns true if any sound with that key is playing.

      When no key is given, returns true if any sound is playing.

      Parameters

      • key: string

        Sound asset key.

      Returns boolean

    • Return the listeners registered for a given event.

      Parameters

      • event: string | symbol

        The event name.

      Returns Function[]

    • Remove the listeners of a given event.

      Parameters

      • event: string | symbol

        The event name.

      • Optionalfn: Function

        Only remove the listeners that match this function.

      • Optionalcontext: any

        Only remove the listeners that have this context.

      • Optionalonce: boolean

        Only remove one-time listeners.

      Returns this

    • Add a listener for a given event.

      Parameters

      • event: string | symbol

        The event name.

      • fn: Function

        The listener function.

      • Optionalcontext: any

        The context to invoke the listener with. Default this.

      Returns this

    • Add a one-time listener for a given event.

      Parameters

      • event: string | symbol

        The event name.

      • fn: Function

        The listener function.

      • Optionalcontext: any

        The context to invoke the listener with. Default this.

      Returns this

    • This method does nothing but return 'false' for the No Audio Sound Manager, to maintain compatibility with the other Sound Managers.

      Parameters

      • key: string

        Asset key for the sound.

      • Optionalextra: SoundConfig | SoundMarker

        An optional additional object containing settings to be applied to the sound. It could be either config or marker object.

      Returns boolean

    • This method does nothing but return 'false' for the No Audio Sound Manager, to maintain compatibility with the other Sound Managers.

      Parameters

      • key: string

        Asset key for the sound.

      • spriteName: string

        The name of the sound sprite to play.

      • Optionalconfig: SoundConfig

        An optional config object containing default sound settings.

      Returns boolean

    • Removes all sounds from the sound manager that have an asset key matching the given value. The removed sounds are destroyed before removal.

      Parameters

      • key: string

        The key to match when removing sound objects.

      Returns number

    • Remove the listeners of a given event.

      Parameters

      • event: string | symbol

        The event name.

      • Optionalfn: Function

        Only remove the listeners that match this function.

      • Optionalcontext: any

        Only remove the listeners that have this context.

      • Optionalonce: boolean

        Only remove one-time listeners.

      Returns this

    • Sets the X and Y position of the Spatial Audio listener on this Web Audios context.

      If you call this method with no parameters it will default to the center-point of the game canvas. Depending on the type of game you're making, you may need to call this method constantly to reset the listener position as the camera scrolls.

      Calling this method does nothing on HTML5Audio.

      Parameters

      • Optionalx: number

        The x position of the Spatial Audio listener.

      • Optionaly: number

        The y position of the Spatial Audio listener.

      Returns void