# Dictation_android

**Repository Path**: lyyarrow/dictation_android

## Basic Information

- **Project Name**: Dictation_android
- **Description**: 听写词语app安卓版
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-03
- **Last Updated**: 2026-06-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Dictation Android

一款专为听写练习设计的 Android 应用，支持语文听写、数学计算等多种模式。应用采用现代 Android 开发技术栈，提供完整的听写学习解决方案。

## 功能特点

- 📚 **词书管理**：创建、编辑和管理多个听写词书
- 🎯 **多种听写模式**：标准听写、语音答题、数学计算等多种模式
- 📷 **OCR 扫描**：拍照识别生词，快速添加到词书
- 📊 **学习统计**：查看正确率趋势和错误分析
- 🔊 **语音播报**：支持 TTS 语音播报和语音命令控制
- ⚙️ **个性化设置**：语速、灵敏度、主题等自定义选项

## 技术架构

- **UI 框架**：Jetpack Compose + Material Design 3
- **依赖注入**：Hilt
- **本地数据库**：Room
- **架构模式**：MVVM + Clean Architecture
- **OCR 引擎**：Google ML Kit
- **语音引擎**：Android TTS + Speech Recognition

## 项目结构

```
app/
├── src/main/kotlin/com/dictation/app/
│   ├── core/                    # 核心模块
│   │   ├── data/               # 数据层
│   │   │   ├── di/            # Hilt 依赖注入模块
│   │   │   ├── local/         # Room 数据库
│   │   │   ├── dao/           # Data Access Objects
│   │   │   └── repository/    # 仓库实现
│   │   ├── engine/            # 核心引擎
│   │   │   ├── TtsEngine     # 语音合成引擎
│   │   │   ├── OcrEngine     # OCR 识别引擎
│   │   │   └── VoiceCommandRecognizer  # 语音识别
│   │   ├── model/            # 数据模型
│   │   │   ├── entity/       # 数据库实体
│   │   │   ├── enums/       # 枚举定义
│   │   │   └── view/         # 视图模型
│   │   └── ui/               # 公共 UI
│   │       ├── theme/       # 主题管理
│   │       └── component/   # 通用组件
│   ├── feature/               # 功能模块
│   │   ├── booklist/        # 词书列表
│   │   ├── bookdetail/     # 词书详情
│   │   ├── dictation/      # 听写练习
│   │   ├── correction/    # 批改订正
│   │   ├── ocr/           # OCR 扫描
│   │   ├── stats/         # 学习统计
│   │   └── settings/       # 设置
│   └── navigation/          # 导航配置
```

## 主要技术栈

| 类别 | 技术 |
|------|------|
| 语言 | Kotlin |
| UI | Jetpack Compose |
| DI | Hilt |
| Database | Room |
| Async | Kotlin Coroutines + Flow |
| Navigation | Compose Navigation |
| OCR | ML Kit |

## 运行要求

- Android SDK 34+
- Gradle 8.7+
- Android Studio Jellyfish+

## 快速开始

```bash
# 克隆项目
git clone https://gitee.com/lyyarrow/dictation_android.git

# 构建项目
./gradlew assembleDebug

# 安装 APK
adb install app/build/outputs/apk/debug/app-debug.apk
```

## 使用说明

### 创建词书
1. 在词书列表页面，点击右下角 "+" 按钮
2. 输入词书名称，选择学科
3. 点击确认完成创建

### 添加词汇
1. 进入词书详情页
2. 点击右上角添加按钮
3. 手动输入或使用 OCR 扫描识别

### 开始听写
1. 选择词书进入详情页
2. 点击"开始听写"按钮
3. 根据语音提示书写答案

### 查看统计
1. 点击底部导航栏"统计"
2. 查看整体学习数据和错误分析

## License

MIT License