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() 变为无操作。

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