torchaudio¶

I/O¶

torchaudio 顶层模块提供了以下功能，可以轻松处理音频数据。

解码和编码媒体是一个高度复杂的过程。因此，TorchAudio 依赖于第三方库来执行这些操作。这些第三方库被称为 backend，目前 TorchAudio 集成了以下库。

请参阅安装了解如何启用后端。

传统上，TorchAudio 的 I/O 后端在运行时根据可用性全局设置。但是，这种方法不允许应用程序使用不同的后端，并且不适合大型代码库。

由于这些原因，在 v2.0 中，我们引入了一个调度器，这是一种允许用户为每个函数调用选择后端的新机制。

启用调度器模式后，所有 I/O 函数都接受额外的关键字参数 backend，用于指定所需的后端。如果指定的后端不可用，函数调用将失败。

如果未显式选择后端，则函数将根据优先级顺序和库可用性选择要使用的后端。

下表总结了后端。

优先级

后端

支持的操作系统

注意

1

FFmpeg

Linux, macOS, Windows

使用 get_audio_decoders() 和 get_audio_encoders() 来检索支持的编解码器。

此后端支持各种协议，例如 HTTPS 和 MP4，以及类文件对象。

2

SoX

Linux, macOS

使用 list_read_formats() 和 list_write_formats() 来检索支持的编解码器。

此后端不支持类文件对象。

3

SoundFile

Linux, macOS, Windows

请参阅官方文档了解支持的编解码器。

此后端支持类文件对象。

我们正在迁移 I/O 函数以使用调度器机制，这会引起多项更改，其中一些更改涉及向后不兼容的更改，并要求用户更改其函数调用。

（计划的）更改如下。有关最新信息，请参阅 https://github.com/pytorch/audio/issues/2950

在 2.0 中，引入了音频 I/O 后端调度器。用户可以通过设置环境变量 TORCHAUDIO_USE_BACKEND_DISPATCHER=1 来选择使用调度器。
在 2.1 中，调度器成为 I/O 的默认机制。
在 2.2 中，旧的全局后端机制被移除。实用程序函数 get_audio_backend() 和 set_audio_backend() 变为 no-op。

此外，我们从 libsox 后端移除了类文件对象支持，因为 FFmpeg 后端更好地支持这一点，并且使构建过程更简单。因此，从 2.1 开始，FFmpeg 和 Soundfile 是唯一支持类文件对象的后端。