StreamingMp3Source

Audio source that supplies PCM samples on demand.

Implements

• AudioSource

Properties

Property	Modifier	Type	Description
channelCount	readonly	number	Number of audio channels.
duration	public	number	Total duration in seconds.
id	readonly	string	Stable identifier for caching computed STFT frames.
sampleRate	readonly	number	Sample rate in Hz.

Methods

onRangeAvailable()

onRangeAvailable(handler: (range: AudioRange) => void): () => void;

Subscribes to progressive loading updates as new byte ranges arrive.

Parameters

Parameter	Type	Description
handler	(range: AudioRange) => void	Callback receiving the newly available time range in seconds.

Returns

Unsubscribe function.

() => void

Implementation of

AudioSource.onRangeAvailable

---

read()

read(options: object):
  | Float32Array<ArrayBufferLike>
| Promise<Float32Array<ArrayBufferLike>>;

Reads PCM samples for a specific channel and time range.

Parameters

Parameter	Type	Description
options	{ channel: number; endTime: number; startTime: number; }	Channel index and time span in seconds.
options.channel	number	-
options.endTime	number	-
options.startTime	number	-

Returns

| Float32Array<ArrayBufferLike> | Promise<Float32Array<ArrayBufferLike>>

Float32Array of normalized audio samples.

Implementation of

AudioSource.read

---

fromByteSource()

static fromByteSource(byteSource: ByteStreamSource, options?: object): Promise<StreamingMp3Source>;

Parameters

Parameter	Type
byteSource	ByteStreamSource
options?	{ decoderFactory?: Mp3DecoderFactory; id?: string; }
options.decoderFactory?	Mp3DecoderFactory
options.id?	string

Returns

Promise<StreamingMp3Source>

---

fromReader()

static fromReader(
   reader: ReadableStreamDefaultReader<Uint8Array<ArrayBufferLike>>,
   initialChunks?: Uint8Array<ArrayBufferLike>[],
   totalBytes?: number,
options?: object): Promise<StreamingMp3Source>;

Parameters

Parameter	Type	Default value
reader	ReadableStreamDefaultReader<Uint8Array<ArrayBufferLike>>	undefined
initialChunks	Uint8Array<ArrayBufferLike>[]	[]
totalBytes?	number	undefined
options?	{ decoderFactory?: Mp3DecoderFactory; id?: string; }	undefined
options.decoderFactory?	Mp3DecoderFactory	undefined
options.id?	string	undefined

Returns

Promise<StreamingMp3Source>

---

isSupported()

static isSupported(): Promise<boolean>;

Returns

Promise<boolean>