UnityAI/business-reference/playballoons/features/登录.md

# 登录

## 分类

- 项目功能

## 目的

记录登录流程、登录窗口、网络交互和进入游戏后的衔接关系。

## 关键文件

| 用途 | 路径 | 说明 |
|---|---|---|
| 登录管理器 | `Assets/Game/GameHFScripte/GameFunction/Logic/Login/HFLoginManager.cs` | 单例，负责连接服务器、发送登录协议、处理登录后事件链 |
| 登录窗口 | `Assets/Game/GameHFScripte/GameFunction/UIWindows/Login/LoginWindow.cs` | 继承 `AbsHFUIWindow`，绑定输入框和登录按钮 |
| 登录 Prefab | `Assets/Game/GameHFResource/UIWindows/Login/LoginWindow.prefab` | 窗口资源，由 `HFAssetBundlePath` 指定 |
| 启动入口 | `Assets/Game/GameHFScripte/GameFunction/GameRoot/HFGameStart.cs`（待确认） | 初始化 manager 并打开 `LoginWindow` |

## 数据流

```text
[启动]
HFGameStart.InitManager
  -> OpenWindow<LoginWindow>

[用户点击]
LoginWindow.OnBtnLogin
  -> 校验用户名非空
  -> PlayerPrefs 保存用户名/密码
  -> HFLoginManager.Instance.Login(InputName.text)

[连接服务器]
HFLoginManager.Login(account)
  -> UNITY_EDITOR 下读取 EditorPrefs["IPData"] 覆盖 IP
  -> HFSeverManager.ReConnect(OnReConnect)
  -> HFSeverManager.Connect(MainConnect, WebSocket, m_IP, m_Port, m_Token, callback)
  -> 连接成功后 OnSendLogin

[登录协议]
OnSendLogin
  -> LoginAuthC2S
       ServerId = 10001
       Token    = m_Token
       Pid      = "2126001"
       UserName = m_Account
       Password = m_Account

[服务端响应链]
LoginAuthS2C (ErrorCode == 0)
  -> PlayerSelectC2S
  -> PlayerSelectS2C
       有角色：PlayerEnterC2S
       无角色：PlayerCreateC2S -> PlayerEnterC2S
  -> PlayerEnterS2C
  -> PlayerFlushC2S(All = true)
  -> RequestLoginData 触发后续背包、资源等初始化
```

## 关键协议

- `LoginAuthC2S` / `LoginAuthS2C`
- `PlayerSelectC2S` / `PlayerSelectS2C`
- `PlayerCreateC2S` / `PlayerCreateS2C`
- `PlayerEnterC2S` / `PlayerEnterS2C`
- `PlayerFlushC2S` / `PlayerFlushS2C`
- `ChangeNicknameC2S` / `ChangeNicknameS2C`

## 已确认流程

当前登录入口：

```text
HFGameStart.InitManager
  -> OpenWindow<LoginWindow>
  -> LoginWindow.OnBtnLogin
  -> HFLoginManager.Login(InputName.text)
```

`HFLoginManager.Login` 流程：

```text
Login(account)
  -> 读取 EditorPrefs["IPData"] 覆盖 IP（仅 UNITY_EDITOR）
  -> ConnectServer
  -> HFSeverManager.ReConnect(OnReConnect)
  -> HFSeverManager.Connect(MainConnect, WebSocket, m_IP, m_Port, m_Token)
  -> OnSendLogin
  -> LoginAuthC2S.Dispatch
```

服务端事件链：

```text
LoginAuthS2C
  -> PlayerSelectC2S
  -> PlayerSelectS2C
    -> 有角色：PlayerEnterC2S
    -> 无角色：PlayerCreateC2S -> PlayerEnterC2S
  -> PlayerEnterS2C
  -> PlayerFlushC2S(All = true)
```

`LoginWindow` 会把用户名和密码写入 `PlayerPrefs`，但实际登录请求当前使用用户名作为 account，密码未参与 `LoginAuthC2S`。

## 梳理任务

- [x] 找到登录功能的入口方法和首个调用点。
- [x] 梳理登录请求、响应和错误处理。
- [x] 梳理登录成功后初始化了哪些 manager。
- [x] 梳理登录窗口 prefab 和脚本绑定关系。
- [ ] 确认登录完成后进入主界面或 PVE 的流程。

## 待确认

- 登录是否区分游客、账号、平台登录。
- 登录数据是否会初始化背包、关卡、角色/塔数据。
- 是否存在断线重连或重新登录流程。
- `PlayerFlushS2C` 收到后由谁打开主界面，目前未确认。
- 密码输入框当前只保存到 `PlayerPrefs`，是否应参与登录待确认。

## 相关框架

- [网络框架](../../../modules/frameworks/网络系统.md)
- [UI 框架](../../../modules/frameworks/UI窗口系统/README.md)
- [Hotfix 启动/目录](../../../modules/frameworks/Hotfix启动.md)

---

## 文档关联

> **注意**：当本模块发生变更时，应同步检查以下关联文档，避免信息不一致。

### 关联模块

| 模块 | 文档 | 关联原因 |
|---|---|---|
| 背包 | [背包](背包.md) | 登录成功后 `RequestLoginData` 触发背包初始化 |
| 奖励/道具展示 | [奖励/道具展示](奖励道具.md) | 登录流程涉及资源、道具配置 |
| GM/调试功能 | [GM/调试功能](GM调试.md) | `HFLoginManager` 在 Editor 下读取 `EditorPrefs["IPData"]` 覆盖 IP |
| PVE/关卡战斗 | [PVE/关卡战斗](PVE关卡战斗.md) | 登录后进入主界面或 PVE 的流程衔接 |
| 地图/关卡进度 | [地图/关卡进度](地图进度.md) | 登录后角色数据与关卡进度同步 |

### 关联框架文档

| 框架 | 文档 | 关联原因 |
|---|---|---|
| 网络框架 | [网络框架](../../../modules/frameworks/网络系统.md) | 登录协议（`LoginAuthC2S/S2C`、`PlayerEnterS2C` 等） |
| UI 框架 | [UI 框架](../../../modules/frameworks/UI窗口系统/README.md) | `LoginWindow` 继承 `AbsHFUIWindow` |
| Hotfix 启动/目录 | [Hotfix 启动/目录](../../../modules/frameworks/Hotfix启动.md) | `HFGameStart.InitManager` 为入口 |
| 事件框架 | [事件框架](../../../modules/frameworks/事件系统/README.md) | `RequestLoginData` 触发后续初始化事件链 |
| 场景框架 | [场景框架](../../../modules/frameworks/场景系统.md) | 登录后进入主界面涉及场景切换 |

### 关联规则

| 规则 | 文档 | 关联原因 |
|---|---|---|
| 模块登记规则 | [30-模块登记规则.md](../../../rules/30-模块登记规则.md) | 登录模块登记与状态 |
| 文档同步规则 | [50-文档同步规则.md](../../../rules/50-文档同步规则.md) | 长期接口或流程变化时同步模块文档 |
| 架构说明 | [10-架构说明.md](../../../rules/10-架构说明.md) | 登录为游戏入口，涉及整体架构 |
| 开发规则 | [20-开发规则.md](../../../rules/20-开发规则.md) | 网络协议、UI 窗口开发规范 |