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\$1\$1-Server-SDK 5.x für Amazon GameLift Servers -- Datentypen
Verwenden Sie die Amazon GameLift Servers C\$1\$1-Server-SDK 5.x-Referenz, um Ihr Multiplayer-Spiel zum Hosten zu integrieren. Amazon GameLift Servers Hinweise zum Integrationsprozess finden Sie unter[Füge Amazon GameLift Servers es deinem Spieleserver mit dem Server-SDK hinzu](gamelift-sdk-server-api.md).
**Anmerkung**
In diesem Thema wird die Amazon GameLift Servers C\$1\$1-API beschrieben, die Sie verwenden können, wenn Sie mit der C\$1\$1-Standardbibliothek (`std`) bauen. Insbesondere bezieht sich diese Dokumentation auf Code, den Sie mit der `-DDGAMELIFT_USE_STD=1` Option kompilieren.
[C\$1\$1-Server-SDK 5.x für Amazon GameLift Servers -- Aktionen](integration-server-sdk5-cpp-actions.md)
**Topics**
+ [LogParameters](#integration-server-sdk5-cpp-dataypes-log)
+ [MetricsParameters](#integration-server-sdk5-cpp-datatypes-metricsparameters)
+ [ProcessParameters](#integration-server-sdk5-cpp-dataypes-process)
+ [UpdateGameSession](#integration-server-sdk5-cpp-dataypes-updategamesession)
+ [GameSession](#integration-server-sdk5-cpp-dataypes-gamesession)
+ [ServerParameters](#integration-server-sdk5-cpp-dataypes-serverparameters)
+ [StartMatchBackfillRequest](#integration-server-sdk5-cpp-dataypes-startmatchbackfillrequest)
+ [Player](#integration-server-sdk5-cpp-dataypes-player)
+ [DescribePlayerSessionsRequest](#integration-server-sdk5-cpp-dataypes-playersessions)
+ [StopMatchBackfillRequest](#integration-server-sdk5-cpp-dataypes-stopmatchbackfillrequest)
+ [AttributeValue](#integration-server-sdk5-cpp-dataypes-attributevalue)
+ [GetFleetRoleCredentialsRequest](#integration-server-sdk5-cpp-dataypes-getfleetrolecredentialsrequest)
+ [AwsLongOutcome](#integration-server-sdk5-cpp-datatypes-awslongoutcome)
+ [AwsStringOutcome](#integration-server-sdk5-cpp-datatypes-awsstringoutcome)
+ [DescribePlayerSessionsOutcome](#integration-server-sdk5-cpp-datatypes-describeplayersessionsoutcome)
+ [DescribePlayerSessionsResult](#integration-server-sdk5-cpp-datatypes-describeplayersessionsresult)
+ [GenericOutcome](#integration-server-sdk5-cpp-datatypes-genericoutcome)
+ [GenericOutcomeCallable](#integration-server-sdk5-cpp-datatypes-genericoutcomecallable)
+ [PlayerSession](#integration-server-sdk5-cpp-datatypes-playersession)
+ [StartMatchBackfillOutcome](#integration-server-sdk5-cpp-datatypes-startmatchbackfilloutcome)
+ [StartMatchBackfillResult](#integration-server-sdk5-cpp-datatypes-startmatchbackfillresult)
+ [GetComputeCertificateOutcome](#integration-server-sdk5-cpp-datatypes-getcomputecertificateoutcome)
+ [GetComputeCertificateResult](#integration-server-sdk5-cpp-datatypes-getcomputecertificateresult)
+ [GetFleetRoleCredentialsOutcome](#integration-server-sdk5-cpp-datatypes-getfleetrolecredentialsoutcome)
+ [GetFleetRoleCredentialsResult](#integration-server-sdk5-cpp-datatypes-getfleetrolecredentialsresult)
+ [Initialisieren SDKOutcome](#integration-server-sdk5-cpp-datatypes-initsdkoutcome)
+ [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)
+ [Aufzählungen](#integration-server-sdk5-cpp-dataypes-enums)
## 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()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-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 speichert`MyGame\sessionLogs\`, dann wäre der Pfad `c:\game\MyGame\sessionLogs` auf einer Windows-Instanz. **Typ:** `std:vector` **Required**: No |
## MetricsParameters
Verwenden Sie diesen Datentyp, um die Erfassung von Messwerten und die Absturzberichterstattung für den Spieleserver zu konfigurieren. Der Spieleserver kommuniziert `MetricsParameters` mit Amazon GameLift Servers in einem [InitMetrics()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initmetrics) Anruf.
| | |
| --- |--- |
| **Eigenschaften** | Beschreibung |
| StatsdHost | Der Hostname oder die IP-Adresse des StatsD-Servers für die Erfassung von Metriken. **Typ:** `std::string` **Required**: No |
| StatsdPort | Die Portnummer des StatsD-Servers für die Erfassung von Metriken. **Typ:** `int` **Required**: No |
| CrashReporterHost | Der Hostname oder die IP-Adresse des Crash-Reporter-Servers. **Typ:** `std::string` **Required**: No |
| CrashReporterPort | Die Portnummer des Crash-Reporter-Servers. **Typ:** `int` **Required**: No |
| FlushIntervalMs | Das Intervall in Millisekunden für die Übertragung von Metrikdaten an den Server. **Typ:** `int` **Required**: No |
| MaxPacketSize | Die maximale Größe in Byte für Messpakete, die an den Server gesendet werden. **Typ:** `int` **Required**: No |
## ProcessParameters
Dieser Datentyp enthält den Satz von Parametern, an den Amazon GameLift Servers in a gesendet wird[ProcessReady()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-processready).
| | |
| --- |--- |
| **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 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 Aufruf dieser Funktion 5 Minuten, bis der Serverprozess heruntergefahren ist, und antwortet mit einem [ProcessEnding()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-processending) Aufruf, bevor er den Serverprozess herunterfährt.**Typ:** `std::function 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](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_CreateGameSession.html) Die Callback-Funktion übergibt ein [GameSession](#integration-server-sdk5-cpp-dataypes-gamesession) Objekt.**Typ:** `const std::function 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](#integration-server-sdk5-cpp-dataypes-gamesession) Objekt, ein Status-Update (updateReason) und die Match-Backfill-Ticket-ID.**Typ:** `std::function 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](#integration-server-sdk5-cpp-dataypes-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:::gamesession//`. **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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html) 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()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initsdk-anywhere) 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 Einsatzszenarien [InitSDK()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initsdk) ohne Parameter auf.
| Eigenschaften | **Beschreibung** |
| --- | --- |
| webSocketUrl | Das `GameLiftServerSdkEndpoint` Amazon GameLift Servers kehrt zurück, wenn Sie [https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html)nach 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](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).**Typ:** `std::string`**Erforderlich**: Ja |
| FleetID | Die eindeutige Kennung der Flotte, für die der Computer registriert ist. Weitere Informationen finden Sie unter [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).**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](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_GetComputeAuthToken.html).**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()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-startmatchbackfill)
| Eigenschaften | **Beschreibung** |
| --- | --- |
| GameSessionArn | Eine eindeutige Kennung für die Spielsitzung. Die API-Operation `[GetGameSessionId](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-actions.html#integration-server-sdk5-cpp-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](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-server.html#match-server-data.html) 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` **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` **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](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_AttributeValue.html). **Typ:** `std::map` **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()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-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 ist`arn:aws:gamelift:::gamesession/fleet-/`. 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](player-sessions-player-identifiers.md). **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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html) **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()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-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](#integration-server-sdk5-cpp-dataypes-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: `S``N`,`SL`, oder`SDM`.
| Eigenschaften | Description |
| --- | --- |
| AttrType | Gibt den Typ des Attributwerts an. Zu den möglichen Attributwerttypen gehören: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html) **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` **Required**: No |
| SDM | Stellt ein Wörterbuch mit Zeichenkettenschlüsseln und Doppelwerten dar. **Typ:** `std::map` **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](setting-up-role.md).
| 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 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)Sitzung 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 | Description |
| --- | --- |
| 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](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Required**: No |
## AwsStringOutcome
Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:
| Eigenschaften | Description |
| --- | --- |
| 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](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Required**: No |
## DescribePlayerSessionsOutcome
Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:
| Eigenschaften | Description |
| --- | --- |
| Ergebnis | Das Ergebnis der Aktion. **Typ:** [DescribePlayerSessionsResult](#integration-server-sdk5-cpp-datatypes-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](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Required**: No |
## DescribePlayerSessionsResult
Eine Sammlung von Objekten mit Eigenschaften für jede Spielersitzung, die der Anfrage entspricht.
| Eigenschaften | Description |
| --- | --- |
| 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` **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](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Required**: No |
## GenericOutcome
Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:
| Eigenschaften | Description |
| --- | --- |
| 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](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Required**: No |
## GenericOutcomeCallable
Dieser Datentyp ist ein asynchrones generisches Ergebnis. Er besitzt die folgenden Eigenschaften:
| Eigenschaften | Description |
| --- | --- |
| 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](#integration-server-sdk5-cpp-datatypes-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](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_PlayerSession.html).
| Eigenschaften | Description |
| --- | --- |
| 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html) **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 | Description |
| --- | --- |
| Ergebnis | Das Ergebnis der Aktion. **Typ:** [StartMatchBackfillResult](#integration-server-sdk5-cpp-datatypes-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](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Required**: No |
## StartMatchBackfillResult
Dieser Datentyp resultiert aus einer Aktion und erzeugt ein Objekt mit den folgenden Eigenschaften:
| Eigenschaften | Description |
| --- | --- |
| 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 | Description |
| --- | --- |
| Ergebnis | Das Ergebnis der Aktion. **Typ:** [GetComputeCertificateResult](#integration-server-sdk5-cpp-datatypes-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](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Required**: No |
## GetComputeCertificateResult
Der Pfad zum TLS-Zertifikat auf Ihrem Computer und der Hostname des Computers.
| Eigenschaften | Description |
| --- | --- |
| CertificatePath | Der Pfad zum TLS-Zertifikat auf Ihrer Rechenressource. Wenn Sie eine Amazon GameLift Servers verwaltete Flotte verwenden, enthält dieser Pfad: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html) **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 | Description |
| --- | --- |
| Ergebnis | Das Ergebnis der Aktion. **Typ:** [GetFleetRoleCredentialsResult](#integration-server-sdk5-cpp-datatypes-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](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Required**: No |
## GetFleetRoleCredentialsResult
| Eigenschaften | Description |
| --- | --- |
| 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](integration-server-sdk5-csharp-datatypes.md#integration-server-sdk5-csharp-datatypes-gamelifterror) **Required**: No |
## Initialisieren SDKOutcome
**Anmerkung**
`InitSDKOutcome`wird nur zurückgegeben, wenn Sie das SDK mit dem Flag erstellen. `std` Wenn Sie mit dem `nostd` Flag bauen, [GenericOutcome](#integration-server-sdk5-cpp-datatypes-genericoutcome) wird es stattdessen zurückgegeben.
| Eigenschaften | Description |
| --- | --- |
| 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](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Required**: No |
## GameLiftError
| Eigenschaften | Description |
| --- | --- |
| ErrorType | Der Fehlertyp. **Typ: Eine Aufzählung**[. `GameLiftErrorType`](#integration-server-sdk5-cpp-dataypes-enums) **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\$1\$1) definierte Enums sind wie folgt definiert:
**GameLiftErrorType**
Zeichenkettenwert, der den Fehlertyp angibt. Gültige Werte sind:
+ **BAD\$1REQUEST\$1EXCEPTION**
+ **GAMESESSION\$1ID\$1NOT\$1SET — Die Spielsitzungs-ID wurde nicht festgelegt**.
+ **INTERNAL\$1SERVICE\$1EXCEPTION**
+ **LOCAL\$1CONNECTION\$1FAILED — Die lokale Verbindung** zu ist fehlgeschlagen. Amazon GameLift Servers
+ **NETWORK\$1NOT\$1INITIALIZED — Das Netzwerk wurde nicht initialisiert**.
+ **SERVICE\$1CALL\$1FAILED — Ein Aufruf eines** Dienstes ist fehlgeschlagen. AWS
+ **WEBSOCKET\$1CONNECT\$1FAILURE**
+ **WEBSOCKET\$1CONNECT\$1FAILURE\$1FORBIDDEN**
+ **WEBSOCKET\$1CONNECT\$1FAILURE\$1UNGÜLTIGE\$1URL**
+ **TIMEOUT FÜR WEBSOCKET\$1CONNECT\$1FAILURE\$1**
+ **ALREADY\$1INITIALIZED — Der Server oder Client wurde bereits mit Initialize () initialisiert.** Amazon GameLift Servers
+ **FLEET\$1MISMATCH — Die Zielflotte entspricht** nicht der Flotte einer GameSession oder PlayerSession.
+ **GAMELIFT\$1CLIENT\$1NOT\$1INITIALIZED** — Der Client wurde nicht initialisiert. Amazon GameLift Servers
+ **GAMELIFT\$1SERVER\$1NOT\$1INITIALIZED** — Amazon GameLift Servers Der Server wurde nicht initialisiert.
+ **GAME\$1SESSION\$1ENDED\$1FAILED — Das Server-SDK für konnte den Dienst** nicht kontaktieren, um zu melden, dass die Spielsitzung beendet wurde. Amazon GameLift Servers
+ **GAME\$1SESSION\$1NOT\$1READY — Die Server-Spielsitzung wurde** nicht aktiviert. Amazon GameLift Servers
+ **GAME\$1SESSION\$1READY\$1FAILED — Das Server-SDK für konnte** den Dienst nicht kontaktieren, um zu melden, dass die Spielsitzung bereit ist. Amazon GameLift Servers
+ **INITIALIZATION\$1MISMATCH** — Eine Client-Methode wurde nach Server: :Initialize () aufgerufen oder umgekehrt.
+ **NOT\$1INITIALIZED — Der Amazon GameLift Servers Server oder Client wurde nicht mit Initialize () initialisiert**.
+ **NO\$1TARGET\$1ALIASID\$1SET — Eine Ziel-AliasID** wurde nicht gesetzt.
+ NO\$1TARGET\$1FLEET\$1SET — **Es wurde keine Zielflotte festgelegt**.
+ **PROCESS\$1ENDING\$1FAILED — Das Server-SDK für Amazon GameLift Servers konnte den Dienst nicht** kontaktieren, um zu melden, dass der Prozess beendet wird.
+ **PROCESS\$1NOT\$1ACTIVE** — Der Serverprozess ist noch nicht aktiv, nicht an einen gebunden und kann ihn weder annehmen noch verarbeiten. GameSession PlayerSessions
+ **PROCESS\$1NOT\$1READY — Der Serverprozess ist noch nicht bereit**, aktiviert zu werden.
+ **PROCESS\$1READY\$1FAILED — Das Server-SDK für Amazon GameLift Servers konnte** den Dienst nicht kontaktieren, um zu melden, dass der Prozess bereit ist.
+ **SDK\$1VERSION\$1DETECTION\$1FAILED — Die SDK-Versionserkennung** ist fehlgeschlagen.
+ **STX\$1CALL\$1FAILED — Ein Aufruf** der Server-Backend-Komponente ist fehlgeschlagen. XStx
+ **STX\$1INITIALIZATION\$1FAILED — Die Server-Backend-Komponente konnte nicht initialisiert werden**. XStx
+ **UNEXPECTED\$1PLAYER\$1SESSION** — Der Server hat eine nicht registrierte Spielersitzung festgestellt.
+ **WEBSOCKET\$1CONNECT\$1FAILURE**
+ **WEBSOCKET\$1CONNECT\$1FAILURE\$1FORBIDDEN**
+ **WEBSOCKET\$1CONNECT\$1FAILURE\$1UNGÜLTIGE\$1URL**
+ **TIMEOUT FÜR WEBSOCKET\$1CONNECT\$1FAILURE\$1**
+ **WEBSOCKET\$1RETRIABLE\$1SEND\$1MESSAGE\$1FAILURE** — Behebbarer Fehler beim Senden einer Nachricht an den Dienst. GameLift WebSocket
+ **WEBSOCKET\$1SEND\$1MESSAGE\$1FAILURE** — Fehler beim Senden einer Nachricht an GameLift den WebSocket Dienst.
+ **MATCH\$1BACKFILL\$1REQUEST\$1VALIDATION** — Die Validierung der Anfrage ist fehlgeschlagen.
+ **PLAYER\$1SESSION\$1REQUEST\$1VALIDATION — Die Validierung der Anfrage ist fehlgeschlagen.**
**PlayerSessionCreationPolicy**
Zeichenfolgenwert, der angibt, ob die Spielsitzung neue Spieler akzeptiert. Gültige Werte sind:
+ **ACCEPT\$1ALL** – Akzeptiert alle neuen Spielersitzungen.
+ **DENY\$1ALL** – Verwehrt neue Spielersitzungen.
+ **NOT\$1SET** — Die Spielsitzung ist nicht so eingestellt, dass neue Spielersitzungen akzeptiert oder verweigert werden.