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.
Configurez des tests locaux avec Amazon GameLift Anywhere
Note
Cette rubrique couvre les tests locaux pour les jeux intégrés à la SDK version 5.x GameLift du serveur Amazon. Si votre jeu utilise la SDK version 4.x du serveur ou une version antérieure, consultezTestez votre intégration à l'aide d'Amazon GameLift Local.
Utilisez un Amazon GameLift Anywhere flotte et votre propre matériel pour créer et tester de manière itérative les composants de votre jeu dans un environnement hébergé simulé. Configurez un Anywhere flotte et enregistrez un appareil local pour établir une connexion au GameLift service Amazon. Installez la version intégrée de votre serveur de jeu sur l'appareil, lancez un processus de serveur de jeu et testez les fonctionnalités du jeu selon vos besoins. Vous pouvez mettre à jour la version de votre serveur de jeu aussi souvent que nécessaire pour tester chaque nouvelle itération de version.
Avec un Anywhere flotte, vous pouvez tester en utilisant le AWS CLI ou avec des scripts de test. Si vous avez intégré un client de jeu à Amazon GameLift, vous pouvez exécuter le client sur le même appareil local ou sur un autre appareil.
Tester localement avec un Anywhere fleet est particulièrement utile pour tester l'intégration de votre serveur de jeu avec Amazon GameLift. Vous avez une visibilité complète sur toutes les activités d'hébergement sur la machine locale, ainsi que sur les événements et les données de journalisation.
Note
Utilisez-vous le GameLift plugin Amazon pour Unreal Engine ou Unity ? Ces outils incluent des flux de travail guidés pour configurer des tests locaux avec un Anywhere flotte. Suivez la documentation pour Plugin pour Unity : configurer des tests locaux avec Amazon GameLift Anywhere ouPlugin pour Unreal : configurez des tests locaux avec Amazon GameLift Anywhere.
Rubriques
Configurez un local Anywhere flotte
Suivez ces étapes pour créer un Anywhere flotte pour votre poste de travail local. Pour obtenir des instructions détaillées sur l'utilisation de AWS CLI ou AWS Management Console pour Amazon GameLift, consultezCréez un Amazon GameLift Anywhere flotte.
Pour créer le Anywhere flotte
Créez un emplacement personnalisé pour votre poste de travail local. (AWS CLIou console). Un emplacement personnalisé est simplement une étiquette pour la ressource de calcul que vous prévoyez d'inclure dans votre Anywhere flotte. Les noms de lieux personnalisés doivent commencer par
custom-
. olpPar exemple :custom-my_laptop
. Consultez Créez un emplacement personnalisé.Créez un Anywhere flotte (AWS CLIou console). Au cours de cette étape, créez la ressource de flotte avec l'emplacement personnalisé de votre poste de travail local. Consultez Créez une flotte Anywhere.
Prenez note de l'identifiant ou de la ARN valeur de la nouvelle flotte. Vous aurez besoin de cette valeur à l'étape suivante.
Enregistrez votre station de travail locale en tant que parc informatique (AWS CLIuniquement). Un Anywhere La flotte doit disposer d'au moins une ressource de calcul pour héberger vos serveurs de jeu. Consultez Ajouter un ordinateur à la flotte. Pour ajouter un ordinateur à la flotte, vous avez besoin des informations suivantes :
-
Un nom de calcul. Chaque ordinateur d'un parc doit avoir un nom unique.
-
Le Anywhere identifiant de flotte. Vous pouvez utiliser le
FleetID
ouFleetArn
. -
Les informations de connexion de l'ordinateur. Spécifiez une
IpAddress
ouDnsName
. C'est ainsi qu'Amazon GameLift et les clients du jeu se connecteront aux serveurs de jeux. -
Un emplacement personnalisé dans le Anywhere flotte.
Notez la valeur de
GameLiftServiceSdkEndpoint
retour. Vous aurez besoin de cette valeur lorsque vous mettrez à jour votre serveur de jeu pour qu'il fonctionne sur un Anywhere flotte.-
Mettez à jour et installez votre serveur de jeu
Cette tâche suppose que vous avez déjà intégré une version de serveur de jeu à Amazon GameLift Server SDK 5.x. Le processus d'intégration consiste à ajouter du code à votre serveur de jeu afin qu'il puisse interagir avec le GameLift service Amazon pour démarrer et gérer des sessions de jeu.
Pour un Anywhere flotte, vous devez configurer manuellement certains paramètres du serveur de jeu. Sur un parc GameLift géré par Amazon, ces paramètres sont configurés automatiquement.
Pour préparer votre serveur de jeu à une Anywhere flotte
Obtenez un jeton d'authentification. Votre serveur de jeu doit inclure un jeton d'authentification à chaque communication avec le GameLift service Amazon. Les jetons d' GameLift authentification Amazon sont de courte durée et doivent être régulièrement actualisés.
Il est recommandé de créer un script pour effectuer les tâches suivantes :
Passez à l' AWS CLIaction
get-compute-auth-token
.Stockez la valeur du jeton renvoyée là où les processus du serveur de jeu peuvent la récupérer, par exemple dans une variable d'environnement sur le calcul local.
Installez le script avec votre serveur de jeu sur l'ordinateur. Configurez le script pour qu'il s'exécute avant de démarrer le premier processus du serveur de jeu. Lorsque les processus du serveur de jeu sont actifs, exécutez régulièrement le script pour conserver un jeton d'authentification valide. Tous les processus du serveur de jeu présents sur l'ordinateur peuvent utiliser le même jeton d'authentification.
Mettez à jour le code de votre serveur de GameLift jeu Amazon. Lorsque vous avez intégré le code de votre serveur de jeu au GameLift serveur AmazonSDK, vous avez ajouté un appel à l'action
InitSdk()
. Lorsque le serveur de jeu fonctionne sur un Anywhere flotte, cet appel nécessite des paramètres de serveur supplémentaires. Pour plus d'informations, consultez Initialiser le processus du serveur et le correspondant GameLift Serveur Amazon SDK 5.x à votre langage de développement. Les paramètres du serveur sont les suivants :-
webSocketUrl
— Définissez ce paramètre sur laGameLiftServiceSdkEndpoint
valeur renvoyée lorsque vous enregistrez un calcul auprès de la flotte. -
hostId
— Définissez ce paramètre sur le nom de l'ordinateur que vous spécifiez lorsque vous enregistrez un ordinateur dans le parc Anywhere. -
fleetId
— Réglez ce paramètre sur l'ID du Anywhere flotte. -
authToken
— Définissez ce paramètre sur le jeton renvoyé en réponse à une demande de récupération d'un jeton d'authentification pour un calcul. -
processId
— Définissez ce paramètre pour identifier un processus de serveur de jeu en cours d'exécution sur l'ordinateur local. Chaque processus de serveur de jeu simultané doit avoir un identifiant de processus unique.
Les valeurs des paramètres du serveur utilisées par chaque processus du serveur de jeu doivent être spécifiques au calcul de la flotte Anywhere sur lequel le processus est exécuté. Pour plus de détails sur la façon d'obtenir les valeurs appropriées pour un calcul, consultezAjouter un ordinateur à la flotte. En tant que bonne pratique, définissez
webSocketUrl
,hostId
fleetId
, etauthToken
en tant que variables d'environnement sur le calcul local. Tous les processus du serveur exécutés sur le calcul utiliseront ces valeurs.-
Installez la version du serveur de jeu sur l'ordinateur local. Incluez toutes les dépendances nécessaires au fonctionnement du serveur de jeu.
Démarrez un ou plusieurs processus du serveur de jeu exécutés sur l'ordinateur local. Lorsque le processus du serveur de jeu appelle l'SDKaction du serveur
ProcessReady()
, le processus est prêt à héberger une session de jeu.
Testez l'activité des sessions de jeu
Testez l'intégration de votre serveur de jeu en utilisant des sessions de jeu. Si aucun client de jeu n'est intégré aux GameLift fonctionnalités Amazon, vous pouvez l'utiliser AWS CLI pour démarrer des sessions de jeu. Essayez les scénarios suivants :
Créez une session de jeu. create-game-session
Commande d'appel (ou CreateGameSessionAPIopération). Spécifiez votre Anywhere identifiant de la flotte et emplacement personnalisé. Cet appel renvoie un identifiant unique pour la nouvelle session de jeu. Vérifiez l'état de la session de jeu.Appelez describe-game-sessions
la commande (ou l'DescribeGameSessionsAPIaction). Spécifiez l'identifiant de session de jeu. Cet appel renvoie des informations détaillées sur la session de jeu, y compris le statut de la session de jeu. Les sessions de jeu en statut Actif sont prêtes à être connectées par les joueurs. Pour obtenir la liste de toutes les sessions de jeu de la flotte, appelez la list-game-sessions commande (ou l'ListGameSessionsAPIaction). -
Connectez-vous à la session de jeu. Si votre client de jeu est en mesure de rejoindre une session de jeu, utilisez les informations de connexion incluses dans les informations de session de jeu.
Itérez sur votre serveur de jeu
Vous pouvez utiliser le même Anywhere flotte et calcul pour tester d'autres versions de la version de votre serveur de jeu.
-
Nettoyez votre existant
GameSession
. Si le processus du serveur de jeu plante ou refuse d'appelerProcessEnding()
, Amazon GameLift nettoie le système uneGameSession
fois que le serveur de jeu a cessé d'envoyer des bilans de santé. -
Générez une nouvelle version de serveur de jeu. Apportez des modifications à votre serveur de jeu et empaquetez une version révisée.
-
Mettez à jour la version du serveur de jeu sur votre ordinateur local. Votre précédent Anywhere la flotte est toujours active et votre ordinateur portable est toujours enregistré en tant que ressource informatique dans la flotte.
-
Obtenez un jeton d'autorisation mis à jour. Appelez la get-compute-auth-token
CLIcommande et stockez le jeton sur l'ordinateur local. -
Démarrez un ou plusieurs processus du serveur de jeu exécutés sur l'ordinateur local. Lorsque le serveur de jeu traite les appels
ProcessReady()
, il est prêt à être utilisé pour les tests.
Transférez votre jeu vers les flottes GameLift gérées par Amazon
Une fois que vous avez terminé les tests de développement et que vous êtes prêt à préparer le lancement, c'est le bon moment pour passer aux flottes GameLift gérées par Amazon. Utilisez des flottes gérées pour affiner et tester les ressources d'hébergement de vos jeux. Mettez en œuvre votre solution de placement de sessions de jeu (files d'attente et entremetteurs), sélectionnez le matériel d'hébergement (y compris les flottes Spot) et les emplacements optimaux, et choisissez une stratégie pour augmenter la capacité. Vous pouvez également commencer à les utiliser AWS CloudFormation pour gérer plus efficacement les cycles de vie de toutes vos ressources d'hébergement de jeux, y compris les flottes, les files d'attente et les entremetteurs.
Vous devez apporter quelques modifications mineures pour passer d'une version locale Anywhere testez votre flotte par rapport à une flotte GameLift gérée par Amazon. Vous pouvez réutiliser les mêmes files d'attente et les mêmes entremetteurs. Effectuez les tâches suivantes :
-
Changez l'appel du code du serveur de jeu en
InitSdk()
. Supprimez les paramètres du serveur. Dans le cas d'un parc géré, Amazon suit GameLift automatiquement ces informations. -
Créez une ressource de GameLift compilation Amazon. Avec un Anywhere testez votre flotte, vous devez déployer manuellement la version de votre serveur de jeu et ses dépendances sur le calcul de chaque flotte. Avec une flotte gérée, vous créez et téléchargez votre package de développement de jeu sur Amazon GameLift, qui le déploie automatiquement sur tous les ordinateurs de la flotte. Consultez Déployez une version de serveur personnalisée pour l' GameLifthébergement Amazon pour en savoir plus sur l'empaquetage des fichiers de compilation de votre jeu et la création d'une ressource de compilation avec des fichiers dans un compartiment Amazon S3. N'incluez pas de scripts qui enregistrent un calcul et obtiennent un jeton d'authentification, car Amazon gère GameLift automatiquement ces tâches avec des flottes gérées.
-
Créez une flotte gérée. Créez une flotte à l'aide de la console ou AWS CLI en spécifiant une flotte EC2 gérée. Ce type de parc nécessite des paramètres de configuration supplémentaires, notamment la spécification des ressources de construction et des types d'instances. Vous devez tous configurer une configuration d'exécution pour gérer le cycle de vie du serveur de jeu sur chaque parc informatique. Consultez Créez une EC2 flotte GameLift gérée par Amazon pour plus de détails sur la création d'une flotte gérée.
-
Redirigez les alias de flotte (facultatif). Si vous configurez des alias à utiliser avec votre Anywhere flottes, vous pouvez réutiliser les mêmes alias pour vos flottes gérées. Consultez Création d'un GameLift alias Amazon pour plus de détails sur la création ou la mise à jour d'un alias.