# AudioCheck

**Repository Path**: LRTesthhh/audio-demo

## Basic Information

- **Project Name**: AudioCheck
- **Description**: 本项目是一个基于 Java 的音频处理应用，主要用于音频文件的上传、处理及检测，支持音频格式转换、音频切割、伪造音频检测等功能。项目使用 Spring Boot 框架构建，包含 WebSocket 实时通信功能，可用于处理音频任务并实时反馈处理进度。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-29
- **Last Updated**: 2025-08-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Audio Demo 项目文档

## 项目简介

本项目是一个基于 Java 的音频处理应用，主要用于音频文件的上传、处理及检测，支持音频格式转换、音频切割、伪造音频检测等功能。项目使用 Spring Boot 框架构建，包含 WebSocket 实时通信功能，可用于处理音频任务并实时反馈处理进度。

## 功能特点

- **音频处理：** 支持音频文件的格式转换、切割、拼接等操作。
- **伪造音频检测：** 利用算法检测音频是否经过伪造处理。
- **WebSocket 实时通信：** 实时反馈音频处理进度。
- **用户登录系统：** 提供用户登录与权限控制功能。
- **任务处理系统：** 提交音频处理任务，并查看处理日志。

## 安装步骤

1. 确保已安装 JDK 17 或以上版本。
2. 安装 Maven 并配置环境变量。
3. 克隆项目到本地：

   ```bash
   git clone https://gitee.com/LRTesthhh/audio-demo.git
   ```

4. 进入项目目录并启动：

   ```bash
   cd audio-demo
   mvn spring-boot:run
   ```

   或者使用 IDE（如 IntelliJ IDEA）直接运行 `AudioDemoApplication.java`。

## 使用说明

### 接口文档

详见项目中的 `HELP.md` 文件，包含接口说明和使用指南。

### 上传音频并处理

使用 `/audio/task` 接口上传音频文件并指定处理参数，例如：

- 指定音频处理算法（CQCC / EZCS）
- 设置阈值、帧长、帧移等参数
- 附加注释信息

处理进度将通过 WebSocket 实时推送。

### 用户登录

通过 `/user/login` 接口进行用户登录，获取 JWT Token，后续请求需携带该 Token 进行身份验证。

### 查看日志

通过 `/audio/log` 接口查看所有音频处理任务的日志记录。

## 技术栈

- Java 17
- Spring Boot
- Maven
- WebSocket
- JWT（用于身份验证）
- Lombok
- MyBatis
- MySQL（如适用）

## 目录结构说明

- `src/main/java`: 核心代码目录，包含控制器、服务、配置、工具类等。
- `src/main/resources`: 配置文件、静态资源、XML 映射文件等。
- `static`: 包含测试用的音频模板文件。
- `temp`: 音频处理过程中产生的临时文件。
- `localAudio`: 本地音频文件目录。

## 第三方工具

- `ForgedDetection.jar`: 用于音频伪造检测的工具。
- `javabuilder.jar`: 用于构建音频相关的工具。

## 项目结构示意图

```
audio-demo
├── src
│   ├── main
│   │   ├── java
│   │   │   ├── com.audio
│   │   │   │   ├── controller       // 控制器类
│   │   │   │   ├── service          // 业务逻辑类
│   │   │   │   ├── mapper           // 数据库映射
│   │   │   │   ├── config           // Spring Boot 配置
│   │   │   │   ├── utils            // 工具类
│   │   │   │   ├── websocket        // WebSocket 实现
│   │   │   │   ├── properties        // 配置属性类
│   │   │   │   ├── constant          // 常量类
│   │   │   │   └── pojo            // 数据模型类（DTO/VO/Entity）
│   │   │   └── AudioDemoApplication.java
│   │   └── resources
│   │       ├── application.yml      // 主配置文件
│   │       ├── static               // 静态资源目录
│   │       └── mapper               // MyBatis 映射文件
│   └── test
│       └── java
│           └── com.audio
│               ├── AudioSplitter.java         // 音频切割测试
│               ├── AudioConcatenation.java    // 音频拼接测试
│               ├── AudioFormatConverter.java  // 音频格式转换测试
│               └── Test.java                  // 其他测试类
├── localAudio                     // 本地音频文件
├── temp                           // 音频处理临时文件
└── pom.xml                        // Maven 项目配置文件
```

## 许可证

本项目采用 MIT 许可证。详情请参见 LICENSE 文件。