SoundBuffer

constructor

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

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

  参数

  source可选

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

  返回值

  SoundBuffer

  源码与继承
• new SoundBuffer(
      samples: Int16Array,
      channelCount: number,
      sampleRate: number,
      channelMap: Iterable<SoundChannel>,
  ): SoundBuffer

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

  参数

  samples

  Int16Array

  channelCount

  number

  sampleRate

  number

  channelMap

  Iterable<SoundChannel>

  返回值

  SoundBuffer

  源码与继承

assign

• assign(source: Readonly): this

  同步复制源缓冲区的当前数据，保留当前缓冲区的身份。

  参数

  source

  Readonly

  返回值

  this

  源码与继承

getChannelCount

• getChannelCount(): number

  返回声道数量。

  返回值

  number

  源码与继承

getChannelMap

• getChannelMap(): Readonly

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

  返回值

  Readonly

  源码与继承

getDuration

• getDuration(): Time

  返回音频总时长副本。

  返回值

  Time

  源码与继承

getSampleCount

• getSampleCount(): bigint

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

  返回值

  bigint

  源码与继承

getSampleRate

• getSampleRate(): number

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

  返回值

  number

  源码与继承

getSamples

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

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

  返回值

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

  源码与继承

loadFromFile

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

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

  参数

  filename

  string

  返回值

  Promise<boolean>

  源码与继承

loadFromMemory

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

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

  参数

  data

  Uint8Array

  返回值

  Promise<boolean>

  源码与继承

loadFromSamples

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

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

  参数

  data

  Int16Array

  channelCount

  number

  sampleRate

  number

  channelMap

  Iterable<SoundChannel>

  返回值

  boolean

  源码与继承

loadFromStream

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

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

  参数

  stream

  InputStream

  返回值

  Promise<boolean>

  源码与继承

saveToFile

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

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

  参数

  filename

  string

  返回值

  Promise<boolean>

  源码与继承

只读[audioHandle]