Class Cacophony

constructor

• new Cacophony(context?, cache?): Cacophony

• Parameters

  • Optional context: IAudioContext
  • Optional cache: ICache

  Returns Cacophony

context

globalGainNode

listener

listenerForwardOrientation

• get listenerForwardOrientation(): Position

• Returns Position

• set listenerForwardOrientation(forward): void

• Parameters

  • forward: Position

  Returns void

listenerOrientation

• get listenerOrientation(): Orientation

• Returns Orientation

• set listenerOrientation(orientation): void

• Parameters

  • orientation: Orientation

  Returns void

listenerPosition

• get listenerPosition(): Position

• Returns Position

• set listenerPosition(position): void

• Parameters

  • position: Position

  Returns void

listenerUpOrientation

• get listenerUpOrientation(): Position

• Returns Position

• set listenerUpOrientation(up): void

• Parameters

  • up: Position

  Returns void

muted

• get muted(): boolean

• Returns boolean

• set muted(muted): void

• Parameters

  • muted: boolean

  Returns void

volume

• get volume(): number

• Returns number

• set volume(volume): void

• Parameters

  • volume: number

  Returns void

clearMemoryCache

• clearMemoryCache(): void

• Returns void

createBiquadFilter

• createBiquadFilter(__namedParameters): BiquadFilterNode

• Parameters

  • __namedParameters: BiquadFilterOptions

  Returns BiquadFilterNode

createGroup

• createGroup(sounds): Promise<Group>

• Parameters

  • sounds: Sound[]

  Returns Promise<Group>

createGroupFromUrls

• createGroupFromUrls(urls, soundType?, panType?, signal?): Promise<Group>

• Creates a Group containing Sound instances loaded from multiple URLs.

  Parameters

  • urls: string[]

    Array of URL strings to load as sounds
  • soundType: SoundType = SoundType.Buffer

    Type of sound (Buffer, HTML, Streaming)
  • panType: PanType = "HRTF"

    Type of panning (HRTF or stereo)
  • Optional signal: AbortSignal

    Optional AbortSignal to cancel the operation

  Returns Promise<Group>

  Promise that resolves to a Group containing all loaded sounds

createOscillator

• createOscillator(options, panType?): Synth

• Parameters

  • options: OscillatorOptions
  • panType: PanType = "HRTF"

  Returns Synth

createPanner

• createPanner(options): PannerNode

• Creates a PannerNode with the specified options.

  Parameters

  • options: Partial<IPannerOptions>

    An object containing the options to use when creating the PannerNode.

  Returns PannerNode

  A new PannerNode instance with the specified options.

  Example

  const panner = audio.createPanner({
   positionX: 0,
  positionY: 0,
  positionZ: 0,
  orientationX: 0,
  orientationY: 0,
  orientationZ: 0,
  });
  Copy

createSound

• createSound(buffer, soundType?, panType?, signal?): Promise<Sound>

• Creates a Sound instance from an AudioBuffer or URL.

  Parameters

  • buffer: IAudioBuffer
  • Optional soundType: SoundType

    Type of sound (Buffer, HTML, Streaming)
  • Optional panType: PanType

    Type of panning (HRTF or stereo)
  • Optional signal: AbortSignal

    Optional AbortSignal to cancel the operation

  Returns Promise<Sound>

  Promise that resolves to a Sound instance
• createSound(url, soundType?, panType?, signal?): Promise<Sound>

• Parameters

  • url: string
  • Optional soundType: SoundType
  • Optional panType: PanType
  • Optional signal: AbortSignal

  Returns Promise<Sound>

createStream

• createStream(url, signal?): Promise<Sound>

• Creates a streaming Sound instance from a URL.

  Parameters

  • url: string

    URL string to stream audio from
  • Optional signal: AbortSignal

    Optional AbortSignal to cancel the operation

  Returns Promise<Sound>

  Promise that resolves to a Sound instance for streaming

createWorkletNode

• createWorkletNode(name, url, signal?): Promise<IAudioWorkletNode<IAudioContext>>

• Parameters

  • name: string
  • url: string
  • Optional signal: AbortSignal

  Returns Promise<IAudioWorkletNode<IAudioContext>>

emit

• emit<K>(event, data): void

• Type Parameters

  • K extends keyof CacophonyEvents

  Parameters

  • event: K
  • data: CacophonyEvents[K]

  Returns void

emitAsync

• emitAsync<K>(event, data): Promise<void>

• Type Parameters

  • K extends keyof CacophonyEvents

  Parameters

  • event: K
  • data: CacophonyEvents[K]

  Returns Promise<void>

getMicrophoneStream

• getMicrophoneStream(): Promise<MicrophoneStream>

• Returns Promise<MicrophoneStream>

loadWorklets

• loadWorklets(signal?): Promise<void>

• Parameters

  • Optional signal: AbortSignal

  Returns Promise<void>

mute

• mute(): void

• Returns void

off

• off<K>(event, listener): void

• Remove event listener.

  Type Parameters

  • K extends keyof CacophonyEvents

  Parameters

  • event: K
  • listener: ((data) => void)
    • • (data): void

      • Parameters

        • data: CacophonyEvents[K]

        Returns void

  Returns void

on

• on<K>(event, listener): void

• Register event listener.

  Type Parameters

  • K extends keyof CacophonyEvents

  Parameters

  • event: K
  • listener: ((data) => void)
    • • (data): void

      • Parameters

        • data: CacophonyEvents[K]

        Returns void

  Returns void

  Cleanup function

pause

• pause(): void

• Suspends the audio context.

  Returns void

resume

• resume(): void

• Resumes the audio context. This method is required to resume the audio context on mobile devices. On desktop, the audio context will automatically resume when a sound is played.

  Returns void

setGlobalVolume

• setGlobalVolume(volume): void

• Parameters

  • volume: number

  Returns void

unmute

• unmute(): void

• Returns void