### 前端多线响应式管理系统项目通讯协议解析
#### 一、概述
本文档主要阐述了在前端多线响应式管理系统中的通讯协议设计，包括但不限于端口定义、发现协议、启动游戏协议、状态返回协议及重置环境协议等。此协议用于协调不同组件之间的通信，确保系统能够高效稳定地运行。
#### 二、端口定义
在该系统中，不同的组件通过特定的端口进行通信：
- **Agent**：计算机代理程序，负责启动本地程序脚本，使用端口1922。
- **PAD**：Ipad端程序，使用端口1923。
- **Plug**：游戏程序插件端口，使用端口1924。
此外，文档还提到了两个缩写：
- **GP**: GameParameters 游戏参数缩写。
- **GS**: GameSrc 游戏路径缩写。
#### 三、发现协议
为了确保各个组件能够相互识别，系统定义了一套发现协议，由PAD主动发起请求，并由Agent进行响应。具体格式如下：
- **发现所有**: `FindAll Find;Type=XXX;IP=192.168.2.1;Area=A;`
- **发现服务器**: `FindServer Find;Type=OB;IP=192.168.2.1;Area=NULL;`
- **发现 OB**: `FindOB Find;Type=SER;IP=192.168.2.1;Area=NULL;`
- **发现客户端**: `FindClt Find;Type=CLT;IP=192.168.2.1;Area=A;`
其中，`Area` 字段表示区域属性，如果当前机器不需要或未填写，则设置为 `NULL`。
#### 四、启动游戏协议
当需要启动游戏时，PAD会向Agent发送启动命令，指定启动的类型以及相关的游戏参数。具体格式如下：
- **启动服务器**: `Start;Type=SER;GS=C:\\SSS\XX.bat;GP={SS=XX,AA=XX,CC=XX};`
- **启动 OB**: `Start;Type=OB;GS=C:\\SSS\XX.bat;GP={SS=XX,AA=XX,CC=XX};`
- **启动客户端**: `Start;Type=CLT;GS=C:\\SSS\XX.bat;GP={SS=XX,AA=XX,CC=XX};`
这里的 `GP` 字段包含了一系列游戏参数，以半角逗号分隔。
#### 五、状态返回协议
Agent会在接收到启动命令后，返回相应的状态信息给PAD，以便PAD了解启动情况。状态返回协议的具体格式如下：
- **运行成功**: `AgentStatus; Type=XXX;IP=192.168.2.1;Status=运行成功;`
- **内存错误**: `AgentStatus; Type=XXX;IP=192.168.2.1;Status=内存错误;`
- **文件名错误**: `AgentStatus; Type=XXX;IP=192.168.2.1;Status=文件名错误;`
- **路径名错误**: `AgentStatus; Type=XXX;IP=192.168.2.1;Status=路径名错误;`
- **EXE 文件无效**: `AgentStatus; Type=XXX;IP=192.168.2.1;Status= EXE 文件无效;`
- **其他错误**: `AgentStatus; Type=XXX;IP=192.168.2.1;Status=其他错误;`
#### 六、重置环境协议
为了清理或初始化环境，PAD可以通过以下协议命令Agent执行重置操作：
- **重置环境**: `Reset; Type=XXX;GS=C:\\SSS\XX.bat;`
#### 七、Pad-Plug 协议
这部分协议主要用于管理游戏的状态变化，具体包括以下几个方面：
1. **加入房间，启动协议**：
- **服务器启动状态**: `JoinStatus;Type=SER;Status=True;`
- **OB 启动状态**: `JoinStatus;Type=OB;Status=True;`
- **客户端启动状态**: `JoinStatus;Type=CLT;Status=True;IP=192.168.XX.XX;`
2. **准备游戏中协议**：
- **服务器准备状态**: `ReadyStatus;Type=SER;Status=True;`
- **OB 准备状态**: `ReadyStatus;Type=OB;Status=True;`
- **客户端准备状态**: `ReadyStatus;Type=CLT;Status=True;IP=192.168.XX.XX;`
3. **游戏中协议**：
- **服务器游戏中状态**: `GameStatus;Type=SER;Status=True;`
- **OB 游戏中状态**: `GameStatus;Type=OB;Status=True;`
- **客户端游戏中状态**: `GameStatus;Type=CLT;Status=True;IP=192.168.XX.XX;`
4. **开始游戏协议**：
- **开始游戏**: `StartGame;Status=True;`
#### 八、总结
本文档详细介绍了前端多线响应式管理系统中的通讯协议设计，包括端口定义、发现协议、启动游戏协议、状态返回协议、重置环境协议以及Pad-Plug协议。这些协议确保了系统各组件之间的高效协同工作，是实现系统功能的重要基础。通过本文档的学习，可以更好地理解系统的架构设计和运作机制，为后续的开发和维护提供支持。
