182 lines
3.6 KiB
Markdown
182 lines
3.6 KiB
Markdown
# 远程音量监控工具 V1.0
|
||
|
||
Windows 远程连接音量自动调节器 - 检测到 RDP 远程连接时自动调整系统音量
|
||
|
||
---
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 1. 安装依赖工具（推荐）
|
||
|
||
下载 nircmd.exe 放到 `tools` 文件夹：
|
||
- 64 位：https://www.nirsoft.net/utils/nircmd-x64.zip
|
||
- 32 位：https://www.nirsoft.net/utils/nircmd.zip
|
||
|
||
解压后将 `nircmd.exe` 复制到 `tools\` 目录
|
||
|
||
### 2. 运行程序
|
||
|
||
**方式 1：使用启动脚本**
|
||
```bat
|
||
scripts\启动监控.bat
|
||
```
|
||
|
||
**方式 2：直接运行**
|
||
```bat
|
||
python src\remote_volume_monitor.py
|
||
```
|
||
|
||
**方式 3：测试模式**
|
||
```bat
|
||
python src\remote_volume_monitor.py --test
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 功能特性
|
||
|
||
- ✅ 自动检测 RDP 远程连接/断开
|
||
- ✅ 连接时自动降低音量（默认 30%）
|
||
- ✅ 断开时自动恢复音量（默认 80%）
|
||
- ✅ 零第三方 Python 依赖
|
||
- ✅ 支持 nircmd/Core Audio/PowerShell 多种方案
|
||
- ✅ 配置文件可自定义
|
||
- ✅ 后台服务模式
|
||
|
||
---
|
||
|
||
## ⚙️ 配置说明
|
||
|
||
编辑 `config\config.ini`：
|
||
|
||
```ini
|
||
[volume]
|
||
# 远程连接时的音量 (0-100)
|
||
remote_volume = 30
|
||
|
||
# 本地使用时的音量 (0-100)
|
||
local_volume = 80
|
||
|
||
[monitor]
|
||
# 检测间隔（秒）
|
||
check_interval = 5
|
||
|
||
[behavior]
|
||
# 连接时调整音量
|
||
adjust_on_connect = true
|
||
|
||
# 断开时恢复音量
|
||
adjust_on_disconnect = true
|
||
```
|
||
|
||
---
|
||
|
||
## 📁 文件结构
|
||
|
||
```
|
||
remote-volume-monitor-v1.0/
|
||
├── src/
|
||
│ └── remote_volume_monitor.py # 主程序
|
||
├── config/
|
||
│ └── config.ini # 配置文件
|
||
├── tools/
|
||
│ ├── README.md # 工具说明
|
||
│ └── nircmd.exe # 音量工具（需自行放入）
|
||
├── scripts/
|
||
│ └── 启动监控.bat # 启动脚本
|
||
├── docs/
|
||
│ ├── 部署检查清单_远程音量控制.md
|
||
│ └── 音量控制方案说明.md
|
||
├── logs/ # 日志目录（运行时自动创建）
|
||
├── README.md # 本文件
|
||
└── requirements.txt # 依赖说明
|
||
```
|
||
|
||
---
|
||
|
||
## 🧪 常用命令
|
||
|
||
```bash
|
||
# 测试模式（检测一次后退出）
|
||
python src\remote_volume_monitor.py --test
|
||
|
||
# 获取当前音量
|
||
python src\remote_volume_monitor.py --get-volume
|
||
|
||
# 设置音量
|
||
python src\remote_volume_monitor.py --set-volume 50
|
||
|
||
# 创建配置文件
|
||
python src\remote_volume_monitor.py --create-config
|
||
|
||
# 启动监控
|
||
python src\remote_volume_monitor.py
|
||
|
||
# 使用启动脚本
|
||
scripts\启动监控.bat
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 系统要求
|
||
|
||
- **操作系统：** Windows 10/11
|
||
- **Python：** 3.8 或更高版本
|
||
- **权限：** 普通用户权限即可（安装服务需要管理员）
|
||
- **音频设备：** 必须有活跃的音频输出设备
|
||
|
||
---
|
||
|
||
## 🐛 故障排查
|
||
|
||
### 问题 1：无法检测 RDP 连接
|
||
|
||
**检查：**
|
||
```bash
|
||
python src\test_rdp_detection.py
|
||
```
|
||
|
||
### 问题 2：音量无法调节
|
||
|
||
**解决：**
|
||
1. 确认已下载 nircmd.exe 放到 `tools` 文件夹
|
||
2. 检查 Windows Audio 服务是否运行
|
||
3. 查看日志文件 `logs\remote_volume.log`
|
||
|
||
### 问题 3：断开 RDP 后音量不恢复
|
||
|
||
**检查：**
|
||
```bash
|
||
python src\test_rdp_disconnect.py
|
||
```
|
||
|
||
---
|
||
|
||
## 📖 详细文档
|
||
|
||
- **部署指南：** `docs\部署检查清单_远程音量控制.md`
|
||
- **音量方案：** `docs\音量控制方案说明.md`
|
||
- **工具说明：** `tools\README.md`
|
||
|
||
---
|
||
|
||
## 📝 版本信息
|
||
|
||
- **版本号：** V1.0
|
||
- **发布日期：** 2026-03-07
|
||
- **依赖：** 零第三方 Python 依赖
|
||
- **推荐工具：** nircmd.exe（35KB 免费工具）
|
||
|
||
---
|
||
|
||
## 📞 技术支持
|
||
|
||
查看日志文件获取详细信息：
|
||
```
|
||
logs\remote_volume.log
|
||
```
|
||
|
||
---
|
||
|
||
*远程音量监控工具 V1.0 - 零依赖版本*
|