Amazon GameLift ServersIntegre-se a um projeto Unity - Amazon GameLift Servers

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Amazon GameLift ServersIntegre-se a um projeto Unity

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

Dica

Para uma implantação mais rápida, experimente o plug-in Amazon GameLift Servers autônomo para 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 Serversplugin para Unity (servidor SDK 5.x).

Recursos adicionais:

Instale o SDK do servidor para Unity

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

Configure uma frota Amazon GameLift Servers Anywhere para testes

Você pode configurar sua estação de trabalho de desenvolvimento como uma frota de hospedagem Amazon GameLift Servers Anywhere para testar iterativamente sua Amazon GameLift Servers integração. Com esta configuração, você pode iniciar os processos do servidor de jogos em sua estação de trabalho, enviar solicitações de ingresso ou matchmaking de jogadores 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 comAmazon GameLift Servers.

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

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

  2. Crie uma frota Amazon GameLift Servers em qualquer lugar 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 WebSocket URL. 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 Amazon GameLift Servers serviço. 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 Amazon GameLift Servers o código do servidor ao seu projeto Unity

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

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. Amazon GameLift Servers O exemplo pressupõe que o servidor do jogo seja executado em uma frota Amazon GameLift Servers Anywhere para testes. Inclui código para:

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

  • Implemente funções de retorno de chamada para responder às solicitações do Amazon GameLift Servers serviçoOnStartGameSession, incluindoOnProcessTerminate, e. onHealthCheck

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

O código de amostra fornecido estabelece a comunicação com o Amazon GameLift Servers serviço. Ele também implementa um conjunto de funções de retorno de chamada que respondem às solicitações do Amazon GameLift Servers serviço. 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 5.x do servidor C# para Amazon GameLift Servers -- Ações.

O código de amostra mostra como adicionar a funcionalidade necessária, conforme descrito em Adicionar Amazon GameLift Servers ao seu servidor de jogo. Para obter mais informações sobre as ações do SDK do servidor, consulte o. SDK 5.x do servidor C# para Amazon GameLift Servers -- 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 hospedagemAmazon GameLift Servers, considere estas possíveis próximas etapas: