05.详细设计-基于ARM俄罗斯方块联机游戏设计

基于 ARM 俄罗斯方块联机游戏设计详细设计报告总页数 15 正文 10 附录 生效日期 2013.12.29编制 批准南昌航空大学东软班 详细设计报告 版本：1.0.02修 改 履 历修改编号 日期 修改人 版本号 修改内容1 VER0.1.0 初始做成2 VER0.1.1 函数说明，参数说明3 VER1.0.0 部分字体及格式修改南昌航空大学东软班 详细设计报告 版本：1.0.03目 录1 文档概述 .41.1 文档目的和范围 .41.2 术语/缩略语 .41.3 参考文档 .42 处理 .42.1 模块数据结构定义 .42.1.1 全局变量定义 .42.2 模块功能实现 .52.2.1 模块内部函数 .5南昌航空大学东软班 详细设计报告 版本：1.0.041 文档概述1.1 文档目的和范围该文档主要完成基于 ARM 下联机游戏的设计与实现的概要设计描述，主要是描述了本模块与其它模块的接口函数和内部接口函数以及内部函数的定义、流程图和构成图以及测试项目的记述。1.2 术语 /缩略语序号 术语/缩略语 说明1 QT QT 图形界面设计2 SOCKET 实现信息的发送与接收1.3 参考文档序号 文档名 作者 时间 版本1 详细设计模板 东软提供 2007-11-9 0002 详细设计方法 东软提供 2007-11-9 0003 函数说明指南 东软提供 2007-6-4 1104 流程图指南 东软提供 2007-6-4 1105 概要设计 胡东文 2013-12 0102 处理2.1 模块数据结构定义2.1.1 全局变量定义定义登录界面窗体变量：LoginDlg *loginDlg;定义注册界面窗体的变量：RegisterDlg *registerDlg;定义游戏界面窗体的变量：game_win *gameWin;定义游戏房间窗体的变量：GameRoomDlg *gameRoomDlg;南昌航空大学东软班 详细设计报告 版本：1.0.052.2 模块功能实现2.2.1 模块内部函数2.2.1.1LoginRequest函数名 LoginRequest文件名 ./ClientLogic功能概要 获得客户端登录请求记述形式 void LoginRequest(const LoginInfo 参数类型 变量名 I/O 说明const LoginInfo& loginInfo I 游戏登录信息返回值 类型 void 说明详细说明获得客户端登录请求使用注意事项无【函数处理流程】L o g i n R e q u e s t ( L o g i n I n f o l o g i n I n f o )m _ i n f o . L o g i n I n f o = l o g i n I n f o ;m _ i n f o . r e q u e s t K i n d = O N L I N E _ R E Q U E S T ;n e w C o n n e c t ( ) ;B e g i nE n d图 1. LoginRequest 流程图南昌航空大学东软班 详细设计报告 版本：1.0.062.2.1.2 RegisterRequest函数名 RegisterRequest文件名 ./ClientLogic功能概要 获得客户端注册请求记述形式 void RegisterRequest（const UserInfo& user）参数类型 变量名 I/O 说明const UserInfo& user I 游戏注册时玩家信息返回值 类型 void 说明详细说明获得客户端注册请求使用注意事项无【函数处理流程】R e g i s t e r R e q u e s t ( U s e r I n f o u s e r )m _ I n f o . u s e r I n f o = u s e r ;m _ I n f o . r e q u e s t K i n d = R E G I S T E R _ R E Q U E S T ;n e w C o n n e c t ( ) ;B e g i nE n d图 2. RegisterRequest 流程图南昌航空大学东软班 详细设计报告 版本：1.0.072.2.1.3 QuitGameRequest函数名 QuitGameRequest文件名 ./ClientLogic功能概要 获得客户端下线(退出游戏) 请求记述形式 void QuitGameRequest（const QString& account）参数类型 变量名 I/O 说明const QString& account I 退出游戏的帐号信息返回值 类型 void 说明详细说明获得客户端下线请求使用注意事项无【函数处理流程】Q u i t G a m e R e q u e s t （ c o n s t Q S t r i n g & a c c o u n t ）m _ i n f o . a c c o u n t = a c c o u n t ;m _ i n f o . r e q u e s t K i n d = O F F L I N E _ R E Q U E S T ;n e w C o n n e c t ( ) ;B e g i nE n d图 3. QuitGameRequest 流程图南昌航空大学东软班 详细设计报告 版本：1.0.082.2.1.4HandsUpRequest函数名 HandsUpRequest文件名 ./ClientLogic功能概要 举手请求记述形式 void HandsUpRequest（const QString& account）参数类型 变量名 I/O 说明const QString& account I 对方玩家的帐号信息，由服务器向该玩家发送举手请求返回值 类型 void 说明详细说明举手请求使用注意事项无【函数处理流程】H a n d s U p R e q u e s t ( c o n s t Q S t r i n g & a c c o u n t )m _ i n f o . a c c o u n t = a c c o u n t ;m _ i n f o . r e q u e s t K i n d = U P H A N D S _ R E Q U E S T ;n e w C o n n e c t ( ) ;B e g i nE n d图 4. HandsUpRequest 流程图南昌航空大学东软班 详细设计报告 版本：1.0.092.2.1.5PauseGameRequest函数名 PauseGameRequest文件名 ./ClientLogic功能概要 暂停游戏请求记述形式 void PauseGameRequest（const QString& account）参数类型 变量名 I/O 说明const QString& account I 对方玩家的帐号信息，由服务器向该玩家发送暂停游戏请求返回值 类型 void 说明详细说明暂停游戏请求使用注意事项无【函数处理流程】P a u s e G a m e R e q u e s t （ c o n s t Q S t r i n g & a c c o u n t ）m _ i n f o . a c c o u n t = a c c o u n t ;m _ i n f o . r e q u e s t K i n d = P A U S E G A M E _ R E Q U E S T ;n e w C o n n e c t ( ) ;B e g i nE n d图 5. PauseGameRequest 流程图南昌航空大学东软班 详细设计报告 版本：1.0.0102.2.1.6ReleaseSkillsRequest函数名 ReleaseSkillsRequest文件名 ./ClientLogic功能概要 释放技能请求记述形式 void ReleaseSkillsRequest（int skillNum, const QString& account）参数类型 变量名 I/O 说明int skillNum I 技能编号const QString& account I 对方玩家的帐号信息，由服务器向该玩家发送该技能请求返回值 类型 void 说明详细说明释放技能请求使用注意事项无【函数处理流程】R e l e a s e S k i l l s R e q u e s t （ i n t s k i l l N u m , c o n s t Q S t r i n g & a c c o u n t ）m _ i n f o . a c c o u n t = a c c o u n t ;m _ i n f o . r e q u e s t K i n d = s k i l l N u m ;n e w C o n n e c t ( ) ;B e g i nE n d图 6. ReleaseSkillsRequest 流程图.南昌航空大学东软班 详细设计报告 版本：1.0.0112.2.1.7GameEndRequest函数名 GameEndRequest文件名 ./ClientLogic功能概要 游戏结束发送的请求记述形式 void GameEndRequest（const EndGame& endGame）参数类型 变量名 I/O 说明const EndGame& endGame I 游戏结束结果统计信息返回值 类型 void 说明详细说明游戏结束发送的请求使用注意事项无【函数处理流程】G a m e E n d R e q u e s t （ c o n s t E n d G a m e & e n d G a m e ）m _ i n f o . E n d G a m e = e n d G a m e ;m _ i n f o . r e q u e s t K i n d = G A M E E N D _ R E Q U E S T ;n e w C o n n e c t ( ) ;B e g i nE n d南昌航空大学东软班 详细设计报告 版本：1.0.012图 7. GameEndRequest 流程图2.2.1.8receiveReply函数名 receiveReply文件名 ./ClientTranslate功能概要 接收并处理客户端通信层接收到的数据记述形式 void receiveReply（）参数类型 变量名 I/O 说明void - - -返回值 类型 void 说明详细说明接收并处理客户端通信层接收到的数据使用注意事项无【函数处理流程】R e a d ( r e p l y K i n d )获取对方信息Yr e p l y K i n d = = O N L I N E _ S U C CE S S E Dr e p l y K i n d = = R E G I S T E R _ S U CC E S S E D N获得帐号Yr e p l y K i n d = = H A N D S U P _ R E PL YN举手成功YNr e p l y K i n d = = E A T _ S K I L L S吃对方释放的技能Yr e p l y K i n d = = G A M E _ E N D _ R EP L Y N游戏结束后结果评分r e q u e s t K i n d = = O F F L I N E _ R E P LYN退出游戏YYr e c e i v e R e p l y ( )图 8. receiveReply 流程图南昌航空大学东软班 详细设计报告 版本：1.0.0132.2.1.9sendRequest函数名 sendRequest文件名 ./ClientTranslate功能概要 将客户端请求发送给服务器记述形式 void sendRequest（const Information& info）参数类型 变量名 I/O 说明const Information& info I 通信协议和内容返回值 类型 void 说明详细说明将客户端请求发送给服务器使用注意事项无【函数处理流程】s e n d R e q u e s t ( c o n s t I n f o r m a t i o n & i n f o )W r i t e ( i n f o . l o g i n I n f o ) ;Yr e q u e s t K i n d = = O N L I N E _ R E Q UE S TW r i t e （） 将数据发送给服务器r e q u e s t K i n d = = R E G I S T E R _ R EQ U E S T NW r i t e ( i n f o . u s e r I n f o ) ;Yr e q u e s t K i n d = = H A N D S U P _ R E QU E S TNW r i t e ( i n f o . a c c o u n t ) ;Yr e q u e s t K i n d = = P A U S E G A M E _ RE Q U E S T NW r i t e ( i n f o . a c c o u n t ) ;r e q u e s t K i n d = = R E L E A S E S K I L L S_ R E Q U E S TNW r i t e ( i n f o . a c c o u n t ) ;YYr e q u e s t K i n d = = G A M E E N D _ R EQ U E S T NW r i t e ( i n f o . e n d G a m e ) ;r e q u e s t K i n d = = O F F L I N E _ R E Q UE S TNW r i t e ( i n f o . a c c o u n t ) ;YY图 9. sendRequest 流程图南昌航空大学东软班 详细设计报告 版本：1.0.0142.2.1.10 receiveRequest函数名 receiveRequest文件名 ./ServerTranslate功能概要 接收并处理从服务器逻辑层接收到的数据记述形式 void receiveRequest（）参数类型 变量名 I/O 说明void - - -返回值 类型 void 说明详细说明接收并处理从服务器逻辑层接收到的数据使用注意事项无【函数处理流程】R e a d ( r e q u e s t K i n d )r e a d ( i n f o . l o g i n I n f o ) ;Yr e q u e s t K i n d = = O N L I N E _ R E Q U E S Tr e a d （） 将数据发送给服务器进行处理r e q u e s t K i n d = = R E G I S T E R _ R E Q U ES T Nr e a d ( i n f o . u s e r I n f o ) ;Yr e q u e s t K i n d = = H A N D S U P _ R E QU E S TNr e a d ( i n f o . a c c o u n t ) ;Yr e q u e s t K i n d = = P A U S E G A M E _ RE Q U E S T Nr e a d ( i n f o . a c c o u n t ) ;r e q u e s t K i n d = = R E L E A S E S K I L LS _ R E Q U E S TNr e a d ( i n f o . a c c o u n t ) ;Y Yr e q u e s t K i n d = = G A M E E N D _ R E QU E S T Nr e a d ( i n f o . e n d G a m e ) ;r e q u e s t K i n d = = O F F L I N E _ R E QU E S TNr e a d ( i n f o . s e n d e r A c c o u n t ) ;YYr e c e i v e R e q u e s t ( )e m i t s i g n a l图 10. receiveRequest 流程图南昌航空大学东软班 详细设计报告 版本：1.0.0152.2.1.11 sendReply函数名 sendReply文件名 ./ServerTranslate功