View a markdown version of this page

Migrer vers le SDK 5.x du serveur pour GameLift Serveurs Amazon - GameLift Serveurs Amazon

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Migrer vers le SDK 5.x du serveur pour GameLift Serveurs Amazon

Pour mettre à jour un projet de jeu afin d'utiliser la version 5.x du SDK du serveur, apportez les modifications suivantes :

Note

Si vous devez continuer à utiliser la version 4.x ou antérieure du SDK serveur, consultez la documentation et SDK de serveur pour GameLift Serveurs Amazon version 4 et antérieures les informations de téléchargement. Pour la version 4.0.2 du SDK en particulier, vous pouvez le télécharger à partir des versions officielles GitHub .

  1. Téléchargez le dernier Amazon GameLift Servers package SDK pour serveur adapté à votre environnement de développement [Site de téléchargement]. Suivez les instructions d'installation figurant dans le Readme fichier correspondant au package et à la version que vous avez téléchargés. Consultez ces instructions pour utiliser les SDK du serveur avec votre projet de jeu.

  2. Mettez à jour le code de votre serveur comme suit :

    • Remplacez la fonction de rappel du code du serveur paronCreateGameSession(). onStartGameSession()

    • Mettez à jour les InitSDK() entrées comme il convient :

      • Si vous envisagez de déployer la version du serveur de jeu sur une flotte EC2 Amazon GameLift Servers gérée ou sur une flotte Anywhere avec l'Amazon GameLift Serversagent :

        Appel InitSDK() sans paramètres (C++) (C#) (Unreal). Cet appel configure l'environnement informatique et une WebSocket connexion au Amazon GameLift Servers service.

      • Si vous envisagez de déployer la version du serveur de jeu sur une flotte Anywhere sans l'Amazon GameLift Serversagent :

        Appel InitSDK() avec les paramètres du serveur (C++) (C#) (Unreal). Un processus de serveur de jeu utilise ces paramètres pour établir une connexion avec le Amazon GameLift Servers service.

  3. Si la version de votre serveur de jeu ou d'autres applications hébergées communiquent avec d'autres AWS ressources pendant l'exécution, vous devrez modifier la façon dont l'application accède à ces ressources. Remplacez l'utilisation de AssumeRoleCredentials par la nouvelle action du SDK du serveur GetFleetRoleCredentials() (pour les serveurs de jeux) ou utilisez des informations d'identification partagées (pour les autres applications). Pour en savoir plus sur la mise en œuvre de cette modification, consultezConnectez votre GameLift Serveurs Amazon serveur de jeu hébergé vers un autre AWS resources.

  4. Si votre projet a appelé l'action du SDK du serveur GetInstanceCertificate() pour récupérer un certificat TLS, modifiez votre code pour utiliser le nouveau GetComputeCertificate() (C++) (C#) (GetComputeCertificate()Unreal) à la place.

  5. Lorsque vous téléchargez la version de votre jeu vers Amazon GameLift Servers (par exemple avec upload-build ou CreateBuild ()), définissez le ServerSdkVersion paramètre sur la version 5.x que vous utilisez (ce paramètre est actuellement par défaut 4.0.2). Ce paramètre doit correspondre aux bibliothèques de SDK du serveur réelles dans la version du serveur de jeu. Si vous spécifiez la mauvaise version pour une version de serveur de jeu téléchargée, toutes les flottes que vous créez avec cette version échoueront. Consultez Créez un serveur de jeu conçu pour GameLift Serveurs Amazon.

    L'exemple suivant montre comment spécifier la version du SDK du serveur : 

    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. Si vous utilisez des scripts pour vous connecter à distance à des parcs gérés, mettez-les à jour pour utiliser le nouveau processus, comme décrit dansConnectez-vous aux instances de flotte.