# WASD 手机摇杆控制器

通过 ADB 控制手机游戏摇杆，使用电脑键盘 WASD 键模拟触摸操作。

## 功能特点

- 使用电脑键盘 WASD 键控制手机游戏摇杆
- 支持八方向移动（W、A、S、D 及组合方向）
- 实时响应键盘输入
- 可配置摇杆位置和参数
- 自动检测 ADB 设备连接

## 前置条件

1. **安装 Python 3.6+**
   - 下载地址：https://www.python.org/downloads/

2. **安装 ADB 工具**
   - 方法一：安装 Android Studio，SDK 路径通常为 `C:\Users\<用户名>\AppData\Local\Android\Sdk\platform-tools\adb.exe`
   - 方法二：下载独立的 ADB 工具包
   - 方法三：本项目已包含 ADB 工具，位于 `platform-tools\platform-tools\adb.exe`

3. **安装 Python 依赖**
   ```bash
   py -m pip install keyboard
   ```

4. **手机设置**
   - 开启开发者选项（设置 > 关于手机 > 连续点击版本号）
   - 开启 USB 调试（设置 > 开发者选项 > USB 调试）
   - 通过 USB 连接手机到电脑

## 使用方法

1. **配置参数**
   - 打开 `config.py` 文件
   - 修改 `JOYSTICK_CENTER_X` 和 `JOYSTICK_CENTER_Y` 设置摇杆中心位置
   - 修改 `ADB_PATH` 设置 ADB 工具路径

2. **运行程序**
   ```bash
   py wasd_control.py
   ```

3. **操作说明**
   | 按键 | 功能 |
   |------|------|
   | W | 摇杆向上移动 |
   | S | 摇杆向下移动 |
   | A | 摇杆向左移动 |
   | D | 摇杆向右移动 |
   | ESC | 退出程序 |

4. **退出程序**
   - 按下 ESC 键即可退出

## 配置参数说明

| 参数 | 说明 | 默认值 |
|------|------|--------|
| JOYSTICK_CENTER_X | 摇杆中心 X 坐标 | 150 |
| JOYSTICK_CENTER_Y | 摇杆中心 Y 坐标 | 650 |
| JOYSTICK_RADIUS | 摇杆移动半径（像素） | 100 |
| ADB_PATH | ADB 工具路径 | 系统默认路径 |
| POLLING_INTERVAL | 轮询间隔（秒） | 0.05 |
| TOUCH_DURATION | 触摸滑动持续时间（毫秒） | 30 |

## 获取摇杆位置

1. 打开手机游戏，确保摇杆显示在屏幕上
2. 在手机开发者选项中开启"指针位置"
3. 触摸摇杆中心位置，记下显示的坐标
4. 修改 `config.py` 中的 `JOYSTICK_CENTER_X` 和 `JOYSTICK_CENTER_Y`

## 常见问题

**Q: 程序提示未检测到设备？**
- 检查手机是否已连接 USB
- 检查 USB 调试是否已开启
- 尝试重新插拔 USB 线
- 在命令行运行 `adb devices` 确认设备连接

**Q: 摇杆没有响应？**
- 检查摇杆位置坐标是否正确
- 检查 ADB 路径是否正确
- 确保游戏已在前台运行
- 尝试调整 `JOYSTICK_RADIUS` 值

**Q: 按键响应延迟？**
- 减小 `POLLING_INTERVAL` 值（如 0.03）
- 确保电脑性能良好

## 文件结构

```
wasd_touch_adb/
├── wasd_control.py    # 主程序
├── config.py          # 配置文件
└── README.md          # 使用说明
```

## 许可证

MIT License
