Migre para o SDK 5.x do servidor para 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á.

Migre para o SDK 5.x do servidor para 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:

  1. Obtenha o SDK de servidor mais recente para Amazon GameLift Servers pacote 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 o servidor SDKs com seu 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 o servidor do jogo, construa em um Amazon GameLift Servers EC2 frota gerenciada ou uma frota Anywhere com o Amazon GameLift Servers Agente:

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

      • Se você planeja implantar o servidor do jogo, crie uma frota Anywhere sem o Amazon GameLift Servers Agente:

        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 Amazon GameLift Servers serviço.

  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 do SDK do servidor GetFleetRoleCredentials() (para servidores de jogos) ou use credenciais compartilhadas (para outros aplicativos). Para obter mais informações sobre como implementar essa alteração, consulte Comunique-se com outros AWS recursos de suas frotas.

  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 o upload da versão do seu jogo para Amazon GameLift Servers (como com upload-build ou CreateBuild()), defina o ServerSdkVersion parâmetro para a versão 5.x que você está usando (esse parâmetro atualmente é 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 Implemente uma criação de servidor personalizada para Amazon GameLift Servers hospedagem.

    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 Conecte-se remotamente a Amazon GameLift Servers instâncias de frota.