# VoiceRecorder

**Repository Path**: mygule/VoiceRecorder

## Basic Information

- **Project Name**: VoiceRecorder
- **Description**: 🎙️ 基于 .NET 8 + WPF 的桌面录音机，支持多种音质预设、设备选择、暂停继续，简洁易用的录音工具
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎙️ VoiceRecorder

一个基于 **.NET 8 + WPF** 的桌面录音机应用程序，界面美观，功能全面，支持多种音质预设和录音设备选择。

![.NET](https://img.shields.io/badge/.NET-8.0-512BD4?logo=dotnet)
![WPF](https://img.shields.io/badge/WPF-Windows-0078D6?logo=windows)
![NAudio](https://img.shields.io/badge/NAudio-2.3.0-green)
![License](https://img.shields.io/badge/License-MIT-yellow)

---

## ✨ 功能特性

| 功能 | 说明 |
|------|------|
| 🎤 **设备选择** | 自动检测并列出系统中的所有录音设备 |
| 🔊 **音质预设** | 内置 6 种音质选项，从电话音质到高解析度音频 |
| 📁 **自定义目录** | 可自由选择录音文件的保存位置（默认桌面 `VoiceRecordings`） |
| ⏸️ **暂停/继续** | 录制过程中可随时暂停和继续 |
| ⏹ **停止保存** | 停止录音后自动保存为 WAV 文件并提示 |
| 🎧 **直接播放** | 生成的 WAV 文件可直接用系统播放器打开收听 |
| 🎨 **精美界面** | 现代化圆角 UI 设计，录制状态实时指示 |

## 🎵 音质预设

| 预设 | 采样率 | 声道 | 适用场景 |
|------|--------|------|----------|
| 低质量 (8kHz) | 8 kHz | 单声道 | 语音笔记、电话音质 |
| 中等质量 (22.05kHz) | 22.05 kHz | 单声道 | FM 收音机音质 |
| 高质量 (44.1kHz/单声道) | 44.1 kHz | 单声道 | 单声道录音 |
| **CD 音质 (44.1kHz/立体声) ⭐** | 44.1 kHz | 立体声 | **推荐**，标准 CD 音质 |
| 专业音质 (48kHz/立体声) | 48 kHz | 立体声 | 影视制作标准 |
| 超高音质 (96kHz/立体声) | 96 kHz | 立体声 | 高解析度音频 |

## 🚀 快速开始

### 运行要求

- **操作系统**: Windows 10 / Windows 11 (x64)
- **运行时**: 无需安装 .NET 运行时（独立发布包已包含）

### 下载运行

1. 前往 **[Releases 页面](https://gitee.com/mygule/VoiceRecorder/releases)** 下载最新版本
2. 下载 `VoiceRecorder-v1.0-win-x64.zip`
3. 解压后运行 `VoiceRecorder.exe`

## 🔧 自行编译

### 环境要求

- [.NET 8.0 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)
- Windows 10/11 (x64)

### 编译步骤

```bash
# 克隆仓库
git clone https://gitee.com/mygule/VoiceRecorder.git
cd VoiceRecorder

# 还原依赖
dotnet restore

# 发布独立可执行文件
dotnet publish -c Release -r win-x64 --self-contained true \
  -p:PublishSingleFile=true \
  -p:IncludeNativeLibrariesForSelfExtract=true \
  -p:EnableCompressionInSingleFile=true \
  -o "发布包"

# 编译后的程序位于 发布包/ 目录
```

### 调试运行

```bash
dotnet run -c Debug
```

## 🛠️ 技术栈

- **[.NET 8](https://dotnet.microsoft.com/)** - 跨平台开发框架
- **[WPF](https://learn.microsoft.com/windows/apps/desktop/)** - Windows 桌面 UI 框架
- **[NAudio 2.3.0](https://github.com/naudio/NAudio)** - 音频捕获与处理库

## 📁 项目结构

```
VoiceRecorder/
├── App.xaml / App.xaml.cs    # 应用程序入口
├── MainWindow.xaml           # 主窗口 UI (XAML)
├── MainWindow.xaml.cs        # 主窗口逻辑代码
├── VoiceRecorder.csproj      # 项目配置文件
├── global.json               # .NET SDK 版本配置
├── Assets/                   # 资源文件（图标等）
└── IconGen/                  # 图标生成工具
```

## 📜 许可证

本项目基于 MIT 许可证开源。

---

> 💡 **提示**: 录音文件默认保存在桌面 `VoiceRecordings` 文件夹中，为 WAV 格式，可在文件管理器中直接双击播放。