# sdl_audio_test_demo

**Repository Path**: fahati-champion-and-runner-up/sdl_audio_test

## Basic Information

- **Project Name**: sdl_audio_test_demo
- **Description**: 这是一个基于 SDL2 的音频测试项目，支持音频的录制、播放和保存。项目可以生成测试音频、录制麦克风输入，并将音频数据保存为 PCM 文件，同时支持直接播放录音和调用系统工具播放。适合音频开发、设备调试和 SDL2 学习参考。
- **Primary Language**: C++
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-06
- **Last Updated**: 2025-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目简介

这是一个基于 SDL2 的音频测试项目，支持音频的录制、播放和保存。项目可以生成测试音频、录制麦克风输入，并将音频数据保存为 PCM 文件，同时支持直接播放录音和调用系统工具播放。适合音频开发、设备调试和 SDL2 学习参考。

## 软件架构

- 使用 C++ 语言开发
- 基于 SDL2 库实现音频采集与播放
- 支持多线程安全的音频缓冲区操作
- 录音与播放参数可灵活配置（采样率、通道数、格式等）
- 录音数据保存为标准 PCM 文件，可用 aplay 等工具播放

## 安装教程

1. 安装 SDL2 开发库  
   Ubuntu/Debian 系统可执行：  
   ```bash
   sudo apt-get install libsdl2-dev
   ```
2. 克隆本项目代码  
   ```bash
   git clone git@gitee.com:fahati-champion-and-runner-up/sdl_audio_test.git
   cd test_sdl
   ```
3. 编译项目  
   ```bash
   ./build.sh
   ```

## 使用说明

1. 运行程序  
   ```bash
   ./test_sdl
   ```
2. 按照提示进行测试音频播放、录音、录音回放等操作
3. 录音文件会保存为 `recorded_audio.pcm`，可用如下命令播放：  
   ```bash
   aplay -f S16_LE -c 2 -r 44100 recorded_audio.pcm
   ```

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

欢迎提交 Issue 和 PR 共同完善项目！