기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon GameLift 을 Unity 프로젝트에 통합

이 주제에서는 GameLift Unity용 Amazon C# Server SDK 플러그인을 설정하고 게임 프로젝트에 통합하는 방법을 설명합니다.

추가 리소스:

사전 조건

Unity용 Amazon GameLift C# 서버 SDK 플러그인을 사용하려면 다음 구성 요소가 필요합니다.

설정 UnityNuGet

게임 프로젝트에 대해 UnityNuGet 를 설정하지 않은 경우 다음 단계에 따라 Unity 패키지 관리자를 사용하여 도구를 설치합니다. 또는 NuGet CLI를 사용하여 를 수동으로 다운로드할 수 있습니다DLLs. 자세한 내용은 UnitySDK용 Amazon GameLift C# 서버를 참조하세요README.

플러그인 설치

다음 절차에 따라 Unity용 Amazon GameLift C# 서버 SDK 플러그인을 설치하고 log4net 로깅을 구성합니다.

Amazon GameLift 서버는 log4net 프레임워크를 SDK 사용하여 로그 메시지를 출력합니다. 기본적으로 서버 빌드의 터미널에 메시지를 출력하도록 구성되어 있지만 Unity에는 파일 로깅 지원을 추가하기 위한 구성이 필요합니다. Amazon GameLift Server SDK 패키지 내에서 제공된 샘플을 가져와 프로젝트에 이 지원을 추가할 수 있습니다. 다음 절차를 사용하여 샘플을 추가하고 log4net을 구성합니다.

자세한 지침과 테스트 지침에 대한 자세한 내용은 플러그인 다운로드에 있는 README를 참조하세요.

Amazon 설정 GameLift Anywhere 테스트용 플릿

개발 워크스테이션을 Amazon으로 설정할 수 있습니다. GameLift Anywhere 플릿을 호스팅하여 Amazon GameLift 통합을 반복적으로 테스트합니다. 이 설정을 사용하면 워크스테이션에서 게임 서버 프로세스를 시작하고 플레이어 조인 또는 매치메이킹 요청을 Amazon GameLift에 전송하여 게임 세션을 시작하고 클라이언트를 새 게임 세션에 연결할 수 있습니다. 자체 워크스테이션을 호스팅 서버로 설정하면 Amazon 와의 게임 통합의 모든 측면을 모니터링할 수 있습니다 GameLift.

워크스테이션 설정에 대한 지침은 Amazon을 사용하여 로컬 테스트 설정 GameLift Anywhere 섹션을 참조하여 다음 단계를 완료합니다.

Unity 프로젝트에 Amazon GameLift 서버 코드 추가

게임 서버는 Amazon GameLift 서비스와 통신하여 지침을 수신하고 진행 중인 상태를 보고합니다. 이를 위해 Amazon GameLift 서버 를 사용하는 게임 서버 코드를 추가합니다SDK.

제공된 코드 예제는 기본적인 필수 통합 요소를 보여줍니다. MonoBehavior 를 사용하여 Amazon 를 사용한 간단한 게임 서버 초기화를 보여줍니다 GameLift. 이 예제에서는 게임 서버가 Amazon에서 실행된다고 가정합니다. GameLift Anywhere 테스트용 플릿. 여기에는 다음과 같은 코드가 포함됩니다.

이 주제에 제시된 코드는 Amazon GameLift 서비스 및 와의 통신을 설정합니다. 또한 다음의 요청에 응답하는 콜백 함수 집합을 구현합니다. 각 함수와 코드가 수행하는 작업에 대한 자세한 내용은 서버 프로세스 초기화를 참조하세요. 이 코드에 사용되는 SDK 작업 및 데이터 유형에 대한 자세한 내용은 섹션을 참조하세요C# 및 Unity용 Amazon GameLift Server SDK 5.x: 작업.

이 샘플은 GameLift 게임 서버에 Amazon 추가 에 설명된 대로 모든 필수 요소를 추가하는 방법을 보여줍니다. 여기에는 다음이 포함됩니다.

Amazon GameLift 기능 추가에 대한 자세한 내용은 다음 주제를 참조하세요.

using System.Collections.Generic;
using Aws.GameLift.Server;
using UnityEngine;

public class ServerSDKManualTest : MonoBehaviour
{    
    //This example is a simple integration that initializes a game server process 
    //that is running on an Amazon GameLift Anywhere fleet.
    void Start()
    {        
        //Identify port number (hard coded here for simplicity) the game server is listening on for player connections
        var listeningPort = 7777;

        //WebSocketUrl from RegisterHost call
        var webSocketUrl = "wss://us-west-2.api.amazongamelift.com";

        //Unique identifier for this process
        var processId = "myProcess";

        //Unique identifier for your host that this process belongs to
        var hostId = "myHost";

        //Unique identifier for your fleet that this host belongs to
        var fleetId = "myFleet";

        //Authorization token for this host process
        var authToken = "myAuthToken";

        //Server parameters are required for a GameLift Anywhere fleet.
        //They are not required for a GameLift managed EC2 fleet.
        ServerParameters serverParameters = new ServerParameters(
            webSocketUrl,
            processId,
            hostId,
            fleetId,
            authToken);

        //InitSDK establishes a local connection with an Amazon GameLift agent 
        //to enable further communication.
        var initSDKOutcome = GameLiftServerAPI.InitSDK(serverParameters);        
        if (initSDKOutcome.Success)
        {
            //Implement callback functions
            ProcessParameters processParameters = new ProcessParameters(
            //Implement OnStartGameSession callback
                (gameSession) => {
                    //GameLift sends a game session activation request to the game server 
                    //with game session object containing game properties and other settings.
                    //Here is where a game server takes action based on the game session object.
                    //When the game server is ready to receive incoming player connections, 
                    //it invokes the server SDK call ActivateGameSession().
                    GameLiftServerAPI.ActivateGameSession();
                },
                (updateGameSession) => {
                    //GameLift sends a request when a game session is updated (such as for 
                    //FlexMatch backfill) with an updated game session object. 
                    //The game server can examine matchmakerData and handle new incoming players.
                    //updateReason explains the purpose of the update.
                },
                () => {
                    //Implement callback function OnProcessTerminate
                    //GameLift invokes this callback before shutting down the instance hosting this game server.
                    //It gives the game server a chance to save its state, communicate with services, etc., 
                    //and initiate shut down. When the game server is ready to shut down, it invokes the 
                    //server SDK call ProcessEnding() to tell GameLift it is shutting down.
                    GameLiftServerAPI.ProcessEnding();
                }, 
                () => {
                    //Implement callback function OnHealthCheck
                    //GameLift invokes this callback approximately every 60 seconds.
                    //A game server might want to check the health of dependencies, etc.
                    //Then it returns health status true if healthy, false otherwise.
                    //The game server must respond within 60 seconds, or GameLift records 'false'.
                    //In this example, the game server always reports healthy.
                    return true;
                },
                //The game server gets ready to report that it is ready to host game sessions
                //and that it will listen on port 7777 for incoming player connections.
                listeningPort, 
                new LogParameters(new List<string>()
                {
                    //Here, the game server tells GameLift where to find game session log files.
                    //At the end of a game session, GameLift uploads everything in the specified 
                    //location and stores it in the cloud for access later.
                    "/local/game/logs/myserver.log"
                }));

            //The game server calls ProcessReady() to tell GameLift it's ready to host game sessions.
            var processReadyOutcome = GameLiftServerAPI.ProcessReady(processParameters);
            if (processReadyOutcome.Success)
            {
                print("ProcessReady success.");
            }
            else
            {
                print("ProcessReady failure : " + processReadyOutcome.Error.ToString());
            }
        }
        else
        {
            print("InitSDK failure : " + initSDKOutcome.Error.ToString());
        }
    }  

    void OnApplicationQuit()
    {
        //Make sure to call GameLiftServerAPI.ProcessEnding() and GameLiftServerAPI.Destroy() before terminating the server process.
        //These actions notify Amazon GameLift that the process is terminating and frees the API client from memory. 
        GenericOutcome processEndingOutcome = GameLiftServerAPI.ProcessEnding();
        GameLiftServerAPI.Destroy();
        if (processEndingOutcome.Success)
        {
            Environment.Exit(0);
        }
        else
        {
            Console.WriteLine("ProcessEnding() failed. Error: " + processEndingOutcome.Error.ToString());
            Environment.Exit(-1);  
        }
    }
}

추가 리소스

다음 리소스를 사용하여 게임 서버를 테스트하고 기능을 확장합니다.