C++-Server-SDK 5.x für Amazon GameLift Servers -- Datentypen - Amazon GameLift Servers
LogParametersProcessParametersUpdateGameSessionGameSessionServerParametersStartMatchBackfillRequestPlayerDescribePlayerSessionsRequestStopMatchBackfillRequestAttributeValueGetFleetRoleCredentialsRequestAwsLongOutcomeAwsStringOutcomeDescribePlayerSessionsOutcomeDescribePlayerSessionsResultGenericOutcomeGenericOutcomeCallablePlayerSessionStartMatchBackfillOutcomeStartMatchBackfillResultGetComputeCertificateOutcomeGetComputeCertificateResultGetFleetRoleCredentialsOutcomeGetFleetRoleCredentialsResultInitialisieren SDKOutcomeGameLiftErrorAufzählungen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

C++-Server-SDK 5.x für Amazon GameLift Servers -- Datentypen

Verwenden Sie die Amazon GameLift Servers C++-Server-SDK 5.x-Referenz, um Ihr Multiplayer-Spiel zum Hosten zu integrieren. Amazon GameLift Servers Hinweise zum Integrationsprozess finden Sie unterAmazon GameLift ServersZu deinem Spieleserver hinzufügen.

Anmerkung

In diesem Thema wird die Amazon GameLift Servers C++-API beschrieben, die Sie verwenden können, wenn Sie mit der C++-Standardbibliothek (std) bauen. Insbesondere bezieht sich diese Dokumentation auf Code, den Sie mit der -DDGAMELIFT_USE_STD=1 Option kompilieren.

C++-Server-SDK 5.x für Amazon GameLift Servers -- Aktionen

LogParameters

Ein Objekt, das Dateien identifiziert, die während einer Spielsitzung generiert wurden und die Sie nach dem Ende der Spielsitzung hochladen und speichern möchtenAmazon GameLift Servers. Der Spieleserver stellt LogParameters es Amazon GameLift Servers als Teil eines ProcessParameters Objekts in einem ProcessReady() Aufruf bereit.

Eigenschaften

 Beschreibung
LogPaths

Die Liste der Verzeichnispfade zu den Spielserver-Protokolldateien, die Sie für den future Amazon GameLift Servers Zugriff speichern möchten. Der Serverprozess generiert diese Dateien während jeder Spielsitzung. Du definierst Dateipfade und -namen auf deinem Spieleserver und speicherst sie im Hauptverzeichnis des Spiels.

Die Protokollpfade müssen absolut sein. Wenn Ihr Game-Build beispielsweise Spielesitzungsprotokolle in einem Pfad wie speichertMyGame\sessionLogs\, dann wäre der Pfad c:\game\MyGame\sessionLogs auf einer Windows-Instanz.

Typ: std:vector<std::string>

Required: No

ProcessParameters

Dieser Datentyp enthält den Satz von Parametern, an den Amazon GameLift Servers in a gesendet wirdProcessReady().

Eigenschaften

 Beschreibung
LogParameters Ein Objekt mit Verzeichnispfaden zu Dateien, die während einer Spielsitzung generiert werden. Amazon GameLift Serverskopiert und speichert die Dateien für den future Zugriff.

Typ: Aws::GameLift::Server::LogParameters

Required: No
OnHealthCheck Die Callback-Funktion, die Amazon GameLift Servers aufgerufen wird, um einen Statusbericht vom Serverprozess anzufordern. Amazon GameLift Serversruft diese Funktion alle 60 Sekunden auf und wartet 60 Sekunden auf eine Antwort. Der Serverprozess kehrt zurück, TRUE wenn er fehlerfrei ist, FALSE wenn nicht. Wenn keine Antwort zurückgegeben wird, wird der Amazon GameLift Servers Serverprozess als fehlerhaft aufgezeichnet.

Typ: std::function<bool()> onHealthCheck

Required: No
OnProcessTerminate Die Callback-Funktion, die Amazon GameLift Servers aufgerufen wird, um das Herunterfahren des Serverprozesses zu erzwingen. Amazon GameLift ServersWartet nach dem Aufrufen dieser Funktion 5 Minuten, bis der Serverprozess heruntergefahren ist, und antwortet mit einem ProcessEnding() Aufruf, bevor er den Serverprozess herunterfährt.

Typ: std::function<void()> onProcessTerminate

Erforderlich: Ja
OnStartGameSession Die Callback-Funktion, die Amazon GameLift Servers aufgerufen wird, um eine neue Spielsitzung zu aktivieren. Amazon GameLift Serversruft diese Funktion als Antwort auf eine Client-Anfrage auf. CreateGameSession Die Callback-Funktion übergibt ein GameSession Objekt.

Typ: const std::function<void(Aws::GameLift::Model::GameSession)> onStartGameSession

Erforderlich: Ja
OnUpdateGameSession Die Callback-Funktion, die Amazon GameLift Servers aufgerufen wird, um ein aktualisiertes Spielsitzungsobjekt an den Serverprozess zu übergeben. Amazon GameLift Serversruft diese Funktion auf, wenn eine Match-Backfill-Anfrage bearbeitet wurde, um aktualisierte Matchmaker-Daten bereitzustellen. Sie übergibt ein GameSession Objekt, ein Status-Update (updateReason) und die Match-Backfill-Ticket-ID.

Typ: std::function<void(Aws::GameLift::Server::Model::UpdateGameSession)> onUpdateGameSession

Required: No
Port Die Portnummer, auf der der Serverprozess auf neue Spielerverbindungen wartet. Der Wert muss innerhalb des Port-Bereich liegen, der für eine Flotte definiert wurde, die diesen Spiel-Server-Build verwendet. Diese Portnummer ist in Spielsitzungs- und Spielersitzungsobjekten enthalten, die die Spielsitzungen bei der Verbindung mit einem Serverprozess verwenden.

Typ: Integer

Erforderlich: Ja

UpdateGameSession

Dieser Datentyp aktualisiert ein Spielsitzungsobjekt, das den Grund für die Aktualisierung der Spielsitzung und die zugehörige Backfill-Ticket-ID enthält, falls Backfill zum Füllen von Spielersitzungen in der Spielsitzung verwendet wird.

Eigenschaften Beschreibung
GameSession Ein GameSession-Objekt. Das GameSession Objekt enthält Eigenschaften, die eine Spielsitzung beschreiben.

Typ: Aws::GameLift::Server::GameSession

Erforderlich: Ja
UpdateReason Der Grund, warum die Spielsitzung aktualisiert wird.

Typ: Aws::GameLift::Server::UpdateReason

Erforderlich: Ja
BackfillTicketId Die ID des Backfill-Tickets, das versucht, die Spielsitzung zu aktualisieren.

Typ: std::string

Required: No

GameSession

Dieser Datentyp enthält Details einer Spielsitzung.

Eigenschaften Beschreibung
GameSessionId

Eine eindeutige Kennung für die Spielsitzung. Eine Spielsitzung ARN hat das folgende Format:arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>.

Typ: std::string

Required: No
Name

Eine beschreibende Bezeichnung der Spielsitzung.

Typ: std::string

Required: No
FleetId

Eine eindeutige Kennung für die Flotte, auf der die Spielsitzung läuft.

Typ: std::string

Required: No
MaximumPlayerSessionCount

Die maximale Anzahl von Spielerverbindungen zur Spielsitzung.

Typ: int

Required: No
Port

Die Portnummer für die Spielsitzung. Um eine Verbindung zu einem Amazon GameLift Servers Spieleserver herzustellen, benötigt eine App sowohl die IP-Adresse als auch die Portnummer.

Typ: in

Required: No
IpAddress

Die IP-Adresse der Spielsitzung. Um eine Verbindung zu einem Amazon GameLift Servers Spieleserver herzustellen, benötigt eine App sowohl die IP-Adresse als auch die Portnummer.

Typ: std::string

Required: No
GameSessionData

Eine Reihe von benutzerdefinierten Spielsitzungseigenschaften, die als einzelner Zeichenfolgenwert formatiert sind.

Typ: std::string

Required: No
MatchmakerData

Informationen über den Matchmaking-Prozess, der zur Erstellung der Spielsitzung verwendet wurde, in JSON-Syntax, formatiert als Zeichenfolge. Zusätzlich zur verwendeten Matchmaking-Konfiguration enthält es Daten zu allen Spielern, die dem Spiel zugewiesen wurden, einschließlich Spielerattributen und Teamzuweisungen.

Typ: std::string

Required: No
GameProperties

Eine Reihe von benutzerdefinierten Eigenschaften für eine Spielsitzung, formatiert als Schlüssel/Wert-Paare. Diese Eigenschaften werden zusammen mit der Aufforderung, eine neue Spielsitzung zu starten, übergeben.

Typ: std :: vector < GameProperty >

Required: No
DnsName

Die DNS-ID, die der Instanz zugewiesen ist, auf der die Spielsitzung ausgeführt wird. Werte haben das folgende Format:

  • TLS-fähige Flotten:. <unique identifier>.<region identifier>.amazongamelift.com

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

Wenn du eine Verbindung zu einer Spielsitzung herstellst, die auf einer TLS-fähigen Flotte läuft, musst du den DNS-Namen verwenden, nicht die IP-Adresse.

Typ: std::string

Required: No

ServerParameters

Informationen, die ein Spieleserver-Prozess verwendet, um eine Verbindung mit dem Amazon GameLift Servers Dienst herzustellen. Geben Sie diese Parameter beim Aufrufen InitSDK() nur an, wenn der Spielserver-Build für eine Anywhere-Flotte oder eine Containerflotte ohne den Amazon GameLift Servers Agenten bereitgestellt wird. Rufen Sie für alle anderen Bereitstellungsszenarien InitSDK() ohne Parameter auf.

Eigenschaften Beschreibung
webSocketUrl

Das GameLiftServerSdkEndpoint Amazon GameLift Servers kehrt zurück, wenn Sie RegisterComputenach einer Amazon GameLift Servers Anywhere-Rechenressource suchen.

Typ: std::string

Erforderlich: Ja

Prozess-ID

Eine eindeutige Kennung, die für den Serverprozess registriert ist, der dein Spiel hostet.

Typ: std::string

Erforderlich: Ja
hostId Das HostID ist die, die bei der Registrierung Ihres Computers ComputeName verwendet wurde. Weitere Informationen finden Sie unter RegisterCompute.

Typ: std::string

Erforderlich: Ja
FleetID Die eindeutige Kennung der Flotte, für die der Computer registriert ist. Weitere Informationen finden Sie unter RegisterCompute.

Typ: std::string

Erforderlich: Ja
AuthToken Das dadurch generierte Authentifizierungstoken authentifiziert Ihren Server gegenüber. Amazon GameLift Servers Amazon GameLift Servers Weitere Informationen finden Sie unter GetComputeAuthToken.

Typ: std::string

Erforderlich: Ja

StartMatchBackfillRequest

Informationen, die zur Erstellung einer Matchmaking-Backfill-Anfrage verwendet wurden. Der Spieleserver übermittelt diese Informationen Amazon GameLift Servers in einem Anruf an. StartMatchBackfill()

Eigenschaften Beschreibung
GameSessionArn

Eine eindeutige Kennung für die Spielsitzung. Die API-Operation GetGameSessionId gibt den Bezeichner im ARN-Format zurück.

Typ: std::string

Erforderlich: Ja
MatchmakingConfigurationArn

Eine eindeutige Kennung in Form eines ARN, die der Matchmaker für diese Anfrage verwenden kann. Der Matchmaker-ARN für die ursprüngliche Spielsitzung befindet sich im Spielsitzungsobjekt in der Matchmaker-Dateneigenschaft. Weitere Informationen zu Matchmaker-Daten finden Sie unter Arbeiten mit Matchmaker-Daten.

Typ: std::string

Erforderlich: Ja
Players

Ein Datensatz, der alle Spieler repräsentiert, die an der Spielsitzung teilnehmen. Der Matchmaker verwendet diese Informationen, um nach neuen Spielern zu suchen, die zu den aktuellen Spielern passen.

Typ: std::vector<Player>

Erforderlich: Ja
TicketId

Eine eindeutige Kennung für ein Matchmaking- oder Match-Backfill-Anfrageticket. Amazon GameLift ServersGeneriert einen, wenn Sie keinen Wert angeben. Verwenden Sie diesen Bezeichner, um den Status des Backfill-Tickets zu verfolgen oder die Anfrage bei Bedarf abzubrechen.

Typ: std::string

Required: No

Player

Dieser Datentyp steht für einen Spieler beim Matchmaking. Wenn ein Spieler eine Matchmaking-Anfrage startet, verfügt er über eine Spieler-ID, Attribute und möglicherweise Latenzdaten. Amazon GameLift Serversfügt Teaminformationen hinzu, nachdem ein Spiel gespielt wurde.

Eigenschaften Beschreibung
LatencyInMS

Eine Reihe von Werten, ausgedrückt in Millisekunden, die die Latenz angeben, die ein Spieler erlebt, wenn er mit einem Standort verbunden ist.

Wenn diese Eigenschaft verwendet wird, wird der Player nur für die aufgelisteten Standorte abgeglichen. Wenn ein Matchmaker eine Regel hat, die die Latenz der Spieler auswertet, müssen die Spieler die zu vergleichende Latenz melden.

Typ: Dictionary<string,int>

Required: No
PlayerAttributes

Eine Sammlung von Schlüssel/Wert-Paaren, die Spielerinformationen zur Verwendung bei der Spielerzuweisung enthalten. Die Schlüssel der Spielerattribute müssen mit den in einem Matchmaking-Regelsatz PlayerAttributes verwendeten übereinstimmen.

Weitere Informationen zu Spielerattributen finden Sie unter AttributeValue.

Typ: std::map<std::string,AttributeValue>

Required: No
PlayerId

Eine eindeutige Kennung für einen Spieler.

Typ: std::string

Required: No
Team

Der Name der Mannschaft, der der Spieler in einem Spiel zugewiesen wird. Sie definieren den Teamnamen im Matchmaking-Regelsatz.

Typ: std::string

Required: No

DescribePlayerSessionsRequest

Ein Objekt, das angibt, welche Spielersitzungen abgerufen werden sollen. Der Serverprozess stellt diese Informationen mit einem DescribePlayerSessions() Aufruf von bereitAmazon GameLift Servers.

Eigenschaften Beschreibung
GameSessionId

Eine eindeutige Kennung für die Spielsitzung. Verwenden Sie diesen Parameter, um alle Spielersitzungen für die angegebene Spielsitzung anzufragen.

Das Format der Spielsitzungs-ID istarn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. Das GameSessionID ist eine benutzerdefinierte ID-Zeichenfolge oder eine

Typ: std::string

Required: No
PlayerSessionId

Die eindeutige Kennung für eine Spielersitzung. Verwenden Sie diesen Parameter, um eine einzelne spezifische Spielersitzung anzufordern.

Typ: std::string

Required: No
PlayerId

Die eindeutige Kennung für einen Spieler. Verwenden Sie diesen Parameter, um alle Spielersitzungen für einen bestimmten Spieler anzufordern. Siehe Spieler generieren IDs.

Typ: std::string

Required: No
PlayerSessionStatusFilter

Der Sitzungsstatus des Spielers, nach dem die Ergebnisse gefiltert werden sollen. Zu den möglichen Sitzungsstatus eines Spielers gehören:

  • RESERVIERT — Die Anfrage für die Spielersitzung wurde empfangen, aber der Spieler hat keine Verbindung zum Serverprozess hergestellt oder wurde nicht validiert.

  • AKTIV — Der Spieler wurde durch den Serverprozess validiert und ist verbunden.

  • ABGESCHLOSSEN — Die Spielerverbindung wurde unterbrochen.

  • TIMEDOUT — Eine Anfrage für eine Spielersitzung wurde empfangen, aber der Spieler hat keine Verbindung hergestellt oder wurde nicht innerhalb des Timeoutlimits (60 Sekunden) bestätigt.

Typ: std::string

Required: No
NextToken

Das Token, das den Beginn der nächsten Ergebnisseite anzeigt. Um den Anfang der Ergebnismenge anzugeben, geben Sie keinen Wert an. Wenn Sie eine Spielersitzungs-ID angeben, wird dieser Parameter ignoriert.

Typ: std::string

Required: No
Limit

Die maximale Anzahl der auszugebenden Ergebnisse. Wenn Sie eine Spielersitzungs-ID angeben, wird dieser Parameter ignoriert.

Typ: int

Required: No

StopMatchBackfillRequest

Informationen, die verwendet werden, um eine Matchmaking-Backfill-Anfrage zu stornieren. Der Spieleserver übermittelt diese Informationen in einem Anruf an den Amazon GameLift Servers Service. StopMatchBackfill()

Eigenschaften Beschreibung
GameSessionArn

Eine eindeutige Spielsitzungs-ID der Anfrage, die storniert wird.

Typ: char[]

Required: No
MatchmakingConfigurationArn

Eine eindeutige Kennung des Matchmakers, an den diese Anfrage gesendet wurde.

Typ: char[]

Required: No
TicketId

Eine eindeutige Kennung des Tickets für die Backfill-Anfrage, das storniert werden soll.

Typ: char[]

Required: No

AttributeValue

Verwenden Sie diese Werte in Player Attribut-Schlüssel-Wert-Paaren. Mit diesem Objekt können Sie einen Attributwert mit einem der gültigen Datentypen angeben: Zeichenfolge, Zahl, Zeichenkettenarray oder Datenmap. Jedes AttributeValue Objekt muss genau eine der verfügbaren Eigenschaften verwenden: SN,SL, oderSDM.

Eigenschaften Beschreibung
AttrType

Gibt den Typ des Attributwerts an. Zu den möglichen Attributwerttypen gehören:

  • NONE

  • ZEICHENFOLGE

  • DOPPELT

  • STRING_LIST

  • STRING_DOUBLE_MAP

Required: No
S

Stellt einen Zeichenketten-Attributwert dar.

Typ: std::string

Required: No
N

Stellt einen numerischen Attributwert dar.

Typ: double

Required: No
SL

Stellt ein Array von Zeichenkettenattributwerten dar.

Typ: std::vector<std::string>

Required: No
SDM

Stellt ein Wörterbuch mit Zeichenkettenschlüsseln und Doppelwerten dar.

Typ: std::map<std::string, double>

Required: No

GetFleetRoleCredentialsRequest

Dieser Datentyp gewährt dem Spieleserver eingeschränkten Zugriff auf deine anderen Ressourcen. AWS Weitere Informationen finden Sie unter Richten Sie eine IAM-Servicerolle ein für Amazon GameLift Servers.

Eigenschaften Beschreibung
RoleArn Der Amazon-Ressourcenname (ARN) der Servicerolle, die den eingeschränkten Zugriff auf Ihre AWS Ressourcen erweitert.

Typ: std::string

Required: No
RoleSessionName Der Name der Rollensitzung, mit dem Sie eine AWS Security Token Service AssumeRoleSitzung eindeutig identifizieren können. Dieser Name wird in Auditprotokollen wie denen in angezeigt CloudTrail.

Typ: std::string

Required: No

AwsLongOutcome

Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:

Eigenschaften Beschreibung
Ergebnis

Das Ergebnis der Aktion.

Typ: long

Required: No
ResultWithOwnership

Das Ergebnis der Aktion, in einen R-Wert umgewandelt, sodass der aufrufende Code den Besitz des Objekts übernehmen kann.

Typ: long&&

Required: No
Herzlichen Glückwunsch

Ob die Aktion erfolgreich war oder nicht.

Typ: bool

Erforderlich: Ja
Fehler

Der Fehler, der aufgetreten ist, wenn die Aktion nicht erfolgreich war.

Typ: GameLiftError

Required: No

AwsStringOutcome

Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:

Eigenschaften Beschreibung
Ergebnis

Das Ergebnis der Aktion.

Typ: std::string

Required: No
ResultWithOwnership

Das Ergebnis der Aktion, in einen R-Wert umgewandelt, sodass der aufrufende Code den Besitz des Objekts übernehmen kann.

Typ: long&&

Required: No
Herzlichen Glückwunsch

Ob die Aktion erfolgreich war oder nicht.

Typ: bool

Erforderlich: Ja
Fehler

Der Fehler, der aufgetreten ist, wenn die Aktion nicht erfolgreich war.

Typ: GameLiftError

Required: No

DescribePlayerSessionsOutcome

Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:

Eigenschaften Beschreibung
Ergebnis

Das Ergebnis der Aktion.

Typ: DescribePlayerSessionsResult

Required: No

ResultWithOwnership

Das Ergebnis der Aktion, in einen R-Wert umgewandelt, sodass der aufrufende Code den Besitz des Objekts übernehmen kann.

Typ: Aws::GameLift::Server::Model::DescribePlayerSessionsResult&&

Required: No
Herzlichen Glückwunsch

Ob die Aktion erfolgreich war oder nicht.

Typ: bool

Erforderlich: Ja
Fehler

Der Fehler, der aufgetreten ist, wenn die Aktion nicht erfolgreich war.

Typ: GameLiftError

Required: No

DescribePlayerSessionsResult

Eine Sammlung von Objekten mit Eigenschaften für jede Spielersitzung, die der Anfrage entspricht.

Eigenschaften Beschreibung
NextToken

Ein Token, das den Beginn der nächsten sequentiellen Ergebnisseite angibt. Verwenden Sie das Token, das bei einem vorherigen Aufruf dieses Vorgangs zurückgegeben wurde. Um am Anfang der Ergebnismenge zu beginnen, geben Sie keinen Wert an. Wenn eine Spielersitzungs-ID angegeben ist, wird dieser Parameter ignoriert.

Typ: std::string

Erforderlich: Ja
PlayerSessions

Typ: IList<PlayerSession>

Erforderlich:

ResultWithOwnership

Das Ergebnis der Aktion wird in einen R-Wert umgewandelt, sodass der aufrufende Code den Besitz des Objekts übernehmen kann.

Typ: std::string&&

Required: No
Herzlichen Glückwunsch

Ob die Aktion erfolgreich war oder nicht.

Typ: bool

Erforderlich: Ja
Fehler

Der Fehler, der aufgetreten ist, wenn die Aktion nicht erfolgreich war.

Typ: GameLiftError

Required: No

GenericOutcome

Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:

Eigenschaften Beschreibung
Herzlichen Glückwunsch

Ob die Aktion erfolgreich war oder nicht.

Typ: bool

Erforderlich: Ja
Fehler

Der Fehler, der aufgetreten ist, wenn die Aktion nicht erfolgreich war.

Typ: GameLiftError

Required: No

GenericOutcomeCallable

Dieser Datentyp ist ein asynchrones generisches Ergebnis. Er besitzt die folgenden Eigenschaften:

Eigenschaften Beschreibung
Herzlichen Glückwunsch

Ob die Aktion erfolgreich war oder nicht.

Typ: bool

Erforderlich: Ja
Fehler

Der Fehler, der aufgetreten ist, wenn die Aktion nicht erfolgreich war.

Typ: GameLiftError

Required: No

PlayerSession

Dieser Datentyp steht für eine Spielersitzung, die an den Spieleserver weitergegeben wird. Amazon GameLift Servers Weitere Informationen finden Sie unter PlayerSession.

Eigenschaften Beschreibung
CreationTime

Typ: long

Required: No
FleetId

Typ: std::string

Required: No
GameSessionId

Typ: std::string

Required: No
IpAddress

Typ: std::string

Required: No
PlayerData

Typ: std::string

Required: No
PlayerId

Typ: std::string

Required: No
PlayerSessionId

Typ: std::string

Required: No
Port

Typ: int

Required: No
Status

Status der Spielersitzung für die Filterung der Ergebnisse. Wenn ein PlayerSessionId oder angegeben PlayerId wird, PlayerSessionStatusFilter hat das keine Auswirkung auf die Antwort.

Typ: Eine PlayerSessionStatus Aufzählung. Die folgenden Werte sind möglich:

  • ACTIVE

  • COMPLETED

  • NOT_FESTGELEGT

  • RESERVIERT

  • TIMEOUT

Required: No
TerminationTime

Typ: long

Required: No
DnsName

Typ: std::string

Required: No

StartMatchBackfillOutcome

Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:

Eigenschaften Beschreibung
Ergebnis

Das Ergebnis der Aktion.

Typ: StartMatchBackfillResult

Required: No
ResultWithOwnership

Das Ergebnis der Aktion, in einen R-Wert umgewandelt, sodass der aufrufende Code den Besitz des Objekts übernehmen kann.

Typ: StartMatchBackfillResult&&

Required: No
Herzlichen Glückwunsch

Ob die Aktion erfolgreich war oder nicht.

Typ: bool

Erforderlich: Ja
Fehler

Der Fehler, der aufgetreten ist, wenn die Aktion nicht erfolgreich war.

Typ: GameLiftError

Required: No

StartMatchBackfillResult

Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:

Eigenschaften Beschreibung
TicketId

Eine eindeutige Kennung für ein Matchmaking-Ticket. Wenn hier keine Ticket-ID angegeben ist, Amazon GameLift Servers wird eine in Form einer UUID generiert. Verwenden Sie diese Kennung, um den Status des Match-Backfill-Tickets zu verfolgen und die Spielergebnisse abzurufen.

Typ: std::string

Required: No

GetComputeCertificateOutcome

Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:

Eigenschaften Beschreibung
Ergebnis

Das Ergebnis der Aktion.

Typ: GetComputeCertificateResult

Required: No

ResultWithOwnership

Das Ergebnis der Aktion, in einen R-Wert umgewandelt, sodass der aufrufende Code den Besitz des Objekts übernehmen kann.

Typ: Aws::GameLift::Server::Model::GetComputeCertificateResult&&

Required: No
Herzlichen Glückwunsch

Ob die Aktion erfolgreich war oder nicht.

Typ: bool

Erforderlich: Ja
Fehler

Der Fehler, der aufgetreten ist, wenn die Aktion nicht erfolgreich war.

Typ: GameLiftError

Required: No

GetComputeCertificateResult

Der Pfad zum TLS-Zertifikat auf Ihrem Computer und der Hostname des Computers.

Eigenschaften Beschreibung
CertificatePath

Der Pfad zum TLS-Zertifikat auf Ihrer Rechenressource. Wenn Sie eine Amazon GameLift Servers verwaltete Flotte verwenden, enthält dieser Pfad:

  • certificate.pem: Das Endbenutzerzertifikat. Die vollständige Zertifikatskette ist die Kombination aus den an dieses Zertifikat certificateChain.pem angehängten Zertifikaten.

  • certificateChain.pem: Die Zertifikatskette, die das Stammzertifikat und die Zwischenzertifikate enthält.

  • rootCertificate.pem: Das Stammzertifikat.

  • privateKey.pem: Der private Schlüssel für das Endbenutzerzertifikat.

Typ: std::string

Required: No
ComputeName

Der Name Ihrer Rechenressource.

Typ: std::string

Required: No

GetFleetRoleCredentialsOutcome

Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:

Eigenschaften Beschreibung
Ergebnis

Das Ergebnis der Aktion.

Typ: GetFleetRoleCredentialsResult

Required: No

ResultWithOwnership

Das Ergebnis der Aktion, in einen R-Wert umgewandelt, sodass der aufrufende Code den Besitz des Objekts übernehmen kann.

Typ: Aws::GameLift::Server::Model::GetFleetRoleCredentialsResult

Required: No
Herzlichen Glückwunsch

Ob die Aktion erfolgreich war oder nicht.

Typ: bool

Erforderlich: Ja
Fehler

Der Fehler, der aufgetreten ist, wenn die Aktion nicht erfolgreich war.

Typ: GameLiftError

Required: No

GetFleetRoleCredentialsResult

Eigenschaften Beschreibung
AccessKeyId

Die Zugriffsschlüssel-ID zur Authentifizierung und Bereitstellung des Zugriffs auf Ihre Ressourcen. AWS

Typ: string

Required: No
AssumedRoleId

Die ID des Benutzers, zu dem die Servicerolle gehört.

Typ: string

Required: No
AssumedRoleUserArn

Der Amazon-Ressourcenname (ARN) des Benutzers, zu dem die Servicerolle gehört.

Typ: string

Required: No
Ablauf

Die Zeitspanne, bis Ihre Sitzungsanmeldedaten ablaufen.

Typ: DateTime

Required: No
SecretAccessKey

Die geheime Zugriffsschlüssel-ID für die Authentifizierung.

Typ: string

Required: No
SessionToken

Ein Token zur Identifizierung der aktuellen aktiven Sitzung, die mit Ihren AWS Ressourcen interagiert.

Typ: string

Required: No
Herzlichen Glückwunsch

Ob die Aktion erfolgreich war oder nicht.

Typ: bool

Erforderlich: Ja
Fehler

Der Fehler, der aufgetreten ist, wenn die Aktion nicht erfolgreich war.

Typ: GameLiftError

Required: No

Initialisieren SDKOutcome

Anmerkung

InitSDKOutcomewird nur zurückgegeben, wenn Sie das SDK mit dem Flag erstellen. std Wenn Sie mit dem nostd Flag bauen, GenericOutcome wird es stattdessen zurückgegeben.

Eigenschaften Beschreibung
Herzlichen Glückwunsch

Ob die Aktion erfolgreich war oder nicht.

Typ: bool

Erforderlich: Ja
Fehler

Der Fehler, der aufgetreten ist, wenn die Aktion nicht erfolgreich war.

Typ: GameLiftError

Required: No

GameLiftError

Eigenschaften Beschreibung
ErrorType

Der Fehlertyp.

Typ: Eine Aufzählung. GameLiftErrorType

Required: No

ErrorName

Der Name des Fehlers.

Typ: std::string

Required: No

ErrorMessage

Die Fehlermeldung.

Typ: std::string

Required: No

Aufzählungen

Für das Server-SDK für Amazon GameLift Servers (C++) definierte Enums sind wie folgt definiert:

GameLiftErrorType

Zeichenkettenwert, der den Fehlertyp angibt. Gültige Werte sind:

  • BAD_REQUEST_EXCEPTION

  • GAMESESSION_ID_NOT_SET — Die Spielsitzungs-ID wurde nicht festgelegt.

  • INTERNAL_SERVICE_EXCEPTION

  • LOCAL_CONNECTION_FAILED — Die lokale Verbindung zu ist fehlgeschlagen. Amazon GameLift Servers

  • NETWORK_NOT_INITIALIZED — Das Netzwerk wurde nicht initialisiert.

  • SERVICE_CALL_FAILED — Ein Aufruf eines Dienstes ist fehlgeschlagen. AWS

  • WEBSOCKET_CONNECT_FAILURE

  • WEBSOCKET_CONNECT_FAILURE_FORBIDDEN

  • WEBSOCKET_CONNECT_FAILURE_UNGÜLTIGE_URL

  • TIMEOUT FÜR WEBSOCKET_CONNECT_FAILURE_

  • ALREADY_INITIALIZED — Der Server oder Client wurde bereits mit Initialize () initialisiert. Amazon GameLift Servers

  • FLEET_MISMATCH — Die Zielflotte entspricht nicht der Flotte einer GameSession oder PlayerSession.

  • GAMELIFT_CLIENT_NOT_INITIALIZED — Der Client wurde nicht initialisiert. Amazon GameLift Servers

  • GAMELIFT_SERVER_NOT_INITIALIZED — Amazon GameLift Servers Der Server wurde nicht initialisiert.

  • GAME_SESSION_ENDED_FAILED — Das Server-SDK für konnte den Dienst nicht kontaktieren, um zu melden, dass die Spielsitzung beendet wurde. Amazon GameLift Servers

  • GAME_SESSION_NOT_READY — Die Server-Spielsitzung wurde nicht aktiviert. Amazon GameLift Servers

  • GAME_SESSION_READY_FAILED — Das Server-SDK für konnte den Dienst nicht kontaktieren, um zu melden, dass die Spielsitzung bereit ist. Amazon GameLift Servers

  • INITIALIZATION_MISMATCH — Eine Client-Methode wurde nach Server: :Initialize () aufgerufen oder umgekehrt.

  • NOT_INITIALIZED — Der Amazon GameLift Servers Server oder Client wurde nicht mit Initialize () initialisiert.

  • NO_TARGET_ALIASID_SET — Eine Ziel-AliasID wurde nicht gesetzt.

  • NO_TARGET_FLEET_SET — Es wurde keine Zielflotte festgelegt.

  • PROCESS_ENDING_FAILED — Das Server-SDK für Amazon GameLift Servers konnte den Dienst nicht kontaktieren, um zu melden, dass der Prozess beendet wird.

  • PROCESS_NOT_ACTIVE — Der Serverprozess ist noch nicht aktiv, nicht an einen gebunden und kann ihn weder annehmen noch verarbeiten. GameSession PlayerSessions

  • PROCESS_NOT_READY — Der Serverprozess ist noch nicht bereit, aktiviert zu werden.

  • PROCESS_READY_FAILED — Das Server-SDK für Amazon GameLift Servers konnte den Dienst nicht kontaktieren, um zu melden, dass der Prozess bereit ist.

  • SDK_VERSION_DETECTION_FAILED — Die SDK-Versionserkennung ist fehlgeschlagen.

  • STX_CALL_FAILED — Ein Aufruf der Server-Backend-Komponente ist fehlgeschlagen. XStx

  • STX_INITIALIZATION_FAILED — Die Server-Backend-Komponente konnte nicht initialisiert werden. XStx

  • UNEXPECTED_PLAYER_SESSION — Der Server hat eine nicht registrierte Spielersitzung festgestellt.

  • WEBSOCKET_CONNECT_FAILURE

  • WEBSOCKET_CONNECT_FAILURE_FORBIDDEN

  • WEBSOCKET_CONNECT_FAILURE_UNGÜLTIGE_URL

  • TIMEOUT FÜR WEBSOCKET_CONNECT_FAILURE_

  • WEBSOCKET_RETRIABLE_SEND_MESSAGE_FAILURE — Behebbarer Fehler beim Senden einer Nachricht an den Dienst. GameLift WebSocket

  • WEBSOCKET_SEND_MESSAGE_FAILURE — Fehler beim Senden einer Nachricht an GameLift den WebSocket Dienst.

  • MATCH_BACKFILL_REQUEST_VALIDATION — Die Validierung der Anfrage ist fehlgeschlagen.

  • PLAYER_SESSION_REQUEST_VALIDATION — Die Validierung der Anfrage ist fehlgeschlagen.

PlayerSessionCreationPolicy

Zeichenfolgenwert, der angibt, ob die Spielsitzung neue Spieler akzeptiert. Gültige Werte sind:

  • ACCEPT_ALL – Akzeptiert alle neuen Spielersitzungen.

  • DENY_ALL – Verwehrt neue Spielersitzungen.

  • NOT_SET — Die Spielsitzung ist nicht so eingestellt, dass neue Spielersitzungen akzeptiert oder verweigert werden.