# audioPlay

**Repository Path**: masaikk/audio-play

## Basic Information

- **Project Name**: audioPlay
- **Description**: 播放音频
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-02
- **Last Updated**: 2025-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# audioPlay

#### 介绍
播放音频

#### 软件架构
软件架构说明


## 安装依赖

首先安装所需的 Python 库：

```bash
pip install -r requirements.txt
```

如果遇到 PyAudio 安装问题，Windows 用户可以：
```bash
pip install pipwin
pipwin install pyaudio
```

## 虚拟音频设备设置

为了将音频作为麦克风输入使用，建议安装虚拟音频驱动：

1. **VB-Audio Virtual Cable**（推荐，免费）
   - 下载地址：https://vb-audio.com/Cable/
   - 安装后重启电脑
   - 在 Windows 声音设置中将 "CABLE Input" 设为默认录音设备

2. **VoiceMeeter**（免费）
   - 下载地址：https://vb-audio.com/Voicemeeter/
   - 更强大的虚拟音频混音器

## 使用步骤

### 1. 启动程序
```bash
python gui.py
```

### 2. 配置音频设备
- 在"音频设备设置"区域选择输出设备
- 程序会自动选择合适的虚拟音频设备
- 点击"刷新设备"可重新扫描设备

### 3. 配置热键
- 在"热键配置"区域设置热键和对应的音频文件
- 默认提供了 i、o、p 三个热键
- 点击"选择文件"为每个热键选择音频文件
- 可以点击"添加热键"增加更多热键
- 点击"删除"可移除不需要的热键

### 4. 开始监听
- 点击"开始监听热键"启动全局热键监听
- 程序会在后台监听键盘输入
- 按下配置的热键即可播放对应的音频

### 5. 控制播放
- "停止播放"按钮可中断当前播放
- 再次点击"停止监听热键"可停止热键监听

## 支持的音频格式

- WAV (.wav)
- MP3 (.mp3) 
- FLAC (.flac)
- OGG (.ogg)
- AIFF (.aiff)

## 注意事项

1. **全局热键权限**：程序需要管理员权限才能监听全局热键
2. **音频设备**：确保选择了正确的输出设备
3. **文件路径**：音频文件路径不能包含特殊字符
4. **同时播放**：新的热键会中断当前播放
5. **虚拟设备**：安装虚拟音频驱动后需要重启系统

## 故障排除

### 无法监听热键
- 确保安装了 pynput 库：`pip install pynput`
- 以管理员权限运行程序

### 无法播放音频
- 检查音频文件是否存在且格式正确
- 确保选择了正确的输出设备
- 检查音频设备是否被其他程序占用

### 没有虚拟音频设备
- 安装 VB-Audio Virtual Cable 或类似软件
- 重启计算机后重新运行程序

## 使用场景

- 游戏内语音通话播放音效
- 在线会议播放背景音乐
- 直播时播放音效文件
- 录音软件的音频输入源

## 技术原理

程序通过 PyAudio 将音频文件播放到选定的输出设备，结合虚拟音频线缆，可以将播放的音频重定向为系统的麦克风输入，从而实现音频文件作为语音输入的效果。