Class Sound

The base interface for any sound-producing entity, including individual sounds, groups, and playbacks. BaseSound

Hierarchy

  • PlaybackContainer<typeof FilterManager, this> & FilterManager<this>
    • Sound

Implements

Constructors

constructor

Properties

_filters _playbackRate _position _stereoPan _threeDOptions _volume buffer? context globalGainNode loopCount panType playbacks soundType url

Accessors

duration filters isPlaying playbackRate position stereoPan threeDOptions volume

Methods

addFilter addFilters applyFilters clone loop pause play preplay removeFilter removeFilters seek stop

Constructors

constructor

  • new Sound(url, buffer, context, globalGainNode, soundType?, panType?): Sound

  • Parameters

    • url: string
    • buffer: undefined | IAudioBuffer
    • context: IAudioContext
    • globalGainNode: GainNode
    • soundType: SoundType = SoundType.Buffer
    • panType: PanType = "HRTF"

    Returns Sound

Properties

_filters

_filters: BiquadFilterNode[] = []

Private _playbackRate

_playbackRate: number = 1

_position

_position: Position = ...

_stereoPan

_stereoPan: number = 0

_threeDOptions

_threeDOptions: PannerOptions = ...

_volume

_volume: number = 1

Optional buffer

buffer?: IAudioBuffer

context

context: IAudioContext

Private globalGainNode

globalGainNode: GainNode

loopCount

loopCount: LoopCount = 0

panType

panType: PanType = "HRTF"

playbacks

playbacks: Playback[]

soundType

soundType: SoundType = SoundType.Buffer

url

url: string

Accessors

duration

  • get duration(): number

  • Retrieves the duration of the sound in seconds. If the sound is based on an AudioBuffer, it returns the duration of the buffer. Otherwise, if the sound has not been played and is a MediaElementSource, it returns NaN, indicating that the duration is unknown or not applicable.

    Returns number

    The duration of the sound in seconds.

filters

  • get filters(): BiquadFilterNode[]

  • Returns BiquadFilterNode[]

isPlaying

  • get isPlaying(): boolean

  • Returns a boolean indicating whether the object is currently playing. an object is playing if any of its playbacks are currently playing.

    Returns boolean

    True if the object is playing, false otherwise.

playbackRate

  • get playbackRate(): number

  • Returns number

  • set playbackRate(rate): void

  • Parameters

    • rate: number

    Returns void

position

  • get position(): Position

  • Retrieves the current 3D spatial position of the sound in the audio context. The position is returned as an array of three values[x, y, z].

    Returns Position

    The current position of the sound.

  • set position(position): void

  • Sets the 3D spatial position of the sound in the audio context. The position is an array of three values[x, y, z]. This method updates the position of all active playbacks of the sound.

    Parameters

    • position: Position

      The new position of the sound.

    Returns void

stereoPan

  • get stereoPan(): null | number

  • Returns null | number

  • set stereoPan(value): void

  • Parameters

    • value: number

    Returns void

threeDOptions

  • get threeDOptions(): PannerOptions

  • Returns PannerOptions

  • set threeDOptions(options): void

  • Parameters

    • options: Partial<PannerOptions>

    Returns void

volume

  • get volume(): number

  • Gets the volume of the sound. This volume level affects all current and future playbacks of this sound instance. The volume is specified as a linear value between 0 (silent) and 1 (full volume).

    Returns number

    The current volume of the sound.

  • set volume(volume): void

  • Sets the volume of the sound. This volume level affects all current and future playbacks of this sound instance. The volume is specified as a linear value between 0 (silent) and 1 (full volume).

    Parameters

    • volume: number

      The new volume level for the sound.

    Returns void

Methods

addFilter

  • addFilter(filter): void

  • Adds a BiquadFilterNode to the container's filter chain. Filters are applied in the order they are added.

    Parameters

    • filter: BiquadFilterNode

      The filter to add to the chain.

    Returns void

addFilters

  • addFilters(filters): void

  • Parameters

    • filters: BiquadFilterNode[]

    Returns void

applyFilters

  • applyFilters(connection): any

  • Parameters

    • connection: any

    Returns any

clone

  • clone(overrides?): Sound

  • Clones the current Sound instance, creating a deep copy with the option to override specific properties. This method allows for the creation of a new, independent Sound instance based on the current one, with the flexibility to modify certain attributes through the overrides parameter. This is particularly useful for creating variations of a sound without affecting the original instance. The cloned instance includes all properties, playback settings, and filters of the original, unless explicitly overridden.

    Parameters

    • overrides: Partial<SoundCloneOverrides> = {}

      An object specifying properties to override in the cloned instance. This can include audio settings like volume, playback rate, and spatial positioning, as well as more complex configurations like 3D audio options and filter adjustments.

    Returns Sound

    A new Sound instance that is a clone of the current sound.

loop

  • loop(loopCount?): LoopCount

  • Sets or retrieves the loop behavior for the sound. If loopCount is provided, the sound will loop the specified number of times. If loopCount is 'infinite', the sound will loop indefinitely until stopped. If no argument is provided, the method returns the current loop count setting.

    Parameters

    • Optional loopCount: LoopCount

      The number of times to loop or 'infinite' for indefinite looping.

    Returns LoopCount

    The current loop count setting if no argument is provided.

pause

  • pause(): void

  • Pauses all current playbacks of the sound.

    Returns void

play

  • play(): BasePlayback[]

  • Starts playback of the sound and returns a Playback instance representing this particular playback. Multiple Playback instances can be created by calling this method multiple times, allowing for the same sound to be played concurrently with different settings.

    Returns BasePlayback[]

    An array containing the Playback instances that have been started.

preplay

  • preplay(): Playback[]

  • Generates a Playback instance for the sound without starting playback. This allows for pre-configuration of playback properties such as volume and position before the sound is actually played.

    Returns Playback[]

    An array of Playback instances that are ready to be played.

removeFilter

  • removeFilter(filter): void

  • Removes a BiquadFilterNode from the container's filter chain. If the filter is not part of the chain, the method has no effect.

    Parameters

    • filter: BiquadFilterNode

      The filter to remove from the chain.

    Returns void

removeFilters

  • removeFilters(filters): void

  • Parameters

    • filters: BiquadFilterNode[]

    Returns void

seek

  • seek(time): void

  • Seeks to a specific time within the sound's playback.

    Parameters

    • time: number

      The time in seconds to seek to. This method iterates through all active Playback instances and calls their seek() method with the specified time.

    Returns void

stop

  • stop(): void

  • Stops all current playbacks of the sound immediately. This will halt the sound regardless of how many times it has been played.

    Returns void

Settings

Member Visibility

Theme

On This Page

constructor_filters_playbackRate_position_stereoPan_threeDOptions_volumebuffercontextglobalGainNodeloopCountpanTypeplaybackssoundTypeurldurationfiltersisPlayingplaybackRatepositionstereoPanthreeDOptionsvolumeaddFilteraddFiltersapplyFiltersclonelooppauseplaypreplayremoveFilterremoveFiltersseekstop