# `audio`_音频(`import audio`)
`audio`抽象的音频对象,该对象可以被当做参数传入也可以直接使用其方法来播放音频
*****
## **构造函数:**
* [ ] **构造音频对象**
```
class audio.Audio(array=None, path=None, points=1024)
```
> 该接口能传入一个参数,每个参数会决定不同的音频类型
*参数:*
* `array`:`bytearray`类型的数据,可以将该数据转换为音频对象, 默认`None`
* `path`: 打开的音频文件路径,目前仅支持`wav`格式, 默认`None`,例如:`audio.Audio(path = "/sd/1.wav")`
* `points`: 开辟有 points 个采样点数的音频缓冲,一个采样点大小为 32bit。为0的情况下将不开辟缓冲, 默认`1024`
*返回:*
* 返回一个`Audio`对象
*****
## **方法:**
* [ ] **播放预处理**
```
.play_process(i2s_dev)
```
> 用于预处理音频对象,在播放之前需要对音频文件进行解析,所以需要预处理。这里需要传入一个播放用的 I2S 设备
*参数:*
* `i2s_dev`: 用于播放的i2s设备
*返回:*
* 该 wav 文件的头部信息 ,`list`类型,分别是`numchannels`,`samplerate`,`byterate`,`blockalign`,`bitspersample`,`datasize`
*****
* [ ] **播放音频**
```
.play()
```
> 读取音频文件并且解析播放,一般配合循环来使用
*参数:*
* 无
*返回:*
* `None`: 格式不支持播放
* `0`: 播放结束
* `1`: 正在播放
*****
* [ ] **音频后处理**
```
. finish()
```
> 完成音频播放,该函数必须在播放完毕后调用,回收底层分配的资源
*参数:*
* 无
*返回:*
* `None`
*****
- 简介
- 关于MixPY
- 准备
- MixPY_函数库
- MicroPython标准库
- gc _控制垃圾回收器
- math_数学函数
- sys_系统相关函数
- ubinascii _ 二进制/ ASCII转换
- ucollections_集合和容器类型
- uerrno _系统错误代码
- uheapq_ 堆队列算法
- ujson_JSON编码与解码
- uos _基本的“操作系统”服务
- ure_正则表达式
- MixPY_特定函数
- lcd_显示驱动
- lcd_范例
- sensor_感光元件
- sensor_范例
- image_机器视觉
- image_函数
- HaarCascade 类_特征描述符
- Similarity 类_相似度对象
- Histogram 类_直方图对象
- Percentile 类_百分比值对象
- Threhsold 类_阈值对象
- Statistics 类_统计数据对象
- Blob 类_色块对象
- Line 类_直线对象
- Circle 类_圆形对象
- Rect 类_矩形对象
- QRCode 类_ 二维码对象
- AprilTag 类_AprilTag对象
- DataMatrix 类_数据矩阵对象
- BarCode 类_条形码对象
- Displacement 类_位移对象
- Kptmatch 类_特征点对象
- ImageWriter 类_ImageWriter对象
- ImageReader 类_ImageReader对象
- Image 类_图像对象
- touchscreen_触摸屏幕
- touchscreen_范例
- video_视频
- video_范例
- audio_音频
- audio_范例
- nes_游戏模拟器
- nes_范例
- machine_板级功能
- I2C_总线协议
- I2C_范例
- PWM_脉宽调制
- PWM_范例
- SPI_同步串行协议
- SPI_范例
- Timer_硬件定时器
- Timer_范例
- UART_异步串口
- UART_范例
- network_网卡驱动
- network_范例
- Maix_功能库
- FPIOA_可编程 IO 阵列
- FPIOA_范例
- GPIO_通用输入/输出
- GPIO_范例
- I2S_驱动I2S设备
- I2S_范例
- freq_频率模块
- freq_范例
- FFT_傅里叶运算
- FFT_范例
- KPU_神经网络处理器
- KPU_范例