Class PcmStreamSound

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

Hierarchy

RoutableSource
- PcmStreamSound

Implements

BaseSound

Constructors

constructor

new PcmStreamSound(
    workletNode: AudioWorkletNode,
    context: BaseContext,
    globalGainNode: GainNode,
    options: PcmStreamSoundOptions & {
        bufferDuration: number;
        channelCount: number;
        latency: number;
    },
    _cacophony?: Cacophony,
): PcmStreamSound
Parameters
- workletNode: AudioWorkletNode
- context: BaseContext
- globalGainNode: GainNode
- options: PcmStreamSoundOptions & {
      bufferDuration: number;
      channelCount: number;
      latency: number;
  }
- Optional_cacophony: Cacophony
Returns PcmStreamSound
Overrides RoutableSource.constructor
- Defined in src/pcmStream.ts:212

Properties

_filters

_filters: BiquadFilterNode[] = []

_position

_position: Position

`Protected`_routeTarget

_routeTarget: Bus | null = null

Primary route target. null is the canonical master route.

`Protected`_sends

_sends: Map<Bus, number> = ...

Additional send target to gain-value mappings.

_stereoPan

_stereoPan: number

_threeDOptions

_threeDOptions: ThreeDOptions

_volume

_volume: number

`Protected`context

context: BaseContext

`Protected`globalGainNode

globalGainNode: GainNode

playbacks

playbacks: PcmStreamPlayback[]

`Optional`soundType

soundType?: SoundType

`Optional`streamCapabilities

streamCapabilities?: StreamCapabilities

Accessors

bufferedDuration

get bufferedDuration(): number
Returns number
- Defined in src/pcmStream.ts:240

cacophony

get cacophony(): Cacophony | undefined
Returns Cacophony | undefined
Overrides RoutableSource.cacophony
- Defined in src/pcmStream.ts:236

filters

get filters(): BiquadFilterNode[]
Returns BiquadFilterNode[]
Inherited from RoutableSource.filters
- Defined in src/filters.ts:38

inputChannelCount

get inputChannelCount(): number
Returns number
- Defined in src/pcmStream.ts:244

isPlaying

get isPlaying(): boolean
Returns boolean
Implementation of BaseSound.isPlaying

Inherited from RoutableSource.isPlaying
- Defined in src/container.ts:56

playbackRate

get playbackRate(): number
Returns number
- Defined in src/pcmStream.ts:414
set playbackRate(_rate: number): void
Parameters
- _rate: number
Returns void
- Defined in src/pcmStream.ts:418

position

get position(): Position
Returns Position
Implementation of BaseSound.position

Inherited from RoutableSource.position
- Defined in src/container.ts:57
set position(position: Position): void
Parameters
- position: Position
Returns void
Implementation of BaseSound.position

Inherited from RoutableSource.position
- Defined in src/container.ts:58

stereoPan

get stereoPan(): number
Returns number
Inherited from RoutableSource.stereoPan
- Defined in src/container.ts:61
set stereoPan(value: number): void
Parameters
- value: number
Returns void
Inherited from RoutableSource.stereoPan
- Defined in src/container.ts:62

threeDOptions

get threeDOptions(): ThreeDOptions
Returns ThreeDOptions
Implementation of BaseSound.threeDOptions

Inherited from RoutableSource.threeDOptions
- Defined in src/container.ts:59
set threeDOptions(options: ThreeDOptions | Partial<HrtfPannerOptions>): void
Parameters
- options: ThreeDOptions | Partial<HrtfPannerOptions>
Returns void
Implementation of BaseSound.threeDOptions

Inherited from RoutableSource.threeDOptions
- Defined in src/container.ts:60

volume

get volume(): number
Returns number
Implementation of BaseSound.volume

Inherited from RoutableSource.volume
- Defined in src/container.ts:63
set volume(volume: number): void
Parameters
- volume: number
Returns void
Implementation of BaseSound.volume

Inherited from RoutableSource.volume
- Defined in src/container.ts:64

Methods

_onBusDrained

_onBusDrained(bus: Bus, target: Bus): void
Called by Bus.drainTo to move this source off the draining bus onto target. The source reroutes its primary route and/or any send that targeted bus.
Parameters
- bus: Bus
- target: Bus
Returns void
Inherited from RoutableSource._onBusDrained
- Defined in src/routableSource.ts:205

`Protected`_preparePlayback

_preparePlayback(playback: BasePlayback): void
Materialize all declared recipes, then establish this playback's sends.
Parameters
- playback: BasePlayback
Returns void
Inherited from RoutableSource._preparePlayback
- Defined in src/routableSource.ts:125

_resolveRouteTargetNode

_resolveRouteTargetNode(): GainNode
Resolve the node used by future playbacks for their primary output. Sources left on a subsequently destroyed bus fall back to master.

Returns GainNode
Inherited from RoutableSource._resolveRouteTargetNode
- Defined in src/routableSource.ts:93

`Protected`_wireRouteSends

_wireRouteSends(playback: BasePlayback): void
Establish every configured send on a newly created playback.
Parameters
- playback: BasePlayback
Returns void
Inherited from RoutableSource._wireRouteSends
- Defined in src/routableSource.ts:109

addEffect

addEffect(effect: CacophonyEffect): void
Parameters
- effect: CacophonyEffect
Returns void
Inherited from RoutableSource.addEffect
- Defined in src/routableSource.ts:32

addFilter

addFilter(filter: BiquadFilterNode): void
Adds a BiquadFilterNode to the filter chain.
Parameters
- filter: BiquadFilterNode
Returns void

Throws
If the same filter instance is added twice.
Implementation of BaseSound.addFilter

Inherited from RoutableSource.addFilter
- Defined in src/routableSource.ts:47

addFilters

addFilters(filters: BiquadFilterNode[]): void
Parameters
- filters: BiquadFilterNode[]
Returns void
Inherited from RoutableSource.addFilters
- Defined in src/filters.ts:42

attachPullSource

attachPullSource(
source: PcmStreamPullSource,
capabilities: StreamCapabilities,
): void
Parameters
- source: PcmStreamPullSource
- capabilities: StreamCapabilities
Returns void
- Defined in src/pcmStream.ts:268

cleanup

cleanup(): void
Returns void
Overrides RoutableSource.cleanup
- Defined in src/pcmStream.ts:420

end

end(): void
Returns void
- Defined in src/pcmStream.ts:324

fadeIn

fadeIn(duration: number, type?: FadeType): Promise<void>
Parameters
- duration: number
- Optionaltype: FadeType
Returns Promise<void>
Implementation of BaseSound.fadeIn

Inherited from RoutableSource.fadeIn
- Defined in src/container.ts:66

fadeOut

fadeOut(duration: number, type?: FadeType): Promise<void>
Parameters
- duration: number
- Optionaltype: FadeType
Returns Promise<void>
Implementation of BaseSound.fadeOut

Inherited from RoutableSource.fadeOut
- Defined in src/container.ts:67

fadeTo

fadeTo(value: number, duration: number, type?: FadeType): Promise<void>
Parameters
- value: number
- duration: number
- Optionaltype: FadeType
Returns Promise<void>
Implementation of BaseSound.fadeTo

Inherited from RoutableSource.fadeTo
- Defined in src/container.ts:65

handlePullError

handlePullError(error: unknown): void
Parameters
- error: unknown
Returns void
- Defined in src/pcmStream.ts:277

loop

loop(_loopCount?: LoopCount): LoopCount
Parameters
- Optional_loopCount: LoopCount
Returns LoopCount
- Defined in src/pcmStream.ts:410

off

off<K extends keyof PcmStreamEvents>(
event: K,
listener: (data: PcmStreamEvents[K]) => void,
): void
Type Parameters
- K extends keyof PcmStreamEvents
Parameters
- event: K
- listener: (data: PcmStreamEvents[K]) => void
Returns void
- Defined in src/pcmStream.ts:252

on

on<K extends keyof PcmStreamEvents>(
event: K,
listener: (data: PcmStreamEvents[K]) => void,
): () => void
Type Parameters
- K extends keyof PcmStreamEvents
Parameters
- event: K
- listener: (data: PcmStreamEvents[K]) => void
Returns () => void
- Defined in src/pcmStream.ts:248

pause

pause(): void
Returns void
Implementation of BaseSound.pause

Overrides RoutableSource.pause
- Defined in src/pcmStream.ts:372

play

play(options?: PlayOptions): PcmStreamPlayback[]
Parameters
- Optionaloptions: PlayOptions
Returns PcmStreamPlayback[]
Implementation of BaseSound.play

Overrides RoutableSource.play
- Defined in src/pcmStream.ts:359

preplay

preplay(): PcmStreamPlayback[]
Returns PcmStreamPlayback[]
Overrides RoutableSource.preplay
- Defined in src/pcmStream.ts:332

removeEffect

removeEffect(effect: CacophonyEffect): void
Parameters
- effect: CacophonyEffect
Returns void
Inherited from RoutableSource.removeEffect
- Defined in src/routableSource.ts:39

removeFilter

removeFilter(filter: BiquadFilterNode): void
Removes a BiquadFilterNode from the filter chain by object identity.
Parameters
- filter: BiquadFilterNode
Returns void

Throws
If the filter was never added to this container.
Implementation of BaseSound.removeFilter

Inherited from RoutableSource.removeFilter
- Defined in src/routableSource.ts:55

resume

resume(): void
Returns void
- Defined in src/pcmStream.ts:380

routeTo

routeTo(target: string | Bus, sendGain?: number): void
Route this source to a bus, or add an independent send when sendGain is provided.
Parameters
- target: string | Bus
- OptionalsendGain: number
Returns void
Inherited from RoutableSource.routeTo
- Defined in src/routableSource.ts:69

seek

seek(time: number): void
Parameters
- time: number
Returns void
Implementation of BaseSound.seek
- Defined in src/pcmStream.ts:403

stop

stop(): void
Returns void
Implementation of BaseSound.stop

Overrides RoutableSource.stop
- Defined in src/pcmStream.ts:388

stopWithFade

stopWithFade(duration: number, type?: FadeType): Promise<void>
Parameters
- duration: number
- Optionaltype: FadeType
Returns Promise<void>
Implementation of BaseSound.stopWithFade

Inherited from RoutableSource.stopWithFade
- Defined in src/container.ts:68

write

write(samples: Float32Array): boolean
Enqueue PCM at the context's sample rate.

Samples are interleaved according to channelCount. false means the fixed ring buffer is full (or this accepted write filled it); wait for drain before retrying a rejected chunk.
Parameters
- samples: Float32Array
Returns boolean
- Defined in src/pcmStream.ts:290

Class PcmStreamSound

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns PcmStreamSound

Properties

_filters

_position

Protected_routeTarget

Protected_sends

_stereoPan

_threeDOptions

_volume

Protectedcontext

ProtectedglobalGainNode

playbacks

OptionalsoundType

OptionalstreamCapabilities

Accessors

bufferedDuration

Returns number

cacophony

Returns Cacophony | undefined

filters

Returns BiquadFilterNode[]

inputChannelCount

Returns number

isPlaying

Returns boolean

playbackRate

Returns number

Parameters

Returns void

position

Returns Position

Parameters

Returns void

stereoPan

Returns number

Parameters

Returns void

threeDOptions

Returns ThreeDOptions

Parameters

Returns void

volume

Returns number

Parameters

Returns void

Methods

_onBusDrained

Parameters

Returns void

Protected_preparePlayback

Parameters

Returns void

_resolveRouteTargetNode

Returns GainNode

Protected_wireRouteSends

Parameters

Returns void

addEffect

Parameters

Returns void

addFilter

Parameters

Returns void

Throws

addFilters

Parameters

Returns void

attachPullSource

Parameters

`Protected`_routeTarget

`Protected`_sends

`Protected`context

`Protected`globalGainNode

`Optional`soundType

`Optional`streamCapabilities

`Protected`_preparePlayback

`Protected`_wireRouteSends