音频
音频内部处理使用soundfile库处理数据。支持的音频格式:mp3、aiff、flac、wav。音频对象的属性和方法如下所示:
| 属性名 | 类型 | 说明 |
|---|---|---|
| filename | str | 音频文件的路径或文件名(如果从文件加载)。 |
| format | str | 音频格式(如WAV、MP3)。 |
| data | bytes | 音频数据。 |
| sound_file | sf.SoundFile | 动态属性:返回soundfile库的音频对象(自动从data解码或缓存)。 |
| 方法名 | 参数 | 返回值 | 说明 |
|---|---|---|---|
| __init__ | filename: Union[str, os.PathLike] = None data: Union[str, bytes, sf.SoundFile] = None | None | 构造方法:从文件(filename)或数据(data)加载音频,支持二进制数据或soundfile对象。 |
| truncate | start_time: float = 0 end_time: Optional[float] = None | Audio | 截取音频片段(时间单位为秒),返回新Audio对象。 |
| convert_format | format: str subtype: Optional[str] = None | Audio | 转换音频格式(如WAV转MP3),返回新Audio对象。 |
| write | filename: str | None | 将音频写入指定文件(自动推断格式)。 |