更新时间：2025-12-10 GMT+08:00
音频
音频内部处理使用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 | 将音频写入指定文件（自动推断格式）。 |
父主题：多模态数据类型
