本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
将亚马逊 GameLift 与 Unity 游戏服务器项目集成
注意
本主题可帮助您为在 Amazon 上托管的自定义游戏服务器做好准备 GameLift。游戏服务器必须能够 GameLift 通知Amazon其状态,在出现提示时启动和停止游戏会话以及执行其他任务。有关更多信息,请参阅将 Amazon GameLift 添加到您的游戏服务器。
先决条件
在集成游戏服务器之前,请完成以下任务:
设置新的服务器进程
设置与 Amazon 的通信 GameLift 并报告服务器进程已准备好托管游戏会话。
-
通过调用
InitSDK()
初始化服务器软件开发工具包。 -
要让服务器做好接受游戏会话的准备,调用
ProcessReady()
以及连接端口和游戏会话位置的详细信息。包括 Amazon GameLift 服务调用的回调函数的名称,例如、OnGameSession()
、OnGameSessionUpdate()
、OnProcessTerminate()
。OnHealthCheck()
Amazon GameLift 可能需要几分钟才能提供回调。 -
Amazon 将服务器进程的状态 GameLift 更新为
ACTIVE
。 -
亚马逊
onHealthCheck
会定期致 GameLift 电。
以下代码示例展示了如何使用 Amazon 设置简单的服务器进程 GameLift。
//initSDK var initSDKOutcome = GameLiftServerAPI.InitSDK(); //processReady // Set parameters and call ProcessReady var processParams = new ProcessParameters( this.OnGameSession, this.OnProcessTerminate, this.OnHealthCheck, this.OnGameSessionUpdate, port, // Examples of log and error files written by the game server new LogParameters(new List<string>() { "C:\\game\\logs", "C:\\game\\error" }) ); var processReadyOutcome = GameLiftServerAPI.ProcessReady(processParams); // Implement callback functions void OnGameSession(GameSession gameSession) { // game-specific tasks when starting a new game session, such as loading map // When ready to receive players var activateGameSessionOutcome = GameLiftServerAPI.ActivateGameSession(); } void OnProcessTerminate() { // game-specific tasks required to gracefully shut down a game session, // such as notifying players, preserving game state data, and other cleanup var ProcessEndingOutcome = GameLiftServerAPI.ProcessEnding(); } bool OnHealthCheck() { bool isHealthy; // complete health evaluation within 60 seconds and set health return isHealthy; }
启动游戏会话
游戏初始化完成后,您可以开始游戏会话。
-
实现回调函数
onStartGameSession
。Amazon GameLift 调用此方法在服务器进程上启动新的游戏会话并接收玩家连接。 -
要激活游戏会话,请调用
ActivateGameSession()
。有关软件开发工具包的更多信息,请参阅 Amazon GameLift 服务器软件开发工具包 (C#) 参考:操作。
以下代码示例说明了如何通过 Amazon 启动游戏会话 GameLift。
void OnStartGameSession(GameSession gameSession) { // game-specific tasks when starting a new game session, such as loading map ... // When ready to receive players var activateGameSessionOutcome = GameLiftServerAPI.ActivateGameSession(); }
结束游戏会话
游戏会话结束 GameLift 时通知亚马逊。最佳实操是在游戏会话完成后关闭服务器进程,以回收和刷新托管资源。
-
设置一个名为的函数
onProcessTerminate
以接收来自 Amazon 的请求 GameLift 并调用ProcessEnding()
。 -
进程状态更改为
TERMINATED
。
以下示例描述了如何结束游戏会话的进程。
var processEndingOutcome = GameLiftServerAPI.ProcessEnding(); if (processReadyOutcome.Success) Environment.Exit(0); // otherwise, exit with error code Environment.Exit(errorCode);
创建服务器、构建并上传到 Amazon GameLift
将游戏服务器与 Amazon 集成后 GameLift,将构建文件上传到队列中,以便亚马逊 GameLift 可以将其部署用于游戏托管。有关如何将服务器上传到 Amazon 的更多信息 GameLift,请参阅将自定义服务器构建上传到 Amazon GameLift。