Class InputSoundFile

constructor

• new InputSoundFile(): InputSoundFile

  创建未打开数据源的解码器。

  Returns InputSoundFile

Readonly[audioHandle]

close

• close(): Promise<void>

  等待此前操作并异步关闭解码器、释放其持有的数据源。

  Returns Promise<void>

getChannelCount

• getChannelCount(): number

  返回声道数。

  Returns number

getChannelMap

• getChannelMap(): Readonly

  返回交错声道的位置映射。

  Returns Readonly

getDuration

• getDuration(): Time

  返回音频总时长。

  Returns Time

getSampleCount

• getSampleCount(): bigint

  返回所有声道合计的样本总数。

  Returns bigint

getSampleOffset

• getSampleOffset(): bigint

  返回当前样本偏移，包含所有交错声道。

  Returns bigint

getSampleRate

• getSampleRate(): number

  返回每声道采样率，单位为 Hz。

  Returns number

getTimeOffset

• getTimeOffset(): Time

  返回当前解码位置对应的时间。

  Returns Time

openFromFile

• openFromFile(filename: string): Promise<boolean>

  异步打开音频文件并读取格式信息，返回是否成功。

  Parameters

  • filename: string

  Returns Promise<boolean>

openFromMemory

• openFromMemory(data: Uint8Array): Promise<boolean>

  异步打开编码音频字节，返回是否成功。

  Parameters

  • data: Uint8Array

  Returns Promise<boolean>

openFromStream

• openFromStream(stream: InputStream): Promise<boolean>

  异步打开可寻址流，读取期间保留数据源引用。

  Parameters

  • stream: InputStream

  Returns Promise<boolean>

read

• read(data: Int16Array): Promise<bigint>

  异步解码到 data，返回实际写入的样本数；末尾返回 0n，完成前勿修改缓冲区。

  Parameters

  • data: Int16Array

  Returns Promise<bigint>

seek

• seek(offset: bigint | ReadonlyValue<Time>): Promise<void>

  异步跳转到样本偏移（bigint，包含所有声道）或时间偏移（Time）。

  Parameters

  • offset: bigint | ReadonlyValue<Time>

  Returns Promise<void>