Class SoundBuffer

constructor

• new SoundBuffer(
      source?: Readonly<
          Pick<
              SoundBuffer,
              | typeof audioHandle
              | "getSamples"
              | "getSampleCount"
              | "getSampleRate"
              | "getChannelCount"
              | "getChannelMap"
              | "getDuration"
              | "saveToFile",
          >,
      >,
  ): SoundBuffer

  创建空音频缓冲区，或深复制现有缓冲区。

  Parameters

  • Optionalsource: Readonly<
        Pick<
            SoundBuffer,
            | typeof audioHandle
            | "getSamples"
            | "getSampleCount"
            | "getSampleRate"
            | "getChannelCount"
            | "getChannelMap"
            | "getDuration"
            | "saveToFile",
        >,
    >

  Returns SoundBuffer
• new SoundBuffer(
      samples: Int16Array,
      channelCount: number,
      sampleRate: number,
      channelMap: Iterable<SoundChannel>,
  ): SoundBuffer

  复制交错 16 位 PCM；采样率以 Hz 计，channelMap 指定各声道位置。

  Parameters

  • samples: Int16Array
  • channelCount: number
  • sampleRate: number
  • channelMap: Iterable<SoundChannel>

  Returns SoundBuffer

Readonly[audioHandle]

assign

• assign(source: Readonly): this

  Copy the current source data synchronously, retaining this buffer's identity.

  Parameters

  • source: Readonly

  Returns this

getChannelCount

• getChannelCount(): number

  返回声道数量。

  Returns number

getChannelMap

• getChannelMap(): Readonly

  返回交错声道位置顺序的只读视图。

  Returns Readonly

getDuration

• getDuration(): Time

  返回音频总时长副本。

  Returns Time

getSampleCount

• getSampleCount(): bigint

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

  Returns bigint

getSampleRate

• getSampleRate(): number

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

  Returns number

getSamples

• getSamples(): | undefined
  | Readonly<
      Pick<
          Int16Array,
          | number
          | typeof iterator
          | "length"
          | "slice"
          | "entries"
          | "keys"
          | "values"
          | "byteLength"
          | "byteOffset",
      >,
  >

  返回 PCM 只读类型视图；空缓冲区为 undefined，重新加载后旧视图仍指向旧存储。

  Returns
      | undefined
      | Readonly<
          Pick<
              Int16Array,
              | number
              | typeof iterator
              | "length"
              | "slice"
              | "entries"
              | "keys"
              | "values"
              | "byteLength"
              | "byteOffset",
          >,
      >

loadFromFile

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

  异步解码整个音频文件到原生 PCM 存储，返回是否成功。

  Parameters

  • filename: string

  Returns Promise<boolean>

loadFromMemory

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

  异步解码编码音频字节并替换 PCM，返回是否成功。

  Parameters

  • data: Uint8Array

  Returns Promise<boolean>

loadFromSamples

• loadFromSamples(
      data: Int16Array,
      channelCount: number,
      sampleRate: number,
      channelMap: Iterable<SoundChannel>,
  ): boolean

  同步复制交错 16 位 PCM 并替换内容；sampleRate 为 Hz，返回是否成功。

  Parameters

  • data: Int16Array
  • channelCount: number
  • sampleRate: number
  • channelMap: Iterable<SoundChannel>

  Returns boolean

loadFromStream

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

  从输入流异步解码全部样本，返回是否成功；流异常会拒绝 Promise。

  Parameters

  • stream: InputStream

  Returns Promise<boolean>

saveToFile

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

  按文件扩展名异步编码保存，返回是否成功。

  Parameters

  • filename: string

  Returns Promise<boolean>