更新时间:2025-12-10 GMT+08:00
分享

音频

音频内部处理使用soundfile库处理数据。支持的音频格式:mp3、aiff、flac、wav。音频对象的属性和方法如下所示:

表1 属性(Properties)

属性名

类型

说明

filename

str

音频文件的路径或文件名(如果从文件加载)。

format

str

音频格式(如WAV、MP3)。

data

bytes

音频数据。

sound_file

sf.SoundFile

动态属性:返回soundfile库的音频对象(自动从data解码或缓存)。

表2 方法(Methods)

方法名

参数

返回值

说明

__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

将音频写入指定文件(自动推断格式)。

相关文档