> For the complete documentation index, see [llms.txt](https://docs.lmms.io/user-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lmms.io/user-manual/jian-ti-zhong-wen/yue-qi-cha-jian/audiofileprocessor.md).

# AudioFileProcessor

AudioFileProcessor（直译为”音频文件处理器“）插件用于 **播放采样** 。它支持以下音频格式：.wav、.ogg（Ogg Vorbis）、.ds（[DrumSynth](https://sourceforge.net/projects/drumsynth/) 文件）、.flac、.spx（Speex）、.voc、.aif、.aiff、.au（Audacity BlockFile）、.raw。

<figure><img src="/files/LsPJ7Ia0GF8zwjXYsnlG" alt=""><figcaption><p>AudioFileProcessor</p></figcaption></figure>

当弹奏不同琴键时，它会通过加快或减慢采样的速度来改变采样的频率，从而以不同的音高播放采样，当然，这也会改变采样的长度及其声音特征，使得声音在更高的音高更”快“（反之同理）。所以使用 AudioFileProcessor 来处理传统乐器的单音采样时，如果弹奏太高（或太低）的音符可能会得到不大理想的效果。\
基音（basenote）定义了播放采样正常声音的琴键。默认情况下，这个琴键是 A4，也就是说弹奏 A4 键就是播放原始采样。你可以通过左右拖动（或直接点击移动）琴键上方的小白块来更改基音。

来看一下 AudioFileProcessor 的控件。

* 你可以使用 **插值模式** 下拉框来选择采样的插值方式，支持 不插值（None）、线性插值（Linear）和辛格插值（Sinc）。

{% hint style="info" %}
如果设置插值模式为不插值（None），可能导致采样率低的采样发出奇怪的声音（尤其是以较低的音高弹奏时），所以我们不推荐你选这个不插值。如果你使用非常高的基音，选择插值可能更好。而不插值反而更适用于噪声打击乐器上，因为它能产生更尖锐的噪声。
{% endhint %}

* 文件夹图标（📂）用于打开要载入的采样文件。你也可以通过把 LMMS 侧边栏的采样文件直接拖到乐器窗口（须保持在插件〔PLUGIN〕选项卡中）来载入采样。
* 响度（Amplify）旋钮（图标是一个宽直角三角形）用于更改采样音频的播放音量，以原有音量的百分比表示。100% 为原有音量，0% 表示静音，200% 表示原有音量的两倍。拉到 100% 以下会降低音量，但这不会修复采样中的削波。
* **起始点**（Startpoint）旋钮（“|←”，图标是一个到顶的左箭头）和 **终止点**（Endpoint）旋钮（“→|”，图标是一个到顶的右箭头）用于限定采样只播放哪个区间，采样预览中有两个突出的竖线，以此方便你直观地编辑采样区间。这两条竖线默认放在采样的最两端。
* **循环点**（Loopback point）旋钮（►|◄，图标是两个指向中心竖线的小三角）用于设置循环区间。在采样预览中表现为一根更淡的竖线，它只能介于两条突出线之间。在循环播放时，采样将只在循环点到终止点之间循环。循环点默认与起始点重合。
* **倒放**（Reverse sample）按钮（图标是一个反 R）决定了采样播放的**方向**（即是否倒放）。当此按钮亮起时，采样将反着播放。
* **跨音符播放**（Continue sample playback across notes）按钮（在倒放音频按钮下面，图标是两个水平矩形，上面画了个小三角指针），点亮后，采样可以以一种“卡顿推进”的感觉进行播放。当你启用这个按钮，每次弹奏，采样总会从它上一次结束的地方继续播放。这个按钮默认是关闭的，也就是说每次弹奏新的音符，采样都是从起始点开始播放。在启用本按钮的情况下，你可以通过在钢琴窗里插一个非常低的音符（比如 D0 及以下），如果你中途没有改变基音，那么播放位置将回到起始点。当然了，如果你不想这样，也可以使用自动化来控制这个按钮关闭再打开，以此让播放位置回到采样的起始点。<br>

{% hint style="info" %}
如果你弹奏了一个比基音低超过 53 个半音（加 51 音分）的音符，会触发采样的重新开始播放。举个例子，如果你使用 AudioFileProcessor 且保持基音默认为 A4，那么任何低于 E0（不包括 E0）的音符就不是让采样从上次断掉的地方继续播放了，而是会在该音符之后回到起始点。而这个很低的音符不会发出任何声音。

如果你的乐器本身 detune 被降低了 52 音分或更多，那么 E0 本身也就是比基音低超过 53 个半音再低 51 音分的音符了，所以也不会发出任何声音，而会像上述一样触发这种“重置播放位置”的功能。

题外话，这些音符行为只会在这种”重置播放位置“的模式下出现，所以如果你发现 AudioFileProcessor 中的低音符**没有发出**预期的**声音**时，请检查是不是误开了跨音符播放模式。

出现这种情况的原因是：在假设基准音为标准的 A4（440 Hz）的前提下，低于 E0 再减去 51 音分的频率会低于 20 Hz，从而超出人类听觉的理论范围。当然，这只是一个假设；如果用户调整了基准音（无论升高还是降低），很可能是因为采样本身的音高并不正好是 A4。在这些情况下，当基准音较高时，一些本来合理但相对较低的音符可能会变得无法播放；而当基准音低于预期时，也可能更容易触发这种重置卡顿模式。
{% endhint %}

接下来看看右边那组按钮。这组按钮决定了采样的 **循环控制** 。你在同一时间只能点亮这三个按钮中的一个。

* **禁用循环（Disable loop）**\
  即上部分图标为电源开关符号的按钮，它表示禁用循环。
* **启用循环（Enable loop）**\
  即左下部分图标为闭合循环曲线箭头的按钮，它表示当音符持续按下时让采样以循环点为起始，到终止点之间重复播放。这么说，如果循环点和起始点重合，那就相当于采样整体不断循环，直到音符松开。
* **启用乒乓循环（Enable ping-pong loop）**\
  即右下部分图标为垂直分成两半的对称三角形（◿◺）的按钮，它表示在循环点和终止点之间来回播放。\
  也就是说，如果一直不松开音符，那么采样会首先正常播放，到达终止点后，在那里它会向后倒放，直到回到循环点——如此往复。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lmms.io/user-manual/jian-ti-zhong-wen/yue-qi-cha-jian/audiofileprocessor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.