# AI智能教练系统

**Repository Path**: ezdata/ai-intelligent-coaching-system

## Basic Information

- **Project Name**: AI智能教练系统
- **Description**: 这是一套智能教练系统，可用于【武术、舞蹈、瑜伽训练】场景的自助或在线辅助教学。
通过手机端APP计算机视觉、语音控制等技术和可视化提示手段，快速帮助用户完成标准的动作，同时辅助教师更高质量的完成教学任务。
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-10-02
- **Last Updated**: 2025-10-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI智能教练系统

#### 介绍
这是一套智能教练系统，可用于【武术、舞蹈、瑜伽训练】场景的自助或在线辅助教学。
通过手机端APP计算机视觉、语音控制等技术和可视化提示手段，快速帮助用户完成标准的动作，同时辅助教师更高质量的完成教学任务。

- 场景一、课堂上，学员按指示打开APP，进行自主的动作矫正，同时减轻教师不必要的工作量；
- 场景二、课后，学员自主练习正确的动作；
- 场景三、考证前，学员添加突击任务，根据计划自主完成任务；
- 场景四、学员成绩提高，提升了公司的品牌形象和口碑。

标准版对客户【开源】！ 提供部署、运维及定制开发服务。
敬请咨询： wx666666_18（微信号）


### 核心功能实现

1. **骨骼识别分析**
   - 使用MediaPipe实现13个关键控制点检测
   - 实时姿态分析和准确性评估
   - 可专门特定动作优化

2. **智能反馈机制**
   - 语音提示反馈（中文）
   - 可视化指示（颜色变化、动画效果）
   - 实时得分和准确度显示

3. **语音控制功能**
   - 集成百度语音API
   - 支持"开始"、"暂停"、"镜像"、"教练"等指令
   - 中文语音识别和合成

4. **双窗口显示**
   - 教练视频窗口（上方）
   - 用户摄像头窗口（下方）
   - 实时对比分析

5. **本地数据存储**
   - 使用Room数据库（SQLite）
   - 训练记录自动保存
   - 历史数据查看和管理

### 技术架构

- **开发语言**: Kotlin
- **架构模式**: MVVM + Repository
- **核心库**: MediaPipe、Room、Retrofit、CameraX
- **UI框架**: Material Design 3
- **权限管理**: PermissionX

### 用户界面

1. **主界面**: 欢迎界面，功能导航
2. **训练界面**: 双窗口显示，实时控制
3. **设置界面**: API配置，参数调整
4. **历史记录**: 训练数据查看

### 模块化设计

- **vision/**: 计算机视觉模块
- **voice/**: 语音控制模块  
- **data/**: 数据存储模块
- **ui/**: 用户界面模块

### 📋 项目文件结构

```
AITrainer/
├── app/                           # Android应用主模块
│   ├── src/main/
│   │   ├── java/com/aitrainer/
│   │   │   ├── data/              # 数据层
│   │   │   ├── vision/            # 计算机视觉
│   │   │   ├── voice/             # 语音控制
│   │   │   └── ui/                # 用户界面
│   │   ├── res/                   # 资源文件
│   │   └── AndroidManifest.xml    # 应用清单
│   └── build.gradle               # 应用配置
├── build.gradle                   # 项目配置
├── settings.gradle                # 项目设置
├── README.md                      # 项目说明
└── PROJECT_GUIDE.md              # 使用指南
```

### 部署说明

1. **环境要求**: Android Studio + API 24+
2. **API配置**: 需要配置百度语音API密钥
3. **权限**: 摄像头、麦克风、网络权限
4. **构建**: 直接构建APK或使用Android Studio运行

### 扩展性

- 支持添加新的动作
- 可集成其他语音API（Apple/Google）
- 模块化设计便于功能扩展
- 支持多平台扩展