108 lines
2.4 KiB
Markdown
108 lines
2.4 KiB
Markdown
# 快速测试指南
|
||
|
||
## 快速开始
|
||
|
||
### 方法 1: 快速测试场景（推荐）
|
||
|
||
1. 在 Godot 编辑器中打开 `scenes/TestGameplay.tscn`
|
||
2. 按 **F6** 运行当前场景
|
||
3. 使用 **WASD** 或方向键移动角色
|
||
|
||
**预期结果**：
|
||
- ✅ 看到 Datawhale 办公室场景
|
||
- ✅ 角色可以自由移动
|
||
- ✅ 相机跟随角色
|
||
- ✅ 角色被墙壁和家具阻挡
|
||
|
||
### 方法 2: 完整游戏测试
|
||
|
||
1. 确保服务器正在运行：
|
||
```bash
|
||
cd server
|
||
yarn dev
|
||
```
|
||
|
||
2. 在 Godot 编辑器中按 **F5** 运行主场景
|
||
3. 输入用户名并创建角色
|
||
4. 测试移动、对话等功能
|
||
|
||
## 运行测试套件
|
||
|
||
### 属性测试
|
||
|
||
1. 在 Godot 编辑器中打开 `tests/RunPropertyTests.gd`
|
||
2. 按 **F6** 运行
|
||
3. 查看控制台输出
|
||
|
||
**测试覆盖**：
|
||
- 键盘输入响应
|
||
- 服务器同步
|
||
- 在线/离线角色显示
|
||
- 错误显示
|
||
- 重连机制
|
||
|
||
### 单元测试
|
||
|
||
运行特定测试文件：
|
||
1. 打开 `tests/test_*.gd` 文件
|
||
2. 按 **F6** 运行
|
||
3. 查看测试结果
|
||
|
||
**可用测试**：
|
||
- `test_character_controller.gd` - 角色控制器测试
|
||
- `test_character_data.gd` - 角色数据测试
|
||
- `test_input_handler.gd` - 输入处理测试
|
||
- `test_game_state_manager.gd` - 状态管理测试
|
||
- `test_message_protocol.gd` - 消息协议测试
|
||
- `test_security_manager.gd` - 安全管理测试
|
||
- `test_rate_limiter.gd` - 速率限制测试
|
||
|
||
## 测试功能
|
||
|
||
### 角色移动
|
||
- 使用 WASD 或方向键
|
||
- 角色应该平滑移动
|
||
- 不能穿过墙壁和障碍物
|
||
|
||
### 相机控制（调试模式）
|
||
- **移动相机**: WASD 或方向键
|
||
- **缩放**: 鼠标滚轮
|
||
- **重置**: R 键
|
||
|
||
### 网络功能
|
||
- 创建角色
|
||
- 查看其他在线角色
|
||
- 角色状态同步
|
||
|
||
### 对话系统
|
||
- 接近其他角色
|
||
- 按 E 键交互
|
||
- 发送消息
|
||
|
||
## 常见问题
|
||
|
||
**Q: 测试失败怎么办？**
|
||
A: 查看控制台详细错误信息，确保所有文件已保存
|
||
|
||
**Q: 服务器连接失败？**
|
||
A: 确认服务器正在运行（`yarn dev`），检查端口 8080 是否被占用
|
||
|
||
**Q: 角色不显示？**
|
||
A: 确保游戏窗口是激活状态，检查控制台错误信息
|
||
|
||
## 性能测试
|
||
|
||
### 帧率测试
|
||
- 目标: 30+ FPS
|
||
- 查看 Godot 编辑器右上角的 FPS 显示
|
||
|
||
### 网络延迟
|
||
- 目标: 操作响应 < 200ms
|
||
- 观察角色移动的流畅度
|
||
|
||
## 下一步
|
||
|
||
- 查看 [项目状态](PROJECT_STATUS.md) 了解已完成功能
|
||
- 查看 [SETUP.md](SETUP.md) 了解开发环境配置
|
||
- 查看 [server/README.md](server/README.md) 了解服务器 API
|