Migrar para o SDK 5.x do servidor para o Amazon GameLift Servers - 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á.

Migrar para o SDK 5.x do servidor para o Amazon GameLift Servers

Para atualizar um projeto de jogo para usar o SDK versão 5.x do servidor, faça as seguintes alterações:

nota

Se você precisar continuar usando o SDK do servidor versão 4.x ou anterior, consulte SDK do servidor para a versão 4 ou anterior do Amazon GameLift Servers para a documentação e informações do download. Para o SDK versão 4.0.2 especificamente, você pode baixá-lo nas versões oficiais do GitHub.

  1. Obtenha o SDK de servidor mais recente para o pacote do Amazon GameLift Servers para seu ambiente de desenvolvimento [Site de download]. Siga as instruções de instalação no arquivo Readme para o pacote e a versão baixados. Veja essas instruções para usar os SDKs do servidor com o projeto de jogo.

  2. Atualize o código do servidor da seguinte forma:

    • Altere a função de retorno de chamada do código do servidor de onCreateGameSession() para onStartGameSession().

    • Atualize as entradas InitSDK() conforme apropriado:

      • Se você planeja implantar a compilação do servidor de jogos em uma frota do EC2 gerenciada pelo Amazon GameLift Servers ou em uma frota Anywhere com o Amazon GameLift Servers Agent:

        Chame InitSDK() sem parâmetros (C++) (C#) (Unreal). Essa chamada configura o ambiente de computação e uma conexão WebSocket com o serviço do Amazon GameLift Servers.

      • Se você planeja implantar a compilação do servidor de jogo em uma frota Anywhere sem o Amazon GameLift Servers Agent:

        Chame InitSDK() com parâmetros do servidor (C++) (C#) (Unreal). Um processo de servidor de jogos usa esses parâmetros para estabelecer uma conexão com o serviço do Amazon GameLift Servers.

  3. Se a compilação do servidor de jogos ou outras aplicações hospedadas se comunicarem com outros recursos da AWS durante a execução, será necessário alterar a forma como a aplicação obtém acesso a esses recursos. Substitua o uso de AssumeRoleCredentials pela nova ação GetFleetRoleCredentials() do SDK do servidor (para servidores de jogos) ou use credenciais compartilhadas (para outras aplicações). Para obter mais informações sobre como implementar essa alteração, consulte Conecte seu servidor de jogos Amazon GameLift Servers hospedado a outros AWS recursos.

  4. Se o projeto chamou a ação GetInstanceCertificate() do SDK do servidor para recuperar um certificado TLS, modifique o código para usar o novo GetComputeCertificate() (C++) (C#) (Unreal).

  5. Ao fazer upload da compilação do jogo no Amazon GameLift Servers (como com upload-build ou CreateBuild()), defina o parâmetro ServerSdkVersion para a versão 5.x que você está usando (esse parâmetro atualmente está padronizado como 4.0.2). Esse parâmetro deve corresponder às bibliotecas reais do SDK do servidor na compilação do servidor de jogos. Se você especificar a versão errada para uma compilação de servidor de jogos carregada, todas as frotas criadas com essa compilação falharão. Consulte Criar uma compilação personalizada do servidor de jogos para o Amazon GameLift Servers.

    O exemplo a seguir ilustra como especificar a versão do SDK do servidor: 

    aws gamelift upload-build \
    --operating-system AMAZON_LINUX_2023 \
    --server-sdk-version "5.0.0" \
    --build-root "~/mygame" \
    --name "My Game Nightly Build" \
    --build-version "build 255" \
    --region us-west-2

  6. Se você usa scripts para se conectar remotamente a frotas gerenciadas, atualize os scripts para usar o novo processo, conforme descrito em Conectar-se remotamente às instâncias da frota do Amazon GameLift Servers.