GameLift Serveur Amazon SDK pour Unreal Engine : types de données - Amazon GameLift

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.

GameLift Serveur Amazon SDK pour Unreal Engine : types de données

Utilisez le GameLift serveur Amazon SDK pour Unreal Reference afin d'intégrer votre jeu multijoueur à des fins d'hébergement sur Amazon GameLift. Pour obtenir des conseils sur le processus d'intégration, consultezAjoutez Amazon GameLift à votre serveur de jeu.

Note

Cette référence concerne une version antérieure du GameLift serveur AmazonSDK. Pour obtenir la dernière version, consultez .

Ceci API est défini dans GameLiftServerSDK.h etGameLiftServerSDKModels.h.

Pour configurer le plug-in Unreal Engine et consulter des exemples de code Intégrer Amazon GameLift dans un projet Unreal Engine.

GameLift Serveur Amazon SDK pour Unreal Engine : actions

FDescribePlayerSessionsRequest

Ce type de données est utilisé pour spécifier les sessions de joueur à récupérer. Vous pouvez l'utiliser comme suit :

  • Fournissez un PlayerSessionId pour demander une session de joueur spécifique.

  • Indiquez un GameSessionId pour demander toutes les sessions des joueurs dans la session de jeu spécifiée.

  • Fournissez un PlayerId pour demander toutes les sessions de joueur pour le joueur spécifié.

Pour les volumes importants de sessions de joueur, utilisez les paramètres de pagination pour récupérer les résultats en tant que blocs séquentiels.

Table des matières

GameSessionId

Identifiant de session de jeu unique. Utilisez ce paramètre pour demander toutes les sessions de joueur pour la session de jeu spécifiée. Le format de l'ID de session de jeu est le suivant : arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. La valeur de <ID string> peut être une chaîne d'ID personnalisée ou (si spécifiée lors de la création de la session de jeu) une chaîne générée automatiquement.

Type : chaîne

Obligatoire : non

Limite

Nombre maximum de résultats à renvoyer. Utilisez ce paramètre avec NextTokenpour obtenir des résultats sous la forme d'un ensemble de pages séquentielles. Si un ID de session de joueur est spécifié, ce paramètre est ignoré.

Type : entier

Obligatoire : non

NextToken

Jeton indiquant le début de la prochaine page séquentielle de résultats. Utilisez le jeton qui est renvoyé par un appel précédent à cette action. Pour spécifier le début de l'ensemble de résultats, ne spécifiez aucune valeur. Si un ID de session de joueur est spécifié, ce paramètre est ignoré.

Type : chaîne

Obligatoire : non

PlayerId

Identifiant unique pour un joueur. IDsLes joueurs sont définis par le développeur. Consultez Générer des identifiants de joueurs.

Type : chaîne

Obligatoire : non

PlayerSessionId

Identifiant unique d'une session de joueur.

Type : chaîne

Obligatoire : non

PlayerSessionStatusFilter

État de session de joueur pour filtrer les résultats. Les états de session de joueur possibles sont les suivants :

  • RESERVED— La demande de session du joueur a été reçue, mais le joueur ne s'est pas encore connecté au processus du serveur et/ou n'a pas encore été validé.

  • ACTIVE— Le joueur a été validé par le processus du serveur et est actuellement connecté.

  • COMPLETED— La connexion du joueur a été interrompue.

  • TIMEDOUT— Une demande de session de joueur a été reçue, mais le joueur ne s'est pas connecté et/ou n'a pas été validé dans le délai imparti (60 secondes).

Type : chaîne

Obligatoire : non

FProcessParameters

Ce type de données contient l'ensemble de paramètres envoyés au GameLift service Amazon lors d'un ProcessReady() appel.

Table des matières

port

Numéro de port sur lequel le processus serveur écoute les nouvelles connexions de joueur. La valeur doit être comprise dans la plage de ports configurée pour toutes les flottes déployant cette version de génération du serveur de jeux. Ce numéro de port est inclus dans les objets de session de jeu et de session de joueur, que les sessions de jeu utilisent pour se connecter à un processus serveur.

Type : entier

Obligatoire : oui

logParameters

Objet comportant une liste de chemins de répertoires vers les fichiers journaux de sessions de jeu.

Type : TArray < FString >

Obligatoire : non

onStartGameSéance

Nom de la fonction de rappel invoquée par le GameLift service Amazon pour activer une nouvelle session de jeu. Amazon GameLift appelle cette fonction en réponse à la demande du client CreateGameSession. La fonction de rappel prend un GameSessionobjet (défini dans le Amazon GameLift Service API Reference).

Type : FOnStartGameSession

Obligatoire : oui

onProcessTerminate

Nom de la fonction de rappel invoquée par le GameLift service Amazon pour forcer le processus du serveur à s'arrêter. Après avoir appelé cette fonction, Amazon GameLift attend cinq minutes que le processus du serveur s'arrête et répond par un ProcessEnding() appel avant d'arrêter le processus du serveur.

Type : FSimpleDelegate

Obligatoire : non

onHealthCheck

Nom de la fonction de rappel invoquée par le GameLift service Amazon pour demander un rapport d'état de santé au processus du serveur. Amazon GameLift appelle cette fonction toutes les 60 secondes. Après avoir appelé cette fonction, Amazon GameLift attend 60 secondes pour obtenir une réponse, et si aucune n'est reçue, enregistre le processus du serveur comme étant défectueux.

Type : FOnHealthCheck

Obligatoire : non

onUpdateGameSéance

Nom de la fonction de rappel invoquée par le GameLift service Amazon pour transmettre un objet de session de jeu mis à jour au processus du serveur. Amazon GameLift appelle cette fonction lorsqu'une demande de mise en correspondance a été traitée afin de fournir des données de matchmaking mises à jour. Il transmet un GameSessionobjet, une mise à jour de statut (updateReason) et l'identifiant du ticket de remplacement des matchs.

Type : FOnUpdateGameSession

Obligatoire : non

FStartMatchBackfillRequest

Ce type de données est utilisé pour envoyer une requête de renvoi de correspondance. Les informations sont communiquées au GameLift service Amazon lors d'un StartMatchBackfill() appel.

Table des matières

GameSessionArn

Identifiant de session de jeu unique. L'APIaction GetGameSessionId() renvoie l'identifiant au ARN format.

Type : FString

Obligatoire : oui

MatchmakingConfigurationArn

Identifiant unique, sous la forme d'unARN, que le système de jumelage doit utiliser pour cette demande. Pour trouver le matchmaker qui a été utilisé pour créer la session de jeu d'origine, recherchez dans l'objet de session de jeu, dans la propriété de données de matchmaker. Pour en savoir plus sur les données du système de jumelage, consultez la section Travailler avec les données du système de jumelage.

Type : FString

Obligatoire : oui

Joueurs

Ensemble de données représentant tous les joueurs qui sont actuellement dans la session de jeu. Le matchmaker utilise ces informations pour rechercher de nouveaux joueurs qui constituent de bonnes correspondances pour les joueurs actuels. Consultez le guide de GameLift API référence Amazon pour obtenir une description du format d'objet Player. Pour trouver les attributs des joueurs et les affectations des équipes, recherchez dans l'objet de la session de jeu, dans la propriété des données du système de matchmaking. IDs Si une latence est utilisée par le matchmaker, collectez la latence mise à jour pour la région actuelle et incluez-la dans les données de chaque joueur.

Type : TArray < FPlayer >

Obligatoire : oui

TicketId

Identifiant unique pour une correspondance ou un ticket de requête de renvoi de correspondance. Si aucune valeur n'est fournie ici, Amazon en GameLift générera une sous la forme d'unUUID. Utilisez cet identifiant pour suivre l'état du ticket de renvoi de correspondance ou annuler la requête si nécessaire.

Type : FString

Obligatoire : non

FStopMatchBackfillRequest

Ce type de données est utilisé pour annuler une demande de renvoi de correspondance. Les informations sont communiquées au GameLift service Amazon lors d'un StopMatchBackfill() appel.

Table des matières

GameSessionArn

Identifiant de session de jeu unique associé à la requête en cours d'annulation.

Type : FString

Obligatoire : oui

MatchmakingConfigurationArn

Identifiant unique du matchmaker auquel cette requête a été envoyée.

Type : FString

Obligatoire : oui

TicketId

Identifiant unique d'un ticket de requête de correspondance à annuler.

Type : FString

Obligatoire : oui