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中的所有文件。

See Also

 

Index
SteamLobby