AudioEffector

class torchaudio.io.AudioEffector(effect: Optional[str] = None, format: Optional[str] = None, *, encoder: Optional[str] = None, codec_config: Optional[CodecConfig] = None, pad_end: bool = True)

将各种滤波器和/或编解码器应用于波形。

2.1 版本新增。

参数:

• effect (str 或 None, 可选) – 滤波器表达式或 None 以应用无滤波器。 有关滤波器语法的详细信息，请参阅 https://ffmpeg.cpp.org.cn/ffmpeg-filters.html#Audio-Filters。

• format (str 或 None, 可选) – 如果提供，则将音频编码为相应的格式。 默认值：None。

• encoder (str 或 None, 可选) – 如果提供，则覆盖 format 使用的编码器。 默认值：None。

• codec_config (CodecConfig 或 None, 可选) – 如果提供，则配置编码编解码器。 应与 format 选项结合使用。

• pad_end (bool, 可选) – 启用后，如果波形在应用效果/编解码器后变短，则在末尾填充静音。

示例 - 基本用法

要使用 AudioEffector，首先使用一组 effect 和 format 实例化它。

>>> # instantiate the effector
>>> effector = AudioEffector(effect=..., format=...)

然后，使用 apply() 或 stream() 方法来应用它们。

>>> # Apply the effect to the whole waveform
>>> applied = effector.apply(waveform, sample_rate)

>>> # Apply the effect chunk-by-chunk
>>> for chunk in effector.stream(waveform, sample_rate):
>>>    ...

示例 - 应用效果

有关滤波器描述的概述，请参阅 https://ffmpeg.cpp.org.cn/ffmpeg-filters.html#Filtergraph-description，有关可用滤波器的列表，请参阅 https://ffmpeg.cpp.org.cn/ffmpeg-filters.html#toc-Audio-Filters。

Tempo - https://ffmpeg.cpp.org.cn/ffmpeg-filters.html#atempo

>>> AudioEffector(effect="atempo=1.5")

Echo - https://ffmpeg.cpp.org.cn/ffmpeg-filters.html#aecho

>>> AudioEffector(effect="aecho=0.8:0.88:60:0.4")

Flanger - https://ffmpeg.cpp.org.cn/ffmpeg-filters.html#flanger

>>> AudioEffector(effect="aflanger")

Vibrato - https://ffmpeg.cpp.org.cn/ffmpeg-filters.html#vibrato

>>> AudioEffector(effect="vibrato")

Tremolo - https://ffmpeg.cpp.org.cn/ffmpeg-filters.html#tremolo

>>> AudioEffector(effect="vibrato")

您也可以一次应用多种效果。

>>> AudioEffector(effect="")

示例 - 应用编解码器

可以使用 format 参数应用编解码器。 format 可以是音频格式或容器格式。 如果容器格式支持多种编码器，则可以使用 encoder 参数指定它。

Wav 格式（不应用压缩，但样本将转换为 16 位有符号整数）

>>> AudioEffector(format="wav")

带有默认编码器的 Ogg 格式

>>> AudioEffector(format="ogg")

带有 vorbis 的 Ogg 格式

>>> AudioEffector(format="ogg", encoder="vorbis")

带有 opus 的 Ogg 格式

>>> AudioEffector(format="ogg", encoder="opus")

带有 opus 的 Webm 格式

>>> AudioEffector(format="webm", encoder="opus")

示例 - 应用带有配置的编解码器

参考：https://trac.ffmpeg.org/wiki/Encode/MP3

具有默认配置的 MP3

>>> AudioEffector(format="mp3")

具有可变比特率的 MP3

>>> AudioEffector(format="mp3", codec_config=CodecConfig(qscale=5))

具有恒定比特率的 MP3

>>> AudioEffector(format="mp3", codec_config=CodecConfig(bit_rate=32_000))

使用 AudioEffector 的教程

AudioEffector 用法

AudioEffector 用法

音频数据增强

音频数据增强

方法

apply

AudioEffector.apply(waveform: Tensor, sample_rate: int, output_sample_rate: Optional[int] = None) → Tensor

将效果和/或编解码器应用于整个张量。

参数:

• waveform (Tensor) – 输入波形。 形状：(time, channel)

• sample_rate (int) – 输入波形的采样率。

• output_sample_rate (int 或 None, 可选) – 输出采样率。 如果提供，则覆盖输出采样率。 否则，结果张量将被重采样为与输入具有相同的采样率。 默认值：None。

返回:

结果张量。 形状：(time, channel)。 帧数可能与输入的不同。

返回类型:

Tensor

stream

AudioEffector.stream(waveform: Tensor, sample_rate: int, frames_per_chunk: int, output_sample_rate: Optional[int] = None) → Iterator[Tensor]

逐块将效果和/或编解码器应用于给定的张量。

参数:

• waveform (Tensor) – 输入波形。 形状：(time, channel)

• sample_rate (int) – 波形的采样率。

• frames_per_chunk (int) – 每次返回的帧数。

• output_sample_rate (int 或 None, 可选) – 输出采样率。 如果提供，则覆盖输出采样率。 否则，结果张量将被重采样为与输入具有相同的采样率。 默认值：None。

返回:

系列处理后的块。 形状：(time, channel)，其中帧数与 frames_per_chunk 匹配，但最后一个块可能较短。

返回类型:

Iterator[Tensor]