# 音频
音频内部处理使用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    | 将音频写入指定文件（自动推断格式）。                                   |