Migre para o GameLift servidor Amazon 5.x SDK - Amazon GameLift
Sobre o GameLift servidor Amazon SDK 5Atualize seu código de jogo

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 GameLift servidor Amazon 5.x SDK

Seus servidores de jogos hospedados usam o GameLift servidor da Amazon SDK para se comunicar com o GameLift serviço da Amazon para iniciar e gerenciar sessões de jogo para os jogadores. A versão mais recente, Amazon GameLift Server SDK 5, oferece várias melhorias e suporte para novos GameLift recursos da Amazon. Se a versão do seu servidor de jogos atualmente usa o GameLift servidor Amazon SDK 4 ou anterior, siga as orientações neste tópico para atualizar seus jogos.

Sobre o GameLift servidor Amazon SDK 5

A SDK versão 5.0.0 e superior do GameLift servidor Amazon inclui as seguintes atualizações:

  • Linguagens expandidas — As bibliotecas estão disponíveis nos seguintes idiomas: C++, C#, Go. Você pode criar as bibliotecas C++ para uso com o Unreal Engine.

  • Suporte a plug-ins de mecanismos de jogos — Os plug-ins GameLift autônomos da Amazon para Unreal Engine e Unity exigem SDK 5 bibliotecas GameLift do servidor Amazon. Esses plug-ins oferecem fluxos de trabalho guiados para integrar, testar e implantar seus jogos na Amazon GameLift para hospedagem. Consulte Guia do GameLift plugin Amazon para Unity para servidor SDK 5.x e Integrando jogos com o GameLift plugin Amazon para Unreal Engine documente.

  • GameLift AnywhereSuporte da Amazon — Com Anywhere frotas, você pode configurar seus próprios recursos de hospedagem para usar os GameLift recursos da Amazon (incluindo matchmaking). Adicione o Amazon GameLift Agent para automatizar o gerenciamento do ciclo de vida das sessões de jogo. Use Anywhere frotas para hospedagem de produção com hardware local ou configure ambientes de teste para desenvolvimento rápido e iterativo de jogos. Veja Hospedagem Amazon GameLift Anywhere e o GameLiftagente da Amazon.

  • Ferramentas de teste atualizadas — O GameLift Anywhere recurso da Amazon permite que você configure ambientes de teste locais ou baseados na nuvem para seus jogos. Configure o teste com ou sem o Amazon GameLift Agent. Essas ferramentas substituem o Amazon GameLift Local. Consulte Configure testes locais com a Amazon GameLift Anywhere.

  • Consolidado. NETsolução para C# — O servidor C# SDK 5.1+ suporta. NETFramework 4.6.2 (atualizado a partir do 4.6.1) e. NET6.0 em uma única solução. . NETO padrão 2.1 está disponível com as bibliotecas criadas pelo Unity.

  • Novo Compute recurso — Esse novo recurso combina diferentes tipos de recursos de hospedagem. Inclui recursos de hospedagem baseados em nuvem (frotas gerenciadas EC2 ou de contêineres) e recursos de hospedagem controlados pelo cliente (frotas). Anywhere Ele inclui as seguintes atualizações:

    • As novas API chamadas para o Compute recurso incluem: ListCompute(), DescribeCompute() e GetComputeAccess(). Essas ações retornam informações de recursos de hospedagem para qualquer tipo de GameLift frota da Amazon. Em geral, para frotas com servidores de jogos que usam o servidor SDK 5.x, use as ações específicas da computação para substituir as ações específicas da instância. Além disso, essas ações são para uso em Anywhere frotas sem o Amazon GameLift Agent: RegisterCompute(), DeregisterCompute() e GetComputeAuthToken().

    • Nova métrica ActiveCompute com CloudWatch dimensões FleetIdLocation, ComputeType e. Essa métrica substitui a métrica anterior ActiveInstances.

  • Amazon EC2 Systems Manager (SSM) para acesso remoto — Para maior segurança, use SSM em vez de SSH ao se conectar a instâncias em frotas GameLift gerenciadas pela Amazon. Consulte Conecte-se remotamente às instâncias da GameLift frota da Amazon.

Atualize seu código de jogo

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

  1. Obtenha o SDK pacote Amazon GameLift Server mais recente para seu ambiente de desenvolvimento [site de download]. Siga as instruções de instalação no Readme arquivo do pacote e da 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 onCreateGameSession() paraonStartGameSession().

    • Atualize as InitSDK() entradas conforme apropriado:

  3. Se a compilação do seu servidor de jogos ou outros aplicativos hospedados se comunicarem com outros AWS recursos durante a execução, você precisará alterar a forma como o aplicativo obtém acesso a esses recursos. Substitua o uso AssumeRoleCredentials de pela nova SDK ação GameLift do servidor Amazon GetFleetRoleCredentials() (para servidores de jogos) ou use credenciais compartilhadas (para outros aplicativos). Para obter mais informações sobre como implementar essa mudança, consulteComunique-se com outros recursos AWS de suas frotas.

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

  5. Ao fazer o upload da versão do seu jogo para a Amazon GameLift (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 SDK bibliotecas reais do servidor na compilação do servidor do jogo. Se você especificar a versão errada para uma compilação de servidor de jogo carregada, todas as frotas criadas com essa compilação falharão. Consulte Faça o upload de uma versão de servidor personalizada para a Amazon GameLift.

    O exemplo a seguir ilustra como especificar a SDK versão 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 às instâncias da GameLift frota da Amazon