Référence GameLift du serveur Amazon SDK (Go) : types de données

Vous pouvez utiliser cette SDK référence de serveur Amazon GameLift Go pour vous aider à préparer votre jeu multijoueur en vue de son utilisation avec Amazon GameLift. Pour plus de détails sur le processus d'intégration, consultezAjoutez Amazon GameLift à votre serveur de jeu.

LogParameters

Un objet identifiant les fichiers générés au cours d'une session de jeu que vous souhaitez qu'Amazon télécharge et stocke GameLift à la fin de la session de jeu. Le serveur de jeu fournit LogParameters à Amazon dans GameLift le cadre d'un ProcessParameters objet lors d'un ProcessReady() appel.

Propriétés

Description

LogPaths

La liste des chemins de répertoire vers les fichiers journaux du serveur de jeu que vous souhaitez qu'Amazon GameLift stocke pour un accès futur. Le processus du serveur génère ces fichiers lors de chaque session de jeu. Vous définissez les chemins et les noms des fichiers sur votre serveur de jeu et vous les stockez dans le répertoire racine du jeu. Les chemins du journal doivent être absolus. Par exemple, si votre build de jeu stocke les journaux de session de jeu dans un chemin tel queMyGame\sessionLogs\, alors le chemin se c:\game\MyGame\sessionLogs trouve sur une instance Windows. Type : []string Obligatoire : non

ProcessParameters

Objet décrivant la communication entre un processus serveur et Amazon GameLift. Le processus du serveur fournit ces informations GameLift à Amazon en appelantProcessReady().

Propriétés	Description
LogParameters	Objet avec des chemins de répertoire vers des fichiers générés au cours d'une session de jeu. Amazon GameLift copie et stocke les fichiers pour un accès futur. Type : LogParameters Obligatoire : non
OnHealthCheck	Fonction de rappel GameLift invoquée par Amazon pour demander un rapport d'état de santé au processus du serveur. Amazon GameLift appelle cette fonction toutes les 60 secondes et attend une réponse pendant 60 secondes. Le processus du serveur revient TRUE s'il est sain, FALSE sinon sain. Si aucune réponse n'est renvoyée, Amazon considère GameLift que le processus du serveur n'est pas sain. Type : OnHealthCheck func() bool Obligatoire : non
OnProcessTerminate	La fonction de rappel GameLift invoquée par Amazon pour forcer l'arrêt du processus du serveur. Après avoir appelé cette fonction, Amazon GameLift attend 5 minutes que le processus du serveur s'arrête et répond par un ProcessEnding() appel avant de l'arrêter. Type : OnProcessTerminate func() Obligatoire : oui
OnStartGameSession	Fonction de rappel GameLift invoquée par 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 pour fournir des données de matchmaking mises à jour. Il transmet un GameSession objet, une mise à jour de statut (updateReason) et l'identifiant du ticket de remplacement des matchs. Type : OnStartGameSession func (model.GameSession ) Obligatoire : oui
OnUpdateGameSession	Fonction de rappel GameLift invoquée par Amazon pour transmettre les informations de session de jeu mises à jour au processus du serveur. Amazon GameLift appelle cette fonction après avoir traité une demande de mise en correspondance afin de fournir des données de matchmaking mises à jour. Type : OnUpdateGameSession func (model.UpdateGameSession) Obligatoire : non
Port	Numéro de port sur lequel le processus serveur écoute les connexions des nouveaux joueurs. 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 : int Obligatoire : oui

UpdateGameSession

Les mises à jour apportées à un objet de session de jeu, y compris la raison pour laquelle la session de jeu a été mise à jour et l'identifiant du ticket de remplissage associé si le remplissage est utilisé pour remplir les sessions des joueurs pendant la session de jeu.

Propriétés	Description
GameSession	Un objet GameSession. L'GameSessionobjet contient des propriétés décrivant une session de jeu. Type : GameSession GameSession() Obligatoire : oui
UpdateReason	La raison pour laquelle la session de jeu est mise à jour. Type : UpdateReason UpdateReason() Obligatoire : oui
BackfillTicketId	L'identifiant du ticket de remplacement qui tente de mettre à jour la session de jeu. Type : String Obligatoire : non

GameSession

Les détails d'une session de jeu.

Propriétés	Description
GameSessionId	Identifiant unique pour la session de jeu. Une session de jeu Amazon Resource Name (ARN) a le format suivant :arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>. Type : String Obligatoire : non
Nom	Libellé descriptif de la session de jeu. Type : String Obligatoire : non
FleetId	Identifiant unique de la flotte sur laquelle s'exécute la session de jeu. Type : String Obligatoire : non
MaximumPlayerSessionCount	Le nombre maximum de connexions de joueurs à la session de jeu. Type : Integer Obligatoire : non
Port	Le numéro de port de la session de jeu. Pour se connecter à un serveur de GameLift jeu Amazon, une application a besoin à la fois de l'adresse IP et du numéro de port. Type : Integer Obligatoire : non
IpAddress	Adresse IP de la session de jeu. Pour se connecter à un serveur de GameLift jeu Amazon, une application a besoin à la fois de l'adresse IP et du numéro de port. Type : String Obligatoire : non
GameSessionData	Ensemble de propriétés de session de jeu personnalisées, mises en forme en tant que valeur de chaîne unique. Type : String Obligatoire : non
MatchmakerData	Les informations sur le processus de matchmaking qui a été utilisé pour créer la session de jeu, en JSON syntaxe, formatées sous forme de chaîne. En plus de la configuration de matchmaking utilisée, il contient des données sur tous les joueurs affectés au match, y compris les attributs des joueurs et les affectations des équipes. Type : String Obligatoire : non
GameProperties	Ensemble de propriétés personnalisées pour une session de jeu, formatées sous forme de paires clé:valeur. Ces propriétés sont transmises avec une demande de démarrage d'une nouvelle session de jeu. Type : map[string] string Obligatoire : non
DnsName	DNSIdentifiant attribué à l'instance qui exécute la session de jeu. Les valeurs ont le format suivant : TLSflottes compatibles :. <unique identifier>.<region identifier>.amazongamelift.com Flottes non TLS activées :. ec2-<unique identifier>.compute.amazonaws.com Lorsque vous vous connectez à une session de jeu exécutée sur un parc TLS compatible, vous devez utiliser le DNS nom, et non l'adresse IP. Type : String Obligatoire : non

ServerParameters

Informations utilisées pour maintenir la connexion entre un GameLift Anywhere serveur Amazon et le GameLift service Amazon. Ces informations sont utilisées lors du lancement de nouveaux processus serveur avecInitSDK(). Pour les serveurs hébergés sur des EC2 instances GameLift gérées par Amazon, utilisez un objet vide.

Propriétés	Description
WebSocketURL	L'GameLiftServerSdkEndpointAmazon GameLift revient lorsque vous RegisterComputerecherchez une ressource GameLift Anywhere informatique Amazon. Type : string Obligatoire : oui
ProcessID	Un identifiant unique enregistré auprès du processus serveur hébergeant votre jeu. Type : string Obligatoire : oui
HostID	Identifiant unique de la ressource de calcul hébergeant le nouveau processus du serveur. Le HostID est celui ComputeName utilisé lorsque vous avez enregistré votre ordinateur. Pour plus d'informations, consultez RegisterCompute. Type : string Obligatoire : oui
FleetID	Identifiant unique de la flotte dans laquelle le calcul est enregistré. Pour plus d'informations, consultez RegisterCompute. Type : string Obligatoire : oui
AuthToken	Le jeton d'authentification généré par Amazon GameLift qui authentifie votre serveur auprès d'Amazon GameLift. Pour plus d'informations, consultez GetComputeAuthToken. Type : string Obligatoire : oui

StartMatchBackfillRequest

Informations utilisées pour créer une demande de remplissage par matchmaking. Le serveur de jeu communique ces informations à Amazon GameLift lors d'un StartMatchBackfill() appel.

Propriétés	Description
GameSessionArn	L'identifiant unique de session de jeu. L'APIopération GetGameSessionId renvoie l'identifiant au ARN format. Type : String Obligatoire : oui
MatchmakingConfigurationArn	L'identifiant unique (sous la forme d'unARN) que le système de jumelage doit utiliser pour cette demande. Le système de matchmaking ARN de la session de jeu d'origine se trouve dans l'objet de session de jeu dans la propriété de données du système de matchmaking. Pour plus d'informations sur les données du système de jumelage, consultez la section Utilisation des données du système de jumelage. Type : String Obligatoire : oui
Joueurs	Ensemble de données représentant tous les joueurs qui participent actuellement à la session de jeu. Le matchmaker utilise ces informations pour rechercher de nouveaux joueurs qui constituent de bonnes correspondances pour les joueurs actuels. Type : []model.Player Obligatoire : oui
TicketId	L'identifiant unique d'un ticket de demande de matchmaking ou de remplacement de match. Si vous ne fournissez aucune valeur, Amazon en GameLift génère une. Utilisez cet identifiant pour suivre l'état du ticket de renvoi de correspondance ou annuler la requête si nécessaire. Type : String Obligatoire : non

Joueur

L'objet qui représente un joueur dans le matchmaking. Lorsqu'une demande de matchmaking démarre, un joueur dispose d'un identifiant de joueur, d'attributs et éventuellement de données de latence. Amazon GameLift ajoute les informations de l'équipe une fois le match terminé.

Propriétés	Description
LatencyInMS	Ensemble de valeurs exprimées en millisecondes qui indiquent le niveau de latence ressenti par un joueur lorsqu'il est connecté à un lieu. Si cette propriété est utilisée, le joueur n'est jumelé qu'aux emplacements répertoriés. Si un matchmaker dispose d'une règle qui évalue la latence, les joueurs doivent indiquer la latence pour être mis en relation. Type : map[string] int Obligatoire : non
PlayerAttributes	Une collection de paires clé:valeur contenant des informations sur les joueurs à utiliser dans le matchmaking. Les clés d'attribut du joueur doivent correspondre à PlayerAttributes celles utilisées dans un ensemble de règles de matchmaking. Pour plus d'informations sur les attributs des joueurs, consultez AttributeValue. Type : map[string] AttributeValue Obligatoire : non
PlayerId	Identifiant unique pour un joueur. Type : String Obligatoire : non
Equipe	Le nom de l'équipe à laquelle le joueur est affecté lors d'un match. Vous définissez le nom de l'équipe dans le jeu de règles de matchmaking. Type : String Obligatoire : non

DescribePlayerSessionsRequest

Objet qui indique les sessions de joueur à récupérer. Le processus du serveur fournit ces informations lors d'un DescribePlayerSessions() appel à Amazon GameLift.

Propriétés	Description
GameSessionID	Un 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'identifiant de session de jeu estarn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. GameSessionIDIl s'agit d'une chaîne d'identification personnalisée ou d'une chaîne générée. Type : String Obligatoire : non
PlayerSessionID	Identifiant unique d'une session de joueur. Utilisez ce paramètre pour demander une session de joueur spécifique. Type : String Obligatoire : non
PlayerID	L'identifiant unique d'un joueur. Utilisez ce paramètre pour demander toutes les sessions de joueur pour un joueur spécifique. veuillez consulter Générer des identifiants de joueurs. Type : String Obligatoire : non
PlayerSessionStatusFilter	État de la session du joueur sur lequel filtrer les résultats. Les statuts possibles des sessions de joueur sont les suivants : RESERVED— La demande de session du joueur a été reçue, mais le joueur ne s'est pas connecté au processus du serveur ni n'a été validé. ACTIVE— Le joueur a été validé par le processus du serveur et est 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é ou n'a pas été validé dans le délai imparti (60 secondes). Type : String Obligatoire : non
NextToken	Le jeton indiquant le début de la page de résultats suivante. Pour spécifier le début du jeu de résultats, ne fournissez aucune valeur. Si vous fournissez un identifiant de session de joueur, ce paramètre est ignoré. Type : String Obligatoire : non
Limit	Nombre maximal de résultats à renvoyer. Si vous fournissez un identifiant de session de joueur, ce paramètre est ignoré. Type : int Obligatoire : non

StopMatchBackfillRequest

Informations utilisées pour annuler une demande de remblayage par matchmaking. Le serveur de jeu communique ces informations au GameLift service Amazon lors d'un StopMatchBackfill() appel.

Propriétés	Description
GameSessionArn	Identifiant de session de jeu unique de la demande annulée. Type : string Obligatoire : non
MatchmakingConfigurationArn	L'identifiant unique du matchmaker auquel cette demande a été envoyée. Type : string Obligatoire : non
TicketId	L'identifiant unique du ticket de demande de remblayage à annuler. Type : string Obligatoire : non

GetFleetRoleCredentialsRequest

Les informations d'identification du rôle qui étendent l'accès limité à vos AWS ressources au serveur de jeu. Pour plus d'informations, veuillez consulter Configurer un rôle de service IAM pour Amazon GameLift.

Propriétés	Description
RoleArn	Le rôle ARN de service qui étend un accès limité à vos AWS ressources. Type : string Obligatoire : oui
RoleSessionName	Le nom de la session qui décrit l'utilisation des informations d'identification du rôle. Type : string Obligatoire : oui