Class AudioClip

音频素材，为创建、编辑音视频功能提供音频数据

Example

new AudioClip((await fetch('<mp3 url>')).body, {
  loop: true,
}),

Implements

Constructors

constructor

Properties

#chan0Buf #chan1Buf #frameOffset #meta #opts #ts ready tickInterceptor concatAudioClip ctx

Accessors

meta

Methods

#init clone destroy getPCMData split tick

Constructors

constructor

  • new AudioClip(dataSource, opts?): AudioClip

  • Parameters

    • dataSource: ReadableStream<Uint8Array<ArrayBufferLike>> | Float32Array<ArrayBufferLike>[]

      音频文件流

    • opts: IAudioClipOpts = {}

      音频配置，控制音量、是否循环

    Returns AudioClip

Properties

Private #chan0Buf

#chan0Buf: Float32Array<ArrayBufferLike> = ...

Private #chan1Buf

#chan1Buf: Float32Array<ArrayBufferLike> = ...

Private #frameOffset

#frameOffset: number = 0

Private #meta

#meta: {
    duration: number;
    height: number;
    width: number;
} = ...

Type declaration

  • duration: number
  • height: number
  • width: number

Private #opts

#opts: {
    loop: boolean;
    volume: number;
}

Type declaration

  • loop: boolean
  • volume: number

Private #ts

#ts: number = 0

ready

ready: Promise<IClipMeta>

当素材准备完成，ready 会切换到 resolved 状态

tickInterceptor

tickInterceptor: (<T>(time, tickRet) => Promise<T>) = ...

拦截 AudioClip.tick 方法返回的数据，用于对音频数据二次处理

Type declaration

    • <T>(time, tickRet): Promise<T>

    • Type Parameters

      • T extends {
            audio: Float32Array<ArrayBufferLike>[];
            state: "success" | "done";
        }

      Parameters

      • time: number

        调用 tick 的时间

      • tickRet: T

        tick 返回的数据

      Returns Promise<T>

See

移除视频绿幕背景

Static concatAudioClip

concatAudioClip: ((clips, opts?) => Promise<AudioClip>) = concatAudioClip

Type declaration

    • (clips, opts?): Promise<AudioClip>

    • 拼接多个 AudioClip

      Parameters

      • clips: AudioClip[]
      • Optional opts: IAudioClipOpts

      Returns Promise<AudioClip>

Static ctx

ctx: null | AudioContext = null

Accessors

meta

  • get meta(): {
        chanCount: number;
        duration: number;
        height: number;
        sampleRate: 48000;
        width: number;
    }

  • 音频元信息

    ⚠️ 注意，这里是转换后（标准化）的元信息，非原始音频元信息

    Returns {
        chanCount: number;
        duration: number;
        height: number;
        sampleRate: 48000;
        width: number;
    }

    • chanCount: number
    • duration: number
    • height: number
    • sampleRate: 48000
    • width: number

Methods

Private #init

  • #init(dataSource): Promise<void>

  • Parameters

    • dataSource: ReadableStream<Uint8Array<ArrayBufferLike>> | Float32Array<ArrayBufferLike>[]

    Returns Promise<void>

clone

destroy

getPCMData

split

tick

  • tick(time): Promise<{
        audio: Float32Array<ArrayBufferLike>[];
        state: "success" | "done";
    }>

  • 返回上次与当前时刻差对应的音频 PCM 数据；

    若差值超过 3s 或当前时间小于上次时间，则重置状态

    Parameters

    • time: number

    Returns Promise<{
        audio: Float32Array<ArrayBufferLike>[];
        state: "success" | "done";
    }>

    Example

    tick(0) // => []
    tick(1e6) // => [leftChanPCM(1s), rightChanPCM(1s)]

Settings

Member Visibility

Theme

On This Page

constructor#chan0Buf#chan1Buf#frameOffset#meta#opts#tsreadytickInterceptorconcatAudioClipctxmeta#initclonedestroygetPCMDatasplittick