View a markdown version of this page

SDK Go Server pour GameLift Serveurs Amazon -- Types de données - GameLift Serveurs Amazon
LogParametersMetricsParametersProcessParametersUpdateGameSessionGameSessionServerParametersStartMatchBackfillRequestJoueurDescribePlayerSessionsRequestStopMatchBackfillRequestGetFleetRoleCredentialsRequest

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.

SDK Go Server pour GameLift Serveurs Amazon -- Types de données

Utilisez la référence du SDK du serveur pour intégrer votre jeu multijoueur à héberger. Amazon GameLift Servers Pour obtenir des conseils sur le processus d'intégration, consultezAddition GameLift Serveurs Amazon sur votre serveur de jeu à l'aide du SDK du serveur.

GameLiftServerAPI.godéfinit les actions du SDK du serveur Go.

SDK Go Server pour GameLift Serveurs Amazon -- Actions

LogParameters

Objet identifiant les fichiers générés pendant une session de jeu que vous souhaitez télécharger et stocker Amazon GameLift Servers à la fin de la session de jeu. Le serveur de jeu fournit LogParameters to dans Amazon GameLift Servers le cadre d'un ProcessParameters objet lors d'un ProcessReady() appel.

Propriétés

 Description
LogPaths

La liste des chemins d'accès aux fichiers journaux du serveur de jeu que vous Amazon GameLift Servers souhaitez stocker pour y accéder ultérieurement. Le processus serveur génère ces fichiers à 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 de construction du jeu.

Les chemins de journalisation doivent être absolus. Par exemple, si la version de votre jeu stocke les journaux de session de jeu dans un chemin tel queMyGame\sessionLogs\, alors le chemin se trouverait c:\game\MyGame\sessionLogs sur une instance Windows.

Type : []string

Obligatoire : non

MetricsParameters

Un objet communiquant des paramètres de configuration pour initialiser le système de métriques. Cette configuration est utilisée pour configurer les rapports StatsD, les rapports d'erreur et le comportement de traitement des métriques. Le serveur de jeu fournit MetricsParameters à dans Amazon GameLift Servers le cadre d'un InitMetrics() appel.

Propriétés

 Description
StatsdHost

L'hôte du serveur StatsD pour les rapports de métriques (par exemple, « localhost »).

Type : string

Obligatoire : oui
StatsdPort

Le port du serveur StatsD pour les rapports de métriques (par exemple, 8125).

Type : int

Obligatoire : oui
CrashReporterHost

L'hôte des rapports d'accident pour le suivi des accidents et la surveillance des processus.

Type : string

Obligatoire : oui
CrashReporterPort

Le port de signalement des accidents pour le suivi des accidents et la surveillance des processus.

Type : int

Obligatoire : oui
FlushIntervalMs

L'intervalle de vidange des métriques est exprimé en millisecondes. Contrôle la fréquence à laquelle les métriques sont envoyées à StatsD.

Type : int

Obligatoire : oui
MaxPacketSize

Taille de paquet maximale pour les métriques en octets. Limite la taille des paquets UDP envoyés à StatsD.

Type : int

Obligatoire : oui

ProcessParameters

Un objet décrivant la communication entre un processus serveur etAmazon GameLift Servers. Le processus serveur fournit ces informations à l'Amazon GameLift Serversaide d'un appel àProcessReady().

Propriétés

 Description
LogParameters Un objet avec des chemins de répertoire vers des fichiers générés pendant une session de jeu. Amazon GameLift Serverscopie et stocke les fichiers pour un accès ultérieur.

Type : LogParameters

Obligatoire : non
OnHealthCheck La fonction de rappel qui Amazon GameLift Servers permet de demander un rapport d'état de santé au processus serveur. Amazon GameLift Serversappelle cette fonction toutes les 60 secondes et attend 60 secondes pour obtenir une réponse. Le processus du serveur revient TRUE s'il est en bon état, FALSE sinon s'il n'est pas sain. Si aucune réponse n'est renvoyée, Amazon GameLift Servers enregistre le processus du serveur comme étant incorrect.

Type : OnHealthCheck func() bool

Obligatoire : non
OnProcessTerminate La fonction de rappel Amazon GameLift Servers invoquée pour forcer l'arrêt du processus serveur. Après avoir appelé cette fonction, Amazon GameLift Servers attend 5 minutes que le processus serveur s'arrête et répond par un ProcessEnding() appel avant d'arrêter le processus serveur.

Type : OnProcessTerminate func()

Obligatoire : oui
OnStartGameSession Fonction de rappel qui Amazon GameLift Servers permet de transmettre un objet de session de jeu mis à jour au processus serveur. Amazon GameLift Serversappelle cette fonction lorsqu'une demande de remplissage de 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 correspondant.

Type : OnStartGameSession func (model.GameSession )

Obligatoire : oui
OnUpdateGameSession La fonction de rappel qui permet de Amazon GameLift Servers transmettre les informations de session de jeu mises à jour au processus serveur. Amazon GameLift Serversappelle cette fonction après avoir traité une demande de remplissage de correspondance pour 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 de 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, qui incluent la raison pour laquelle la session de jeu a été mise à jour, et l'identifiant du ticket de remplacement associé si le remplissage est utilisé pour compléter 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

Un 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

Une étiquette descriptive de la session de jeu.

Type : String

Obligatoire : non
FleetId

Un identifiant unique pour 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 Amazon GameLift Servers jeu, 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 Amazon GameLift Servers jeu, 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 syntaxe JSON, sous forme de chaîne. Outre la configuration de matchmaking utilisée, elle contient des données sur tous les joueurs assigné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

L'identifiant DNS attribué à l'instance qui exécute la session de jeu. Les valeurs ont le format suivant :

  • TLS-enabled flottes :<unique identifier>.<region identifier>.amazongamelift.com.

  • Non-TLS-enabled flottes :ec2-<unique identifier>.compute.amazonaws.com.

Lorsque vous vous connectez à une session de jeu exécutée sur une TLS-enabled flotte, vous devez utiliser le nom DNS et non l'adresse IP.

Type : String

Obligatoire : non

ServerParameters

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

Propriétés Description
WebSocketURL

Le GameLiftServerSdkEndpoint Amazon GameLift Servers résultat obtenu lorsque vous RegisterCompute recherchez une ressource de calcul Amazon GameLift Servers Anywhere.

Type : string

Obligatoire : oui
ProcessID

Un identifiant unique enregistré auprès du processus serveur hébergeant votre jeu.

Type : string

Obligatoire : oui
HostID

L'identifiant unique de la ressource de calcul qui héberge le nouveau processus serveur.

HostIDC'est celui ComputeName utilisé lorsque vous avez enregistré votre ordinateur. Pour plus d’informations, consultez RegisterCompute.

Type : string

Obligatoire : oui
FleetID L'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é permet Amazon GameLift Servers d'authentifier votre serveur auprès deAmazon GameLift Servers. Pour plus d’informations, consultez GetComputeAuthToken.

Type : string

Obligatoire : oui

StartMatchBackfillRequest

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

Propriétés Description
GameSessionArn

L'identifiant unique de session de jeu. L'opération d'API GetGameSessionId renvoie l'identifiant au format ARN.

Type : String

Obligatoire : oui
MatchmakingConfigurationArn

L'identifiant unique (sous la forme d'un ARN) que le matchmaker doit utiliser pour cette demande. L'ARN du matchmaker pour la session de jeu d'origine se trouve dans l'objet de session de jeu de la propriété de données du matchmaker. Pour plus d'informations sur les données de matchmaker, voir Travailler avec les données de matchmaker.

Type : String

Obligatoire : oui
Joueurs

Un ensemble de données qui représente tous les joueurs actuellement en 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 pas de valeur, Amazon GameLift Servers générez-en 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 possède un identifiant de joueur, des attributs et éventuellement des données de latence. Amazon GameLift Serversajoute des informations sur l'équipe après la fin d'un match.

Propriétés Description
LatencyInMS

Ensemble de valeurs exprimées en millisecondes qui indiquent la quantité de latence subie par un joueur lorsqu'il est connecté à un lieu.

Si cette propriété est utilisée, le joueur est sélectionné uniquement pour les 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 des joueurs doivent correspondre à celles PlayerAttributes 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
Team

Le nom de l'équipe à laquelle le joueur est assigné 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

Un objet qui spécifie les sessions de joueur à récupérer. Le processus serveur fournit ces informations en DescribePlayerSessions() appelantAmazon GameLift Servers.

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'ID 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

L'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. Consultez Générer un joueur IDs.

Type : String

Obligatoire : non
PlayerSessionStatusFilter

L'état de la session du joueur sur lequel filtrer les résultats. Les statuts de session de joueur possibles incluent :

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

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

  • TERMINÉ — 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 remplacement de matchmaking. Le serveur de jeu communique ces informations au Amazon GameLift Servers service lors d'un StopMatchBackfill() appel.

Propriétés Description
GameSessionArn

L'identifiant de session de jeu unique de la demande en cours d'annulation.

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 remplacement à 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, consultez Configurer un rôle de service IAM pour Amazon GameLift Servers.

Propriétés Description
RoleArn L'ARN du rôle de service qui étend l'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