npm 包 pizzicato 使用教程

在前端开发过程中，音频处理是一个重要的领域。pizzicato 是一个 JavaScript 库，提供了一系列的音频特效和音频处理功能。本文将介绍如何使用 pizzicato 在 Web 应用中进行音频处理。

安装

可以通过 npm 进行安装：

npm install pizzicato --save

也可以直接在 HTML 中引入：

<script src="https://cdn.jsdelivr.net/npm/pizzicato"></script>

创建音频实例

在使用 pizzicato 之前，需要先创建一个音频实例。

const audio = new Pizzicato.Sound({
    source: 'file',
    options: { path: './audio.mp3' }
});

Pizzicato.Sound 构造函数接收一个对象作为参数，其中 source 指定音频来源，可以是文件、 URL 或者数据流等；options 是一个对象，包含其他的配置选项。

音频特效

延迟特效

延迟特效是一种常见的音频效果，可以让声音产生回音效果。

const delay = new Pizzicato.Effects.Delay({
    feedback: 0.6,
    time: 0.4,
    mix: 0.5
});

audio.addEffect(delay);

在上面的代码中，我们创建了一个名为 delay 的延迟特效，并将其添加到音频实例中。feedback 参数控制回音的强度，time 参数控制回音的延迟时间，mix 参数控制原始声音和回音的比例。

噪声特效

噪声特效可以添加白噪声或者粉噪声到音频中。

const noise = new Pizzicato.Effects.Noise({
    type: 'white',
    mix: 0.2
});

audio.addEffect(noise);

在上面的代码中，我们创建了一个名为 noise 的噪声特效，并将其添加到音频实例中。type 参数指定噪声类型，可以是白噪声或者粉噪声等；mix 参数控制原始声音和噪声的比例。

滤波器特效

滤波器特效可以对音频进行滤波处理，包括低通滤波器、高通滤波器、带通滤波器等。

const filter = new Pizzicato.Effects.Filter({
    frequency: 800,
    peak: 10,
    type: 'lowpass',
    mix: 0.5
});

audio.addEffect(filter);

在上面的代码中，我们创建了一个名为 filter 的滤波器特效，并将其添加到音频实例中。frequency 参数控制滤波器的截止频率，peak 参数控制滤波器的增益，type 参数指定滤波器的类型，可以是低通滤波器、高通滤波器或者带通滤波器等；mix 参数控制原始声音和滤波后的声音的比例。

播放和暂停音频

audio.play();
audio.pause();

使用 play 方法可以播放音频，使用 pause 方法可以暂停音频。

示例代码

下面是一个完整的示例代码，演示如何使用 pizzicato 创建音频实例并添加特效：

-- -------------------- ---- -------
------
------
    ------- ------------------------------------------------------
-------

------
    ------- ----------------------------
    ------- ----------------------------

    --------
        ----- ----- - --- -----------------
            ------- -------

- ----------------------------------------------------------- --------
----------------------------------------------------------------------------------