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

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 Amazon GameLift Servers

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 du serveur, consultez la documentation et SDK du serveur pour les Amazon GameLift Servers versions 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 depuis les versions officielles GitHub .

  1. Procurez-vous le dernier SDK de serveur pour le Amazon GameLift Servers package pour 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 le serveur SDKs 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 prévoyez de déployer la version du serveur de jeu sur une EC2 flotte 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 définit 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 en cours d'exécution, vous devez modifier la manière dont l'application accède à ces ressources. Remplacez l'utilisation de AssumeRoleCredentials par l'action du nouveau 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, consultezCommuniquez avec les autres AWS ressources de vos flottes.

  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#) (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 4.0.2 par défaut). Ce paramètre doit correspondre aux bibliothèques du SDK du serveur présentes dans la version du serveur de jeu. Si vous spécifiez une version incorrecte pour une version de serveur de jeu téléchargée, toutes les flottes que vous créerez avec cette version échoueront. Consultez Déployez un serveur personnalisé conçu pour Amazon GameLift Servers hébergement.

    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 flottes gérées, mettez-les à jour pour utiliser le nouveau processus, comme décrit dansConnectez-vous à distance aux instances Amazon GameLift Servers de flotte.