Integre Amazon GameLift Servers em um projeto do Unity - Amazon GameLift Servers

Integre Amazon GameLift Servers em um projeto do Unity

Aprenda a integrar o Amazon GameLift Servers SDK para o Unity em seus projetos de jogos para acessar o conjunto completo de atributos do SDK do servidor.

Dica

Para uma implantação mais rápida, experimente o plug-in independente do Amazon GameLift Servers para o Unity. Ele fornece fluxos de trabalho de interface de usuário guiados para implantar rapidamente seu servidor de jogos com configuração mínima, para que você possa testar os componentes do jogo em ação. Consulte Amazon GameLift ServersPlug-in para Unity (SDK 5.x de servidor).

Recursos adicionais:

Instalar o SDK do servidor para o Unity

Obtenha o código aberto Amazon GameLift Servers para o Unity no GitHub. Os arquivos readme do repositório contêm pré-requisitos e instruções de instalação.

Configure uma frota do Amazon GameLift Servers Anywhere para testes

Você poderá configurar sua estação de trabalho de desenvolvimento como uma frota de hospedagem do Amazon GameLift Servers Anywhere para testar iterativamente sua integração com o Amazon GameLift Servers. Com essa configuração, você pode iniciar os processos do servidor de jogos em sua estação de trabalho, enviar solicitações de junção de jogadores ou de criação de partidas ao Amazon GameLift Servers para iniciar sessões de jogo e conectar clientes às novas sessões de jogo. Com sua própria estação de trabalho configurada como servidor de hospedagem, você pode monitorar todos os aspectos da integração do seu jogo com o Amazon GameLift Servers.

Para obter instruções sobre como configurar sua estação de trabalho, consulte Configurar testes locais com o Amazon GameLift Servers Anywhere para concluir as seguintes etapas:

  1. Crie um local personalizado para sua estação de trabalho.

  2. Crie uma frota do Amazon GameLift Servers Anywhere com sua nova localização personalizada. Se for bem-sucedida, essa solicitação retornará um ID da frota. Anote esse valor, pois você precisará disso mais tarde.

  3. Registre sua estação de trabalho como uma computação na nova frota Anywhere. Forneça um nome de computação exclusivo e especifique o endereço IP da sua estação de trabalho. Se for bem-sucedida, essa solicitação retornará um endpoint do SDK de serviço, na forma de uma URL do WebSocket. Anote esse valor, pois você precisará disso mais tarde.

  4. Gere um token de autenticação para a computação da sua estação de trabalho. Essa autenticação de curta duração inclui o token e uma data de expiração. Seu servidor de jogo o usa para autenticar a comunicação com o serviço do Amazon GameLift Servers. Armazene a autenticação no computador da sua estação de trabalho para que os processos do servidor de jogos em execução possam acessá-la.

Adicione o código do servidor do Amazon GameLift Servers ao seu projeto Unity

Seu servidor de jogo se comunica com o serviço do Amazon GameLift Servers para receber instruções e relatar o status contínuo. Para fazer isso, você adiciona um código de servidor de jogos que usa o SDK do servidor do Amazon GameLift Servers.

O exemplo de código fornecido ilustra os elementos básicos de integração necessários. Ele usa um MonoBehavior para ilustrar uma inicialização simples do servidor de jogos com o Amazon GameLift Servers. O exemplo pressupõe que o servidor do jogo seja executado em uma frota do Amazon GameLift Servers Anywhere para testes. Inclui código para:

  • Inicialize um cliente da API do Amazon GameLift Servers. A amostra usa a versão de InitSDK() com parâmetros do servidor para sua frota Anywhere e computação. Use o URL do WebSocket, o ID da frota, o nome do computador (ID do host) e o token de autenticação, conforme definido no tópico anterior Configure uma frota do Amazon GameLift Servers Anywhere para testes.

  • Implemente funções de retorno de chamada para responder às solicitações do serviço do Amazon GameLift Servers, inclusive OnStartGameSession, OnProcessTerminate e onHealthCheck.

  • Chame ProcessReady () com uma porta designada para notificar o serviço do Amazon GameLift Servers quando o processo estiver pronto para hospedar sessões de jogo.

O código de amostra fornecido estabelece a comunicação com o serviço do Amazon GameLift Servers. Ele também implementa um conjunto de funções de retorno de chamada que respondem às solicitações do Amazon GameLift Servers. Para obter mais informações sobre cada função e o que o código faz, consulte Inicializar o processo do servidor. Para obter mais informações sobre as ações do SDK e os tipos de dados usados nesse código, leia SDK do servidor C# para Amazon GameLift Servers 5.x – Ações.

O código de exemplo mostra como adicionar a funcionalidade necessária, conforme descrito em Adicionar Amazon GameLift Servers ao seu servidor de jogos. Para ter mais informações sobre as ações de SDK, consulte SDK do servidor C# para Amazon GameLift Servers 5.x – Ações.

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 Servers 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 an Amazon GameLift Servers Anywhere fleet. //They are not required for an Amazon GameLift Servers managed EC2 fleet. ServerParameters serverParameters = new ServerParameters( webSocketUrl, processId, hostId, fleetId, authToken); //InitSDK establishes a local connection with an Amazon GameLift Servers agent //to enable further communication. var initSDKOutcome = GameLiftServerAPI.InitSDK(serverParameters); if (initSDKOutcome.Success) { //Implement callback functions ProcessParameters processParameters = new ProcessParameters( //Implement OnStartGameSession callback (gameSession) => { //Amazon GameLift Servers 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) => { //Amazon GameLift Servers 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 //Amazon GameLift Servers 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 Amazon GameLift Servers it is shutting down. GameLiftServerAPI.ProcessEnding(); }, () => { //Implement callback function OnHealthCheck //Amazon GameLift Servers 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 Amazon GameLift Servers 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 Amazon GameLift Servers where to find game session log files. //At the end of a game session, Amazon GameLift Servers 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 Amazon GameLift Servers 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 Servers 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); } } }

Próximas etapas

Agora que você preparou uma versão de servidor de jogos com a funcionalidade mínima necessária para hospedagem com o Amazon GameLift Servers, considere estas possíveis próximas etapas: