RakNet--Lobby2Client - PC
大厅服务器 |
数据库支持好友,房间,邮件,排名和更多功能 大厅服务器是一个提供了PostgreSQL数据库驱动功能的插件,使用数据库可以持久化游戏数据和比赛信息(也即将游戏数据存入数据库长期存放)。大厅服务器本身不要求特别多的用户交互,涉及交互的地方的交互命令是通过LobbyClient_PC类执行。 大厅服务器分为两个类,LobbyServer本身单独提供了网络功能,调用接口就可以生成一个数据库。LobbyServerPostgreSQL,可以在文件DependentExtensions\Lobby\LobbyServer_PostgreSQL\LobbyServer_PostgreSQL.h中找到,它是LobbyServer的一个实现,使用PostgreSQL来驱动数据库。 基本类有连接到数据库,创建和删除基本表的的函数方法。例子可以在LobbyServer工程中的Samples/LobbyServerTest/LobbyServerTest.cpp文件中找到,其中做了详细说明。 一个额外的要求是Functor类的使用。Functor是RakNet中的类,它实现了可以在FunctionThread中异步运行的特定功能单元,FunctionThread是RakNet中另外一个功能类。大部分情况下,你不需要要担心这个Functor——然而,有一个Functor是需要关注的,它就是向数据库中加入新的titles(游戏/应用程序)的Functor。 如何实现在下面的例子中做了说明:
// 这个functor向数据库中异步加入一个title,完整的例子位于LobbyDB_PostgreSQLTest中 AddTitle_PostgreSQLImpl *functor = AddTitle_PostgreSQLImpl::Alloc(); printf("Adds a title to the database\n"); printf("Enter title name: "); gets(inputStr); if (inputStr[0]==0) strcpy(inputStr, "Hangman EXTREME!"); functor->titleName = inputStr; printf("Enter title password (binary): "); gets(inputStr); if (inputStr[0]==0) strcpy(inputStr, "SECRET_PER_GAME_LOGIN_PW_PREVIOUSLY_SETUP_ON_THE_DB"); functor->titlePassword = AddTitle_PostgreSQLImpl::AllocBytes((int) strlen(inputStr)); functor->titlePasswordLength = (int) strlen(inputStr); memcpy(functor->titlePassword, inputStr, functor->titlePasswordLength); functor->allowClientAccountCreation=true; functor->lobbyIsGameIndependent=true; functor->defaultAllowUpdateHandle=true; functor->defaultAllowUpdateCCInfo=true; functor->defaultAllowUpdateAccountNumber=true; functor->defaultAllowUpdateAdminLevel=true; functor->defaultAllowUpdateAccountBalance=true; functor->defaultAllowClientsUploadActionHistory=true; // 将这个functor放入处理队列,那么在后面线程会处理它 // 参考LobbyDB_PostgreSQLTest, TitleValidationDB_PostgreSQLTest, RankingServerDBTest // 工程,查看functor 的完整例子。 lobbyServer.PushFunctor(functor);
这段代码将带有各种属性的title加入到了数据库中,这些属性表明了可以在这个数据库中进行哪些类型的操作。在DependentExtensions\Lobby\TitleValidationDBSpec.h文件中查看AddTitle_Data类声明,详细了解每一个参数的解释。其他的一些functor用于执行各种数据库操作。DependentExtensions/*_PostgreRepository目录中包含了这些实现,但是数据成员和函数的注释文档包含在DependentExtensions\Lobby\*DBSpec.h文件中。测试程序和各种操作的例子可以再TitleValidationDB_PostgreSQLTest,RankingServerDB_PostgreSQLTest和LobbyDB_PostgreSQLTest工程中找到。 参考LobbyServerTest例子,查看运行LobbyServer的控制台应用程序。
需要的文件(使用PostgreSQL): 目录DependentExtensions\Lobby中的所有文件,除了Client使用的文件 目录DependentExtensions\Lobby\LobbyDB_PostgreRepository中的所有文件 目录DependentExtensions\Lobby\LobbyServer_PostgreSQL中的所有文件 目录DependentExtensions\Lobby\RankingServerDB_PostgreRepository 中的所有文件 目录DependentExtensions\Lobby\TitleValidationDB_PostgreRepository中的所有文件 目录DependentExtensions\PostgreSQLInterface中的所有文件
如果想要使用控制台程序,可以参考目录Samples\LobbyServerTest中的文件。
所有依赖的文件(使用PostgreSQL): PostgreSQL 8.2或更新版本,安装到C:\Program Files\PostgreSQL\8.2。如果安装目录不是这个,要修改工程的属性路径。不要忘记检查PostgreSQL安装中是否安装了开发工具,否则头文件和libs不会背安装。
|
Lobby Client (PC) |
数据库的用户接口 快速开始: 1. 将插件附加到RakPeerInterface实例上,并且连接到服务器。 2. 使用LobbyClientInterfaceCB的派生实例调用SetCallbackInterface()方法。系统的一般设计是所有的调用都是异步进行,那么每一次调用都会将结果(成功或失败)返回到相应的注册回调。 3. 如果还没有账户,调用RegisterAccount方法在大厅创建一个用户账户。等待LobbyClientInterfaceCB::RegisterAccount_Result()方法返回,查看它的查询是否成功。一种失败原因是名字已经使用,或者是不允许使用的用户名。 4.使用标识了你正在使用的数据库的信息调用SetTitleLoginId()方法(如果每一个大厅允许多游戏,那么可以再后面调用该方法)。这个机制应该硬编码进游戏中,当数据库加入到服务器时被返回。 5. 使用你刚刚创建的账户(或先前存储的账户)获得调用Login()方法。等待LobbyClientInterfaceCB::Login_Result()方法返回,看是否调用成功。如果有好友,应该得到LobbyClientInterfaceCB::FriendStatus_Notify()函数的调用返回,通知他们你已经上线。 6. 使用DownloadRooms()方法获得所有房间的列表,给予搜索过滤器,紧接着是JoinRoom(),SetReadyToPlayStatus()和StartGame()方法的调用。或者使用QuickMatch()方法自动启动一个有指定玩家数据的游戏。 7. 一旦游戏开始,会得到LobbyClientInterfaceCB::StartGame_Notify()方法调用。这个方法可以给你提供所有玩家的IP地址,参与者,以及谁是仲裁者,用户处理人以及与游戏相关的其他的信息。在这个时候,可以从大厅断开连接。如果不断开,会被自动发回主大厅(任何房间外面)。 要查看一个完整的函数列表,以及函数参数,可以参考DependentExtensions\Lobby\LobbyClientPC.h。
要求的文件: DependentExtensions\Lobby目录下的所有文件,出列LobbyServer.h 和LobbyServer.cpp文件 如果你可以使用控制台应用程序,则还需要Samples\LobbyClientTest中的所有文件。 |
![]() |
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步