大厅服务器
大厅服务器是一个提供了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的控制台应用程序。
目录DependentExtensions\Lobby中的所有文件，除了Client使用的文件
目录DependentExtensions\Lobby\LobbyDB_PostgreRepository中的所有文件
目录DependentExtensions\Lobby\LobbyServer_Postgresql中的所有文件
目录DependentExtensions\Lobby\RankingServerDB_PostgreRepository 中的所有文件
目录DependentExtensions\Lobby\TitleValidationDB_PostgreRepository中的所有文件
目录DependentExtensions\PostgresqlInterface中的所有文件
如果想要使用控制台程序，可以参考目录Samples\LobbyServerTest中的文件。
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中的所有文件。
By 北洋小郭
转载请注明出处，请勿用于商业用途，谢谢！
