Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Server C\$1\$1 SDK 5.x per -- Azioni Amazon GameLift Servers
<a name="integration-server-sdk5-cpp-actions"></a>

Usa il riferimento all'SDK 5.x del server per integrare il tuo gioco multiplayer con cui ospitarlo. Amazon GameLift Servers Per indicazioni sul processo di integrazione, consulta. [Aggiungi Amazon GameLift Servers al tuo server di gioco con l'SDK del server](gamelift-sdk-server-api.md)

**Nota**  
Questo argomento descrive l'API Amazon GameLift Servers C\$1\$1 che è possibile utilizzare quando si crea con la libreria standard C\$1\$1 ()`std`. In particolare, questa documentazione si applica al codice compilato con l'opzione. `-DDGAMELIFT_USE_STD=1` 

# Server C\$1\$1 SDK 5.x per Amazon GameLift Servers -- Tipi di dati
<a name="integration-server-sdk5-cpp-datatypes"></a>

Usa il riferimento all'SDK 5.x del server Amazon GameLift Servers C\$1\$1 per integrare il tuo gioco multiplayer con cui ospitare. Amazon GameLift Servers Per indicazioni sul processo di integrazione, consulta. [Aggiungi Amazon GameLift Servers al tuo server di gioco con l'SDK del server](gamelift-sdk-server-api.md)

**Nota**  
Questo argomento descrive l'API Amazon GameLift Servers C\$1\$1 che è possibile utilizzare quando si crea con la libreria standard C\$1\$1 ()`std`. In particolare, questa documentazione si applica al codice compilato con l'opzione. `-DDGAMELIFT_USE_STD=1` 

[Server C\$1\$1 SDK 5.x per -- Azioni Amazon GameLift Servers](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)
+ [Inizialo SDKOutcome](#integration-server-sdk5-cpp-datatypes-initsdkoutcome)
+ [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)
+ [enumerazioni;](#integration-server-sdk5-cpp-dataypes-enums)

## LogParameters
<a name="integration-server-sdk5-cpp-dataypes-log"></a>

Un oggetto che identifica i file generati durante una sessione di gioco che desideri caricare e archiviare Amazon GameLift Servers al termine della sessione di gioco. Il server di gioco `LogParameters` lo fornisce Amazon GameLift Servers come parte di un `ProcessParameters` oggetto in una [ProcessReady()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-processready) chiamata.


|  |  | 
| --- |--- |
|  **Proprietà**  | Descrizione | 
| LogPaths |  L'elenco dei percorsi di directory dei file di registro del server di gioco che desideri Amazon GameLift Servers archiviare per accessi futuri. Il processo del server genera questi file durante ogni sessione di gioco. Definisci i percorsi e i nomi dei file nel tuo server di gioco e li memorizzi nella directory di build del gioco principale.  I percorsi di registro devono essere assoluti. Ad esempio, se la build del gioco memorizza i log delle sessioni di gioco in un percorso simile`MyGame\sessionLogs\`, il percorso si troverebbe `c:\game\MyGame\sessionLogs` su un'istanza di Windows. **Tipo:** `std:vector<std::string>` **Obbligatorio:** no  | 

## MetricsParameters
<a name="integration-server-sdk5-cpp-datatypes-metricsparameters"></a>

Usa questo tipo di dati per configurare la raccolta delle metriche e la segnalazione degli arresti anomali per il server di gioco. Il server di gioco comunica con `MetricsParameters` durante una Amazon GameLift Servers [InitMetrics()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initmetrics) chiamata.


|  |  | 
| --- |--- |
|  **Proprietà**  | Descrizione | 
| StatsdHost |  Il nome host o l'indirizzo IP del server StatSD per la raccolta delle metriche. **Tipo:** `std::string` **Obbligatorio:** no  | 
| StatsdPort |  Il numero di porta del server StatSD per la raccolta delle metriche. **Tipo:** `int` **Obbligatorio:** no  | 
| CrashReporterHost |  Il nome host o l'indirizzo IP del server crash reporter. **Tipo:** `std::string` **Obbligatorio:** no  | 
| CrashReporterPort |  Il numero di porta del server crash reporter. **Tipo:** `int` **Obbligatorio:** no  | 
| FlushIntervalMs |  L'intervallo in millisecondi per il trasferimento dei dati delle metriche al server. **Tipo:** `int` **Obbligatorio:** no  | 
| MaxPacketSize |  La dimensione massima in byte per i pacchetti di metriche inviati al server. **Tipo:** `int` **Obbligatorio:** no  | 

## ProcessParameters
<a name="integration-server-sdk5-cpp-dataypes-process"></a>

Questo tipo di dati contiene l'insieme di parametri inviati a in aAmazon GameLift Servers. [ProcessReady()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-processready)


|  |  | 
| --- |--- |
|  **Proprietà**  | Descrizione | 
| LogParameters | Un oggetto con percorsi di directory ai file generati durante una sessione di gioco. Amazon GameLift Serverscopia e archivia i file per accessi futuri.**Tipo:** `Aws::GameLift::Server::LogParameters`**Obbligatorio:** no | 
| OnHealthCheck | La funzione di callback che Amazon GameLift Servers richiama per richiedere un rapporto sullo stato di salute del processo del server. Amazon GameLift Serverschiama questa funzione ogni 60 secondi e attende una risposta per 60 secondi. Il processo del server ritorna TRUE se integro, FALSE se non integro. Se non viene restituita alcuna risposta, Amazon GameLift Servers registra il processo del server come non integro.**Tipo:** `std::function<bool()> onHealthCheck`**Obbligatorio:** no | 
| OnProcessTerminate | La funzione di callback che Amazon GameLift Servers richiama per forzare l'arresto del processo server. Dopo aver chiamato questa funzione, Amazon GameLift Servers attende 5 minuti che il processo server si spenga e risponda con una [ProcessEnding()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-processending) chiamata prima di chiudere il processo server.**Tipo:** `std::function<void()> onProcessTerminate`**Obbligatorio:** sì | 
| OnStartGameSession | La funzione di callback che Amazon GameLift Servers richiama l'attivazione di una nuova sessione di gioco. Amazon GameLift Serverschiama questa funzione in risposta a una richiesta del client. [CreateGameSession](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_CreateGameSession.html) La funzione di callback passa un [GameSession](#integration-server-sdk5-cpp-dataypes-gamesession) oggetto.**Tipo:** `const std::function<void(Aws::GameLift::Model::GameSession)> onStartGameSession`**Obbligatorio:** sì | 
| OnUpdateGameSession | La funzione di callback che Amazon GameLift Servers richiama per passare un oggetto di sessione di gioco aggiornato al processo del server. Amazon GameLift Serverschiama questa funzione quando è stata elaborata una richiesta di match backfill per fornire dati aggiornati sul matchmaker. Passa un [GameSession](#integration-server-sdk5-cpp-dataypes-gamesession) oggetto, uno status update (updateReason) e l'ID del ticket match backfill.**Tipo:** `std::function<void(Aws::GameLift::Server::Model::UpdateGameSession)> onUpdateGameSession`**Obbligatorio:** no | 
| Porta | Il numero di porta su cui il processo server ascolta le connessioni di nuovi giocatori. Il valore deve rientrare nella gamma di porte configurate per qualsiasi parco istanze che distribuisce questa build del server di gioco. Questo numero di porta è incluso nella sessione di gioco e negli oggetti della sessione del giocatore utilizzati dalle sessioni di gioco per la connessione a un processo server.**Tipo:** `Integer`**Obbligatorio:** sì | 

## UpdateGameSession
<a name="integration-server-sdk5-cpp-dataypes-updategamesession"></a>

Questo tipo di dati viene aggiornato a un oggetto della sessione di gioco, che include il motivo per cui la sessione di gioco è stata aggiornata e il relativo ID del ticket di backfill se il backfill viene utilizzato per riempire le sessioni dei giocatori nella sessione di gioco.


| Properties | **Descrizione** | 
| --- | --- | 
| GameSession | Oggetto [GameSession](#integration-server-sdk5-cpp-dataypes-gamesession). L'GameSessionoggetto contiene proprietà che descrivono una sessione di gioco. **Tipo:** `Aws::GameLift::Server::GameSession`**Obbligatorio:** sì | 
| UpdateReason | Il motivo per cui la sessione di gioco viene aggiornata.**Tipo:** `Aws::GameLift::Server::UpdateReason`**Obbligatorio:** sì | 
| BackfillTicketId | L'ID del ticket di backfill che tenta di aggiornare la sessione di gioco.**Tipo:** `std::string`**Obbligatorio:** no | 

## GameSession
<a name="integration-server-sdk5-cpp-dataypes-gamesession"></a>

Questo tipo di dati fornisce i dettagli di una sessione di gioco. 


| Properties | **Descrizione** | 
| --- | --- | 
| GameSessionId |  Un identificatore univoco per la sessione di gioco. L'ARN di una sessione di gioco ha il seguente formato:. `arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>` **Tipo:** `std::string` **Obbligatorio:** no  | 
| Name |  Un'etichetta descrittiva della sessione di gioco.  **Tipo:** `std::string` **Obbligatorio:** no  | 
| FleetId |  Un identificatore univoco per la flotta su cui è in esecuzione la sessione di gioco. **Tipo:** `std::string` **Obbligatorio:** no  | 
| MaximumPlayerSessionCount |  Il numero massimo di connessioni dei giocatori alla sessione di gioco. **Tipo:** `int` **Obbligatorio:** no  | 
| Porta |  Il numero di porta per la sessione di gioco. Per connettersi a un server di Amazon GameLift Servers gioco, un'app necessita sia dell'indirizzo IP che del numero di porta. **Tipo:** `in` **Obbligatorio:** no  | 
| IpAddress |  L'indirizzo IP della sessione di gioco. Per connettersi a un server di Amazon GameLift Servers gioco, un'app necessita sia dell'indirizzo IP che del numero di porta. **Tipo:** `std::string` **Obbligatorio:** no  | 
| GameSessionData |  Un set di proprietà personalizzate della sessione di gioco, formattate come valore di stringa singola.  **Tipo:** `std::string` **Obbligatorio:** no  | 
| MatchmakerData |  Informazioni sul processo di matchmaking utilizzato per creare la sessione di gioco, in sintassi JSON, formattate come stringa. Oltre alla configurazione di matchmaking utilizzata, contiene dati su tutti i giocatori assegnati alla partita, compresi gli attributi dei giocatori e le assegnazioni delle squadre. **Tipo:** `std::string` **Obbligatorio:** no  | 
| GameProperties |  Un insieme di proprietà personalizzate per una sessione di gioco, formattate come coppie chiave:valore. Queste proprietà vengono passate con una richiesta di avvio di una nuova sessione di gioco. **Tipo:** `std :: vector < GameProperty >` **Obbligatorio:** no  | 
| DnsName |  L'identificatore DNS assegnato all'istanza che esegue la sessione di gioco. I valori hanno il seguente formato: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html) Quando ti connetti a una sessione di gioco in esecuzione su una flotta abilitata per TLS, devi usare il nome DNS, non l'indirizzo IP. **Tipo:** `std::string` **Obbligatorio:** no  | 

## ServerParameters
<a name="integration-server-sdk5-cpp-dataypes-serverparameters"></a>

Informazioni utilizzate da un processo del server di gioco per stabilire una connessione con il servizio. Amazon GameLift Servers Includi questi parametri durante la chiamata [InitSDK()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initsdk-anywhere) solo se la build del server di gioco verrà distribuita su una flotta Anywhere o su una flotta di container senza l'Amazon GameLift Serversagente. Per tutti gli altri scenari di implementazione, chiama [InitSDK()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initsdk) senza parametri.


| Properties | **Descrizione** | 
| --- | --- | 
| webSocketUrl |  I `GameLiftServerSdkEndpoint` Amazon GameLift Servers rendimenti quando si utilizza [https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html)una risorsa di calcolo Amazon GameLift Servers Anywhere. **Tipo:** `std::string` **Obbligatorio:** sì   | 
| ID del processo |  Un identificatore univoco registrato nel processo del server che ospita il gioco. **Tipo:** `std::string` **Obbligatorio:** sì  | 
| hostId | HostIDViene ComputeName utilizzato al momento della registrazione del computer. Per ulteriori informazioni, consultare [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).**Tipo:** `std::string`**Obbligatorio:** sì | 
| FleetID | L'identificatore univoco del parco macchine su cui è registrato il computer. Per ulteriori informazioni, consultare [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).**Tipo:** `std::string`**Obbligatorio:** sì | 
| AuthToken | Il token di autenticazione generato da Amazon GameLift Servers questo autentica il server su. Amazon GameLift Servers Per ulteriori informazioni, consultare [GetComputeAuthToken](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_GetComputeAuthToken.html).**Tipo:** `std::string`**Obbligatorio:** sì | 

## StartMatchBackfillRequest
<a name="integration-server-sdk5-cpp-dataypes-startmatchbackfillrequest"></a>

Informazioni utilizzate per creare una richiesta di matchmaking backfill. Il server di gioco comunica queste informazioni durante una chiamataAmazon GameLift Servers. [StartMatchBackfill()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-startmatchbackfill)


| Properties | **Descrizione** | 
| --- | --- | 
| GameSessionArn |  Un identificatore univoco della sessione di gioco. L'operazione API `[GetGameSessionId](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-actions.html#integration-server-sdk5-cpp-getgamesessionid)` restituisce l'identificatore in formato ARN. **Tipo:** `std::string` **Obbligatorio:** sì  | 
| MatchmakingConfigurationArn |  Un identificatore univoco, sotto forma di ARN, che il matchmaker può utilizzare per questa richiesta. L'ARN del matchmaker per la sessione di gioco originale si trova nell'oggetto della sessione di gioco nella proprietà matchmaker data. Scopri di più sui dati dei matchmaker in [Work](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-server.html#match-server-data.html) with matchmaker data. **Tipo:** `std::string` **Obbligatorio:** sì  | 
| Players |  Un insieme di dati che rappresenta tutti i giocatori che partecipano alla sessione di gioco. Il matchmaker utilizza queste informazioni per cercare nuovi giocatori che rappresentano un buon abbinamento per i giocatori attuali. **Tipo:** `std::vector<Player>` **Obbligatorio:** sì  | 
| TicketId |  Un identificatore univoco per un ticket di richiesta di matchmaking o match backfill. Se non fornisci un valore, Amazon GameLift Servers ne genera uno. Utilizzare questo identificatore per monitorare lo stato del ticket di backfill degli abbinamenti o annullare la richiesta, se necessario.  **Tipo:** `std::string` **Obbligatorio:** no  | 

## Player
<a name="integration-server-sdk5-cpp-dataypes-player"></a>

Questo tipo di dati rappresenta un giocatore in matchmaking. Quando si avvia una richiesta di matchmaking, un giocatore ha un ID giocatore, attributi e possibilmente dati di latenza. Amazon GameLift Serversaggiunge le informazioni sulla squadra dopo una partita.


| Properties | **Descrizione** | 
| --- | --- | 
| LatencyInSM |  Un insieme di valori espressi in millisecondi che indica la quantità di latenza che un giocatore sperimenta quando è connesso a una posizione.  Se viene utilizzata questa proprietà, il giocatore viene abbinato solo per le posizioni elencate. Se un matchmaker ha una regola che valuta la latenza dei giocatori, i giocatori devono segnalare la latenza per essere abbinati. **Tipo:** `Dictionary<string,int>` **Obbligatorio:** no  | 
| PlayerAttributes |  Una raccolta di coppie chiave:valore contenenti informazioni sui giocatori da utilizzare nel matchmaking. Le chiavi degli attributi del giocatore devono corrispondere a quelle PlayerAttributes utilizzate in un set di regole di matchmaking. Per ulteriori informazioni sugli attributi dei giocatori, vedi [AttributeValue](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_AttributeValue.html). **Tipo:** `std::map<std::string,AttributeValue>` **Obbligatorio:** no  | 
| PlayerId |  Un identificatore univoco per un giocatore. **Tipo:** `std::string` **Obbligatorio:** no  | 
| Team |  Il nome della squadra a cui è assegnato il giocatore in una partita. Definisci il nome della squadra nel set di regole del matchmaking. **Tipo:** `std::string` **Obbligatorio:** no  | 

## DescribePlayerSessionsRequest
<a name="integration-server-sdk5-cpp-dataypes-playersessions"></a>

Un oggetto che specifica le sessioni dei giocatori da recuperare. Il processo server fornisce queste informazioni con una [DescribePlayerSessions()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-describeplayersessions) chiamata a. Amazon GameLift Servers


| Properties | **Descrizione** | 
| --- | --- | 
| GameSessionId |  Un identificatore univoco della sessione di gioco. Utilizzare questo parametro per richiedere tutte le sessioni giocatore per la sessione di gioco specificata.  Il formato dell'ID della sessione di gioco è`arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>`. `GameSessionID`È una stringa ID personalizzata o un **Tipo:** `std::string` **Obbligatorio:** no  | 
| PlayerSessionId |  L'identificatore univoco per una sessione di gioco. Usa questo parametro per richiedere una singola sessione di gioco specifica. **Tipo:** `std::string` **Obbligatorio:** no  | 
| PlayerId |  L'identificatore univoco di un giocatore. Usa questo parametro per richiedere tutte le sessioni di gioco per un giocatore specifico. Per informazioni, consulta [Genera giocatore IDs](player-sessions-player-identifiers.md). **Tipo:** `std::string` **Obbligatorio:** no  | 
| PlayerSessionStatusFilter |  Lo stato della sessione del giocatore su cui filtrare i risultati. I possibili stati delle sessioni di gioco includono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html) **Tipo:** `std::string` **Obbligatorio:** no  | 
| NextToken |  Il token che indica l'inizio della pagina successiva di risultati. Per specificare l'inizio del set di risultati, non fornire un valore. Se fornisci un ID di sessione del giocatore, questo parametro viene ignorato. **Tipo:** `std::string` **Obbligatorio:** no  | 
| Limite |  Numero massimo di risultati da restituire. Se fornisci un ID di sessione del giocatore, questo parametro viene ignorato. **Tipo:** `int` **Obbligatorio:** no  | 

## StopMatchBackfillRequest
<a name="integration-server-sdk5-cpp-dataypes-stopmatchbackfillrequest"></a>

Informazioni utilizzate per annullare una richiesta di matchmaking backfill. Il server di gioco comunica queste informazioni al Amazon GameLift Servers servizio durante una chiamata. [StopMatchBackfill()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-stopmatchbackfill)


| Properties | **Descrizione** | 
| --- | --- | 
| GameSessionArn |  Un identificatore univoco della sessione di gioco della richiesta annullata. **Tipo:** `char[]` **Obbligatorio:** no  | 
| MatchmakingConfigurationArn |  Un identificatore univoco del matchmaker a cui è stata inviata questa richiesta. **Tipo:** `char[]` **Obbligatorio:** no  | 
| TicketId |  Un identificatore univoco del ticket di richiesta di riempimento da annullare. **Tipo:** `char[]` **Obbligatorio:** no  | 

## AttributeValue
<a name="integration-server-sdk5-cpp-dataypes-attributevalue"></a>

Utilizzate questi valori nelle [Player](#integration-server-sdk5-cpp-dataypes-player) coppie chiave-valore degli attributi. Questo oggetto consente di specificare il valore di un attributo utilizzando uno qualsiasi dei tipi di dati validi: stringa, numero, array di stringhe o mappa di dati. Ogni `AttributeValue` oggetto deve utilizzare esattamente una delle proprietà disponibili: `S``N`,`SL`, o`SDM`.


| Properties | Description | 
| --- | --- | 
| AttrType |  Speciifica il tipo di valore dell'attributo. I possibili tipi di valori degli attributi includono:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html) **Obbligatorio:** no  | 
| S |  Rappresenta un valore di attributo di tipo stringa. **Tipo:** `std::string` **Obbligatorio:** no  | 
| N |  Rappresenta un valore di attributo numerico. **Tipo:** `double` **Obbligatorio:** no  | 
| SL |  Rappresenta una matrice di valori di attributi di tipo stringa. **Tipo:** `std::vector<std::string>` **Obbligatorio:** no  | 
| SDM |  Rappresenta un dizionario di chiavi di stringa e valori doppi. **Tipo:** `std::map<std::string, double>` **Obbligatorio:** no  | 

## GetFleetRoleCredentialsRequest
<a name="integration-server-sdk5-cpp-dataypes-getfleetrolecredentialsrequest"></a>

Questo tipo di dati offre al server di gioco un accesso limitato alle altre risorse. AWS Per ulteriori informazioni, consultare [Configurare un ruolo di servizio IAM per Amazon GameLift Servers](setting-up-role.md).


| Properties | **Descrizione** | 
| --- | --- | 
| RoleArn | L'Amazon Resource Name (ARN) del ruolo di servizio che estende l'accesso limitato alle tue AWS risorse.**Tipo:** `std::string`**Obbligatorio:** no | 
| RoleSessionName | Il nome della sessione di ruolo che puoi utilizzare per identificare in modo univoco una AWS Security Token Service [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)sessione. Questo nome è esposto nei log di controllo, come quelli di. CloudTrail **Tipo:** `std::string`  **Obbligatorio:** no  | 

## AwsLongOutcome
<a name="integration-server-sdk5-cpp-datatypes-awslongoutcome"></a>

Questo tipo di dati risulta da un'azione e produce un oggetto con le seguenti proprietà:


| Properties | Description | 
| --- | --- | 
| Risultato |  Il risultato dell'azione. **Tipo:** `long` **Obbligatorio:** no  | 
| ResultWithOwnership |   Il risultato dell'azione, espresso come rvalue, in modo che il codice chiamante possa assumere la proprietà dell'oggetto.  **Tipo:** `long&&` **Obbligatorio:** no  | 
| Completato |  Se l'azione ha avuto successo o meno. **Tipo:** `bool` **Obbligatorio:** sì  | 
| Errore |  L'errore che si è verificato se l'azione non ha avuto successo. **Tipo:** [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Obbligatorio:** no  | 

## AwsStringOutcome
<a name="integration-server-sdk5-cpp-datatypes-awsstringoutcome"></a>

Questo tipo di dati risulta da un'azione e produce un oggetto con le seguenti proprietà:


| Properties | Description | 
| --- | --- | 
| Risultato |  Il risultato dell'azione. **Tipo:** `std::string` **Obbligatorio:** no  | 
| ResultWithOwnership |   Il risultato dell'azione, espresso come rvalue, in modo che il codice chiamante possa assumere la proprietà dell'oggetto.  **Tipo:** `long&&` **Obbligatorio:** no  | 
| Completato |  Se l'azione ha avuto successo o meno. **Tipo:** `bool` **Obbligatorio:** sì  | 
| Errore |  L'errore che si è verificato se l'azione non ha avuto successo. **Tipo:** [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Obbligatorio:** no  | 

## DescribePlayerSessionsOutcome
<a name="integration-server-sdk5-cpp-datatypes-describeplayersessionsoutcome"></a>

Questo tipo di dati risulta da un'azione e produce un oggetto con le seguenti proprietà:


| Properties | Description | 
| --- | --- | 
| Risultato |  Il risultato dell'azione. **Tipo:** [DescribePlayerSessionsResult](#integration-server-sdk5-cpp-datatypes-describeplayersessionsresult) **Obbligatorio:** no   | 
| ResultWithOwnership |   Il risultato dell'azione, espresso come rvalue, in modo che il codice chiamante possa assumere la proprietà dell'oggetto.  **Tipo:** `Aws::GameLift::Server::Model::DescribePlayerSessionsResult&&` **Obbligatorio:** no  | 
| Completato |  Se l'azione ha avuto successo o meno. **Tipo:** `bool` **Obbligatorio:** sì  | 
| Errore |  L'errore che si è verificato se l'azione non ha avuto successo. **Tipo:** [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Obbligatorio:** no  | 

## DescribePlayerSessionsResult
<a name="integration-server-sdk5-cpp-datatypes-describeplayersessionsresult"></a>

Una raccolta di oggetti contenente proprietà per ogni sessione di giocatore che corrisponde alla richiesta. 


| Properties | Description | 
| --- | --- | 
| NextToken |  Un token che indica l'inizio della successiva pagina sequenziale di risultati. Utilizzate il token restituito con una precedente chiamata a questa operazione. Per iniziare dall'inizio del set di risultati, non specificate un valore. Se viene specificato un ID sessione giocatore, questo parametro verrà ignorato.  **Tipo:** `std::string` **Obbligatorio:** sì  | 
| PlayerSessions |  **Tipo:** `IList<PlayerSession>` **Campo obbligatorio**:   | 
| ResultWithOwnership |   Il risultato dell'azione, espresso come rvalue, in modo che il codice chiamante possa assumere la proprietà dell'oggetto.  **Tipo:** `std::string&&` **Obbligatorio:** no  | 
| Completato |  Se l'azione ha avuto successo o meno. **Tipo:** `bool` **Obbligatorio:** sì  | 
| Errore |  L'errore che si è verificato se l'azione non ha avuto successo. **Tipo:** [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Obbligatorio:** no  | 

## GenericOutcome
<a name="integration-server-sdk5-cpp-datatypes-genericoutcome"></a>

Questo tipo di dati risulta da un'azione e produce un oggetto con le seguenti proprietà:


| Properties | Description | 
| --- | --- | 
| Completato |  Se l'azione ha avuto successo o meno. **Tipo:** `bool` **Obbligatorio:** sì  | 
| Errore |  L'errore che si è verificato se l'azione non ha avuto successo. **Tipo:** [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Obbligatorio:** no  | 

## GenericOutcomeCallable
<a name="integration-server-sdk5-cpp-datatypes-genericoutcomecallable"></a>

Questo tipo di dati è un risultato generico asincrono. Possiede le seguenti proprietà: 


| Properties | Description | 
| --- | --- | 
| Completato |  Se l'azione ha avuto successo o meno. **Tipo:** `bool` **Obbligatorio:** sì  | 
| Errore |  L'errore che si è verificato se l'azione non ha avuto successo. **Tipo:** [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Obbligatorio:** no  | 

## PlayerSession
<a name="integration-server-sdk5-cpp-datatypes-playersession"></a>

Questo tipo di dati rappresenta una sessione del giocatore che passa al server di gioco. Amazon GameLift Servers Per ulteriori informazioni, consulta [PlayerSession](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_PlayerSession.html). 


| Properties | Description | 
| --- | --- | 
| CreationTime |  **Tipo:** `long` **Obbligatorio:** no  | 
| FleetId |  **Tipo:** `std::string` **Obbligatorio:** no  | 
| GameSessionId |  **Tipo:** `std::string` **Obbligatorio:** no  | 
| IpAddress |  **Tipo:** `std::string` **Obbligatorio:** no  | 
| PlayerData |  **Tipo:** `std::string` **Obbligatorio:** no  | 
| PlayerId |  **Tipo:** `std::string` **Obbligatorio:** no  | 
| PlayerSessionId |  **Tipo:** `std::string` **Obbligatorio:** no  | 
| Porta |  **Tipo:** `int` **Obbligatorio:** no  | 
| Status |  Stato sessione giocatore su cui filtrare i risultati. Quando PlayerId viene fornito un PlayerSessionId or, non PlayerSessionStatusFilter ha alcun effetto sulla risposta.  **Tipo:** Un `PlayerSessionStatus` enum. I valori possibili sono:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html) **Obbligatorio:** no  | 
| TerminationTime |  **Tipo:** `long` **Obbligatorio:** no  | 
| DnsName |  **Tipo:** `std::string` **Obbligatorio:** no  | 

## StartMatchBackfillOutcome
<a name="integration-server-sdk5-cpp-datatypes-startmatchbackfilloutcome"></a>

Questo tipo di dati risulta da un'azione e produce un oggetto con le seguenti proprietà:


| Properties | Description | 
| --- | --- | 
| Risultato |  Il risultato dell'azione. **Tipo:** [StartMatchBackfillResult](#integration-server-sdk5-cpp-datatypes-startmatchbackfillresult) **Obbligatorio:** no  | 
| ResultWithOwnership |   Il risultato dell'azione, espresso come rvalue, in modo che il codice chiamante possa assumere la proprietà dell'oggetto.  **Tipo:** `StartMatchBackfillResult&&` **Obbligatorio:** no  | 
| Completato |  Se l'azione ha avuto successo o meno. **Tipo:** `bool` **Obbligatorio:** sì  | 
| Errore |  L'errore che si è verificato se l'azione non ha avuto successo. **Tipo:** [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Obbligatorio:** no  | 

## StartMatchBackfillResult
<a name="integration-server-sdk5-cpp-datatypes-startmatchbackfillresult"></a>

Questo tipo di dati risulta da un'azione e produce un oggetto con le seguenti proprietà:


| Properties | Description | 
| --- | --- | 
| TicketId |  Un identificatore univoco per un ticket di matchmaking. Se qui non viene specificato alcun ID del ticket, ne Amazon GameLift Servers genererà uno sotto forma di UUID. Usa questo identificatore per tenere traccia dello stato del ticket di backfill della partita e recuperare i risultati della partita.  **Tipo:** `std::string` **Obbligatorio:** no  | 

## GetComputeCertificateOutcome
<a name="integration-server-sdk5-cpp-datatypes-getcomputecertificateoutcome"></a>

Questo tipo di dati risulta da un'azione e produce un oggetto con le seguenti proprietà:


| Properties | Description | 
| --- | --- | 
| Risultato |  Il risultato dell'azione. **Tipo:** [GetComputeCertificateResult](#integration-server-sdk5-cpp-datatypes-getcomputecertificateresult) **Obbligatorio:** no   | 
| ResultWithOwnership |   Il risultato dell'azione, espresso come rvalue, in modo che il codice chiamante possa assumere la proprietà dell'oggetto.  **Tipo:** `Aws::GameLift::Server::Model::GetComputeCertificateResult&&` **Obbligatorio:** no  | 
| Completato |  Se l'azione ha avuto successo o meno. **Tipo:** `bool` **Obbligatorio:** sì  | 
| Errore |  L'errore che si è verificato se l'azione non ha avuto successo. **Tipo:** [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Obbligatorio:** no  | 

## GetComputeCertificateResult
<a name="integration-server-sdk5-cpp-datatypes-getcomputecertificateresult"></a>

Il percorso del certificato TLS sul computer e il nome host del computer.


| Properties | Description | 
| --- | --- | 
| CertificatePath |  Il percorso del certificato TLS sulla tua risorsa di elaborazione. Quando si utilizza una flotta Amazon GameLift Servers gestita, questo percorso contiene:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html) **Tipo:** `std::string` **Obbligatorio:** no  | 
| ComputeName |  Il nome della risorsa di calcolo. **Tipo:** `std::string` **Obbligatorio:** no  | 

## GetFleetRoleCredentialsOutcome
<a name="integration-server-sdk5-cpp-datatypes-getfleetrolecredentialsoutcome"></a>

Questo tipo di dati risulta da un'azione e produce un oggetto con le seguenti proprietà:


| Properties | Description | 
| --- | --- | 
| Risultato |  Il risultato dell'azione. **Tipo:** [GetFleetRoleCredentialsResult](#integration-server-sdk5-cpp-datatypes-getfleetrolecredentialsresult) **Obbligatorio:** no   | 
| ResultWithOwnership |   Il risultato dell'azione, espresso come rvalue, in modo che il codice chiamante possa assumere la proprietà dell'oggetto.  **Tipo:** `Aws::GameLift::Server::Model::GetFleetRoleCredentialsResult` **Obbligatorio:** no  | 
| Completato |  Se l'azione ha avuto successo o meno. **Tipo:** `bool` **Obbligatorio:** sì  | 
| Errore |  L'errore che si è verificato se l'azione non ha avuto successo. **Tipo:** [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Obbligatorio:** no  | 

## GetFleetRoleCredentialsResult
<a name="integration-server-sdk5-cpp-datatypes-getfleetrolecredentialsresult"></a>


| Properties | Description | 
| --- | --- | 
| AccessKeyId |  L'ID della chiave di accesso per autenticare e fornire l'accesso alle tue risorse. AWS  **Tipo:** `string` **Obbligatorio:** no  | 
| AssumedRoleId |  L'ID dell'utente a cui appartiene il ruolo di servizio. **Tipo:** `string` **Obbligatorio:** no  | 
| AssumedRoleUserArn |  L'Amazon Resource Name (ARN) dell'utente a cui appartiene il ruolo di servizio. **Tipo:** `string` **Obbligatorio:** no  | 
| Scadenza |  Il periodo di tempo che manca alla scadenza delle credenziali di sessione. **Tipo:** `DateTime` **Obbligatorio:** no  | 
| SecretAccessKey |  L'ID della chiave di accesso segreta per l'autenticazione. **Tipo:** `string` **Obbligatorio:** no  | 
| SessionToken |  Un token per identificare la sessione attiva corrente che interagisce con AWS le tue risorse. **Tipo:** `string` **Obbligatorio:** no  | 
| Completato |  Se l'azione ha avuto successo o meno. **Tipo:** `bool` **Obbligatorio:** sì  | 
| Errore |  L'errore che si è verificato se l'azione non ha avuto successo. **Tipo:** [GameLiftError](integration-server-sdk5-csharp-datatypes.md#integration-server-sdk5-csharp-datatypes-gamelifterror) **Obbligatorio:** no  | 

## Inizialo SDKOutcome
<a name="integration-server-sdk5-cpp-datatypes-initsdkoutcome"></a>

**Nota**  
`InitSDKOutcome`viene restituito solo quando si crea l'SDK con il flag. `std` Se si crea con la `nostd` bandiera, allora [GenericOutcome](#integration-server-sdk5-cpp-datatypes-genericoutcome) viene invece restituito.


| Properties | Description | 
| --- | --- | 
| Completato |  Se l'azione ha avuto successo o meno. **Tipo:** `bool` **Obbligatorio:** sì  | 
| Errore |  L'errore che si è verificato se l'azione non ha avuto successo. **Tipo:** [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror) **Obbligatorio:** no  | 

## GameLiftError
<a name="integration-server-sdk5-cpp-datatypes-gamelifterror"></a>


| Properties | Description | 
| --- | --- | 
| ErrorType |  Il tipo di errore. **Tipo: Un enum**[. `GameLiftErrorType`](#integration-server-sdk5-cpp-dataypes-enums) **Obbligatorio:** no   | 
| ErrorName |  Il nome dell'errore.  **Tipo:** `std::string`  **Obbligatorio:** no   | 
| ErrorMessage |  Messaggio di errore.  **Tipo:** `std::string`  **Obbligatorio:** no   | 

## enumerazioni;
<a name="integration-server-sdk5-cpp-dataypes-enums"></a>

Le enumerazioni definite per l'SDK del server per Amazon GameLift Servers (C\$1\$1) sono definite come segue: 

**GameLiftErrorType**  
Valore di stringa che indica il tipo di errore. I valori validi includono:  
+ **BAD\$1REQUEST\$1EXCEPTION** 
+ **GAMESESSION\$1ID\$1NOT\$1SET — L'ID della sessione di gioco non è stato impostato**. 
+ **INTERNAL\$1SERVICE\$1EXCEPTION** 
+ **LOCAL\$1CONNECTION\$1FAILED — La connessione locale** a non è riuscita. Amazon GameLift Servers 
+ **NETWORK\$1NOT\$1INITIALIZED — La rete non è stata inizializzata**. 
+ **SERVICE\$1CALL\$1FAILED — Una chiamata a un servizio** non è riuscita. AWS 
+ **WEBSOCKET\$1CONNECT\$1FAILURE** 
+ **WEBSOCKET\$1CONNECT\$1FAILURE\$1FORBIDDEN** 
+ **URL NON VALIDO DI WEBSOCKET\$1CONNECT\$1FAILURE\$1NON VALIDO** 
+ **WEBSOCKET\$1CONNECT\$1FAILURE\$1TIMEOUT** 
+ **ALREADY\$1INITIALIZED — Il server o il client è già stato inizializzato con Initialize** (). Amazon GameLift Servers 
+ **FLEET\$1MISMATCH — La flotta bersaglio non corrisponde alla** flotta di una GameSession o PlayerSession. 
+ **GAMELIFT\$1CLIENT\$1NOT\$1INITIALIZED** — Il client non è stato inizializzato. Amazon GameLift Servers 
+ **GAMELIFT\$1SERVER\$1NOT\$1INITIALIZED** — Amazon GameLift Servers Il server non è stato inizializzato. 
+ **GAME\$1SESSION\$1ENDED\$1FAILED: l'SDK del server non è riuscito a contattare** il servizio per segnalare la fine della sessione di gioco. Amazon GameLift Servers 
+ GAME\$1SESSION\$1NOT\$1READY — La sessione di **gioco** sul server non è stata attivata. Amazon GameLift Servers 
+ **GAME\$1SESSION\$1READY\$1FAILED: l'SDK del server per cui non è stato possibile contattare il servizio per segnalare che la sessione di gioco è pronta**. Amazon GameLift Servers 
+ **INITIALIZATION\$1MISMATCH** — È stato chiamato un metodo client dopo Server: :Initialize () o viceversa. 
+ **NOT\$1INITIALIZED — Il Amazon GameLift Servers server o il client non sono stati inizializzati** con Initialize (). 
+ **NO\$1TARGET\$1ALIASID\$1SET** — Non è stato impostato un aliasID di destinazione. 
+ **NO\$1TARGET\$1FLEET\$1SET** — Non è stata impostata una flotta di obiettivi. 
+ **PROCESS\$1ENDING\$1FAILED: l'SDK del server non è riuscito** a contattare il servizio per segnalare la fine del processo. Amazon GameLift Servers 
+ **PROCESS\$1NOT\$1ACTIVE — Il processo del server non è ancora attivo**, non è associato a un e non può accettare o elaborare. GameSession PlayerSessions 
+ **PROCESS\$1NOT\$1READY — Il processo del server non è ancora pronto** per essere attivato. 
+ **PROCESS\$1READY\$1FAILED: l'SDK del server non è riuscito** a contattare il servizio per Amazon GameLift Servers segnalare che il processo è pronto. 
+ SDK\$1VERSION\$1DETECTION\$1FAILED — Rilevamento della **versione SDK** non riuscito. 
+ **STX\$1CALL\$1FAILED** — Una chiamata al componente di backend del server non è riuscita. XStx 
+ **STX\$1INITIALIZATION\$1FAILED — L'inizializzazione** del componente di backend del server non è riuscita. XStx 
+ **UNEXPECTED\$1PLAYER\$1SESSION — Il server ha rilevato una sessione di giocatore non registrata**. 
+ **WEBSOCKET\$1CONNECT\$1FAILURE** 
+ **WEBSOCKET\$1CONNECT\$1FAILURE\$1FORBIDDEN** 
+ **URL NON VALIDO DI WEBSOCKET\$1CONNECT\$1FAILURE\$1NON VALIDO** 
+ **WEBSOCKET\$1CONNECT\$1FAILURE\$1TIMEOUT** 
+ **WEBSOCKET\$1RETRIABLE\$1SEND\$1MESSAGE\$1FAILURE** — Errore recuperabile nell'invio di un messaggio al servizio. GameLift WebSocket 
+ **WEBSOCKET\$1SEND\$1MESSAGE\$1FAILURE — Errore** nell'invio di un messaggio al GameLift servizio. WebSocket 
+ **MATCH\$1BACKFILL\$1REQUEST\$1VALIDATION** — La convalida della richiesta non è riuscita. 
+ **PLAYER\$1SESSION\$1REQUEST\$1VALIDATION** — La convalida della richiesta non è riuscita. 

**PlayerSessionCreationPolicy**  
Valore della stringa che indica se la sessione di gioco accetta nuovi giocatori. I valori validi includono:   
+ **ACCEPT\$1ALL**: accetta tutte le nuove sessioni giocatore. 
+ **DENY\$1ALL**: rifiuta tutte le nuove sessioni giocatore. 
+ **NOT\$1SET** — La sessione di gioco non è impostata per accettare o rifiutare sessioni di nuovi giocatori. 

[Server C\$1\$1 SDK 5.x per Amazon GameLift Servers -- Tipi di dati](integration-server-sdk5-cpp-datatypes.md)

**Topics**
+ [Server C\$1\$1 SDK 5.x per Amazon GameLift Servers -- Tipi di dati](integration-server-sdk5-cpp-datatypes.md)
+ [GetSdkVersion()](#integration-server-sdk5-cpp-getsdkversion)
+ [InitMetrics()](#integration-server-sdk5-cpp-initmetrics)
+ [InitSDK()](#integration-server-sdk5-cpp-initsdk)
+ [InitSDK()](#integration-server-sdk5-cpp-initsdk-anywhere)
+ [ProcessReady()](#integration-server-sdk5-cpp-processready)
+ [ProcessReadyAsync()](#integration-server-sdk5-cpp-processreadyasync)
+ [ProcessEnding()](#integration-server-sdk5-cpp-processending)
+ [ActivateGameSession()](#integration-server-sdk5-cpp-activategamesession)
+ [UpdatePlayerSessionCreationPolicy()](#integration-server-sdk5-cpp-updateplayersessioncreationpolicy)
+ [GetGameSessionId()](#integration-server-sdk5-cpp-getgamesessionid)
+ [GetTerminationTime()](#integration-server-sdk5-cpp-getterm)
+ [AcceptPlayerSession()](#integration-server-sdk5-cpp-acceptplayersession)
+ [RemovePlayerSession()](#integration-server-sdk5-cpp-removeplayersession)
+ [DescribePlayerSessions()](#integration-server-sdk5-cpp-describeplayersessions)
+ [StartMatchBackfill()](#integration-server-sdk5-cpp-startmatchbackfill)
+ [StopMatchBackfill()](#integration-server-sdk5-cpp-stopmatchbackfill)
+ [GetComputeCertificate()](#integration-server-sdk5-cpp-getcomputecertificate)
+ [GetFleetRoleCredentials()](#integration-server-sdk5-cpp-getfleetrolecredentials)
+ [Distruggi ()](#integration-server-sdk5-cpp-ref-destroy)

## GetSdkVersion()
<a name="integration-server-sdk5-cpp-getsdkversion"></a>

Restituisce il numero di versione corrente dell'SDK integrato nel processo del server.

### Sintassi
<a name="integration-server-sdk5-cpp-getsdkversion-syntax"></a>

```
Aws::GameLift::AwsStringOutcome Server::GetSdkVersion();
```

### Valore restituito
<a name="integration-server-sdk5-cpp-getsdkversion-return"></a>

Se l'esito è positivo, restituisce la versione corrente dell'SDK come oggetto [AwsStringOutcome](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-datatypes-awsstringoutcome). L'oggetto restituito include il numero di versione (esempio`5.0.0`). Se l'esito è negativo, verrà restituito un messaggio di errore.

### Esempio
<a name="integration-server-sdk5-cpp-getsdkversion-example"></a>

```
Aws::GameLift::AwsStringOutcome SdkVersionOutcome = Aws::GameLift::Server::GetSdkVersion(); 
```

## InitMetrics()
<a name="integration-server-sdk5-cpp-initmetrics"></a>

Inizializza il sistema di metriche per la raccolta e la segnalazione dei dati sulle prestazioni del server. Per ottenere i migliori risultati, chiamate prima questo metodo per abilitare la raccolta delle metriche [InitSDK()](#integration-server-sdk5-cpp-initsdk) durante l'inizializzazione dell'SDK.

### Sintassi
<a name="integration-server-sdk5-cpp-initmetrics-syntax"></a>

```
Aws::GameLift::GenericOutcome InitMetrics();
Aws::GameLift::GenericOutcome InitMetrics(const Aws::GameLift::Server::MetricsParameters &metricsParameters);
```

### Parameters
<a name="integration-server-sdk5-cpp-initmetrics-parameter"></a>

[MetricsParameters](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-datatypes-metricsparameters) (facoltativo)  
Parametri di configurazione per la raccolta delle metriche. Se non viene fornito, utilizza valori predefiniti che possono essere sostituiti dalle variabili di ambiente.

### Valore restituito
<a name="integration-server-sdk5-cpp-initmetrics-return"></a>

In caso di successo, restituisce un [GenericOutcome](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-datatypes-genericoutcome) oggetto che indica il successo. Se l'esito è negativo, verrà restituito un messaggio di errore.

### Esempio
<a name="integration-server-sdk5-cpp-initmetrics-example"></a>

```
// Initialize with default parameters (uses environment variables if available)
// Defaults: localhost:8125 for StatsD, localhost:8126 for crash reporter
// FlushInterval: 10000ms, MaxPacketSize: 512 bytes
Aws::GameLift::GenericOutcome outcome = Aws::GameLift::Server::InitMetrics();
if (outcome.IsSuccess()) {
    // Metrics system initialized successfully
}

// Initialize with custom parameters
Aws::GameLift::Server::MetricsParameters metricsParams("localhost", 8125, "crash-host", 8126, 5000, 1024);
Aws::GameLift::GenericOutcome customOutcome = Aws::GameLift::Server::InitMetrics(metricsParams);
if (customOutcome.IsSuccess()) {
    // Metrics system initialized with custom parameters
}
```

## InitSDK()
<a name="integration-server-sdk5-cpp-initsdk"></a>

Inizializza l'SDK Amazon GameLift Servers. Chiama questo metodo all'avvio prima di qualsiasi altro passaggio di inizializzazione relativo aAmazon GameLift Servers. Questa azione legge i parametri del server dall'ambiente host per impostare la comunicazione tra il processo del server di gioco e il Amazon GameLift Servers servizio. Utilizza un token di idempotenza, quindi puoi riprovare a ripetere questa chiamata in tutta sicurezza quando fallisce.

Se la build del server di gioco verrà implementata senza l'Amazon GameLift ServersAgent to a Amazon GameLift Servers Anywhere fleet o la flotta di container, chiama [InitSDK()](#integration-server-sdk5-cpp-initsdk-anywhere) e specifica una serie di parametri del server.

### Sintassi
<a name="integration-server-sdk5-cpp-initsdk-syntax"></a>

```
Server::InitSDKOutcome Server::initSdkOutcome = InitSDK();
```

### Valore restituito
<a name="integration-server-sdk5-cpp-initsdk-return"></a>

Restituisce un [Inizialo SDKOutcome](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-datatypes-initsdkoutcome) oggetto che indica se il processo del server è pronto per la chiamata. [ProcessReady()](#integration-server-sdk5-cpp-processready) 

### Esempio
<a name="integration-server-sdk5-cpp-initsdk-example"></a>

```
//Call InitSDK to establish a local connection with the Amazon GameLift Servers Agent to enable further communication.
Aws::GameLift::Server::InitSDKOutcome initSdkOutcome = 
  Aws::GameLift::Server::InitSDK();
```

## InitSDK()
<a name="integration-server-sdk5-cpp-initsdk-anywhere"></a>

Inizializza l'SDK Amazon GameLift Servers. Chiama questo metodo all'avvio prima di qualsiasi altro passaggio di inizializzazione relativo aAmazon GameLift Servers. Questa azione richiede una serie di parametri del server per impostare la comunicazione tra il processo del server di gioco e il Amazon GameLift Servers servizio. Utilizza un token di idempotenza, quindi puoi riprovare a ripetere questa chiamata in tutta sicurezza quando fallisce.

Se la build del server di gioco verrà distribuita su una flotta EC2 Amazon GameLift Servers gestita o su una flotta o una flotta di container Amazon GameLift Servers Anywhere con l'Amazon GameLift ServersAgent, chiama senza parametri del server. [InitSDK()](#integration-server-sdk5-cpp-initsdk)

### Sintassi
<a name="integration-server-sdk5-cpp-initsdk-anywhere-syntax"></a>

```
Server::InitSDKOutcome Server::initSdkOutcome = InitSDK(serverParameters);
```

### Parameters
<a name="integration-server-sdk5-cpp-initsdk-anywhere-parameter"></a>

[ServerParameters](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-serverparameters)  
Per inizializzare un server di gioco su una flotta Amazon GameLift Servers Anywhere, costruisci un `ServerParameters` oggetto con le seguenti informazioni:  
+ L'URL WebSocket utilizzato per connettersi al server di gioco. 
+ L'ID del processo utilizzato per ospitare il server di gioco. 
+ L'ID del computer che ospita i processi del server di gioco. 
+ L'ID della Amazon GameLift Servers flotta contenente il tuo computer Amazon GameLift Servers Anywhere.
+ Il token di autorizzazione generato dall'Amazon GameLift Serversoperazione. 

### Valore restituito
<a name="integration-server-sdk5-cpp-initsdk-anywhere-return"></a>

Restituisce un [Inizialo SDKOutcome](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-datatypes-initsdkoutcome) oggetto che indica se il processo del server è pronto per la chiamata. [ProcessReady()](#integration-server-sdk5-cpp-processready) 

**Nota**  
Se le chiamate a non `InitSDK()` riescono per le build di gioco distribuite sulle flotte Anywhere, controlla il `ServerSdkVersion` parametro utilizzato durante la creazione della risorsa di compilazione. È necessario impostare esplicitamente questo valore sulla versione SDK del server in uso. Il valore predefinito per questo parametro è 4.x, che non è compatibile. Per risolvere questo problema, crea una nuova build e distribuiscila in una nuova flotta.

### Esempio
<a name="integration-server-sdk5-cpp-initsdk-anywhere-example"></a>

Amazon GameLift ServersEsempio: Ovunque

```
//Define the server parameters
std::string websocketUrl = "wss://us-west-1.api.amazongamelift.com";
std::string processId = "PID1234";
std::string fleetId = "arn:aws:gamelift:us-west-1:111122223333:fleet/fleet-9999ffff-88ee-77dd-66cc-5555bbbb44aa";
std::string hostId = "HardwareAnywhere";
std::string authToken = "1111aaaa-22bb-33cc-44dd-5555eeee66ff";
Aws::GameLift::Server::Model::ServerParameters serverParameters = 
  Aws::GameLift::Server::Model::ServerParameters(webSocketUrl, authToken, fleetId, hostId, processId);

//Call InitSDK to establish a local connection with the Amazon GameLift Servers Agent to enable further communication.
Aws::GameLift::Server::InitSDKOutcome initSdkOutcome = Aws::GameLift::Server::InitSDK(serverParameters);
```

## ProcessReady()
<a name="integration-server-sdk5-cpp-processready"></a>

Notifica Amazon GameLift Servers che il processo del server è pronto per ospitare sessioni di gioco. Chiama questo metodo dopo averlo [InitSDK()](#integration-server-sdk5-cpp-initsdk) invocato. Questo metodo deve essere chiamato solo una volta per processo.

### Sintassi
<a name="integration-server-sdk5-cpp-processready-syntax"></a>

`GenericOutcome ProcessReady(const Aws::GameLift::Server::ProcessParameters &processParameters);`

### Parameters
<a name="integration-server-sdk5-cpp-processready-parameter"></a>

**processParameters**  
Un oggetto [ProcessParameters](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-process) che comunica le informazioni seguenti sul processo del server:  
+ Nomi dei metodi di callback implementati nel codice del server di gioco richiamato dal Amazon GameLift Servers servizio per comunicare con il processo del server.
+ Numero di porta sulla quale è in ascolto il processo del server.
+ Percorso verso qualsiasi file specifico di una sessione di gioco che Amazon GameLift Servers deve acquisire e archiviare.

### Valore restituito
<a name="integration-server-sdk5-cpp-processready-return"></a>

Restituisce un risultato generico composto da successo o fallimento con un messaggio di errore.

### Esempio
<a name="integration-server-sdk5-cpp-processready-example"></a>

Questo esempio illustra la chiamata [ProcessReady()](#integration-server-sdk5-cpp-processready) e le implementazioni della funzione delegata.

```
// Set parameters and call ProcessReady
std::string serverLog("serverOut.log");        // Example of a log file written by the game server
std::vector<std::string> logPaths;
logPaths.push_back(serverLog);
int listenPort = 9339;

Aws::GameLift::Server::ProcessParameters processReadyParameter = 
  Aws::GameLift::Server::ProcessParameters(
    std::bind(&Server::onStartGameSession, this, std::placeholders::_1),
    std::bind(&Server::onProcessTerminate, this), 
    std::bind(&Server::OnHealthCheck, this), 
    std::bind(&Server::OnUpdateGameSession, this), 
    listenPort, 
    Aws::GameLift::Server::LogParameters(logPaths)
  ); 

Aws::GameLift::GenericOutcome outcome = 
  Aws::GameLift::Server::ProcessReady(processReadyParameter);

// Implement callback functions
void Server::onStartGameSession(Aws::GameLift::Model::GameSession myGameSession)
{
  // game-specific tasks when starting a new game session, such as loading map
  GenericOutcome outcome = 
    Aws::GameLift::Server::ActivateGameSession (maxPlayers);
}

void Server::onProcessTerminate()
{
  // game-specific tasks required to gracefully shut down a game session, 
  // such as notifying players, preserving game state data, and other cleanup
  GenericOutcome outcome = Aws::GameLift::Server::ProcessEnding();
}

bool Server::onHealthCheck()
{
  bool health;
  // complete health evaluation within 60 seconds and set health
  return health;
}
```

## ProcessReadyAsync()
<a name="integration-server-sdk5-cpp-processreadyasync"></a>

Notifica al servizio Amazon GameLift Servers che il processo del server è pronto per l'hosting delle sessioni di gioco. Questo metodo dovrebbe essere chiamato dopo che il processo del server è pronto per ospitare una sessione di gioco. I parametri specificano i nomi delle funzioni di callback Amazon GameLift Servers da chiamare in determinate circostanze. Il codice del server di gioco deve implementare queste funzioni.

Questa chiamata è asincrona. Per effettuare una chiamata sincrona, utilizza [ProcessReady()](#integration-server-sdk5-cpp-processready). Per ulteriori dettagli, consulta [Inizializza il processo del server](gamelift-sdk-server-api.md#gamelift-sdk-server-initialize).

### Sintassi
<a name="integration-server-sdk5-cpp-processreadyasync-syntax"></a>

```
GenericOutcomeCallable ProcessReadyAsync(
    const Aws::GameLift::Server::ProcessParameters &processParameters);
```

### Parameters
<a name="integration-server-sdk5-cpp-processreadyasync-parameter"></a>

**processParameters**  
Un oggetto [ProcessParameters](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-process) che comunica le informazioni seguenti sul processo del server:  
+ Nomi dei metodi di callback implementati nel codice del server di gioco richiamato dal Amazon GameLift Servers servizio per comunicare con il processo del server.
+ Numero di porta sulla quale è in ascolto il processo del server.
+ Percorso verso qualsiasi file specifico di una sessione di gioco che Amazon GameLift Servers deve acquisire e archiviare.
Obbligatorio: sì

### Valore restituito
<a name="integration-server-sdk5-cpp-processreadyasync-return"></a>

Restituisce un risultato generico composto da successo o fallimento con un messaggio di errore.

### Esempio
<a name="integration-server-sdk5-cpp-processreadyasync-example"></a>

```
// Set parameters and call ProcessReady
std::string serverLog("serverOut.log");        // This is an example of a log file written by the game server
std::vector<std::string> logPaths;
logPaths.push_back(serverLog);
int listenPort = 9339;

Aws::GameLift::Server::ProcessParameters processReadyParameter = 
  Aws::GameLift::Server::ProcessParameters(std::bind(&Server::onStartGameSession, this, std::placeholders::_1),
  std::bind(&Server::onProcessTerminate, this), std::bind(&Server::OnHealthCheck, this),
  std::bind(&Server::OnUpdateGameSession, this), listenPort, Aws::GameLift::Server::LogParameters(logPaths));

Aws::GameLift::GenericOutcomeCallable outcome = 
  Aws::GameLift::Server::ProcessReadyAsync(processReadyParameter);

// Implement callback functions
void onStartGameSession(Aws::GameLift::Model::GameSession myGameSession)
{
  // game-specific tasks when starting a new game session, such as loading map
  GenericOutcome outcome = Aws::GameLift::Server::ActivateGameSession (maxPlayers);
}

void onProcessTerminate()
{
  // game-specific tasks required to gracefully shut down a game session, 
  // such as notifying players, preserving game state data, and other cleanup
  GenericOutcome outcome = Aws::GameLift::Server::ProcessEnding();
}

bool onHealthCheck()
{
  // perform health evaluation and complete within 60 seconds
  return health;
}
```

## ProcessEnding()
<a name="integration-server-sdk5-cpp-processending"></a>

Notifica Amazon GameLift Servers che il processo del server sta terminando. Chiama questo metodo dopo tutte le altre attività di pulizia (inclusa la chiusura della sessione di gioco attiva) e prima di terminare il processo. A seconda del risultato di`ProcessEnding()`, il processo termina con successo (0) o errore (-1) e genera un evento relativo alla flotta. Se il processo termina con un errore, l'evento fleet generato è. `SERVER_PROCESS_TERMINATED_UNHEALTHY`

### Sintassi
<a name="integration-server-sdk5-cpp-processending-syntax"></a>

```
Aws::GameLift::GenericOutcome processEndingOutcome = Aws::GameLift::Server::ProcessEnding();
```

### Valore restituito
<a name="integration-server-sdk5-cpp-processending-return"></a>

Restituisce un risultato generico costituito da successo o fallimento con un messaggio di errore.

### Esempio
<a name="integration-server-sdk5-cpp-processending-example"></a>

Questo esempio chiama `ProcessEnding()` e `Destroy()` prima di terminare il processo del server con un codice di uscita riuscito o di errore.

```
Aws::GameLift::GenericOutcome processEndingOutcome = Aws::GameLift::Server::ProcessEnding();
Aws::GameLift::Server::Destroy();

// Exit the process with success or failure
if (processEndingOutcome.IsSuccess()) {
  exit(0);
}
else {
  cout << "ProcessEnding() failed. Error: " << processEndingOutcome.GetError().GetErrorMessage();
  exit(-1);
}
```

## ActivateGameSession()
<a name="integration-server-sdk5-cpp-activategamesession"></a>

Notifica Amazon GameLift Servers che il processo del server ha attivato una sessione di gioco ed è ora pronto a ricevere le connessioni dei giocatori. Questa azione dovrebbe essere richiamata come parte della funzione di `onStartGameSession()` callback, dopo l'inizializzazione di tutta la sessione di gioco.

### Sintassi
<a name="integration-server-sdk5-cpp-activategamesession-syntax"></a>

```
Aws::GameLift::GenericOutcome activateGameSessionOutcome = Aws::GameLift::Server::ActivateGameSession();
```

### Valore restituito
<a name="integration-server-sdk5-cpp-activategamesession-return"></a>

Restituisce un risultato generico composto da successo o fallimento con un messaggio di errore.

### Esempio
<a name="integration-server-sdk5-cpp-activategamesession-example"></a>

Questo esempio mostra le `ActivateGameSession()` chiamate come parte della funzione `onStartGameSession()` delegata. 

```
void onStartGameSession(Aws::GameLift::Model::GameSession myGameSession)
{
  // game-specific tasks when starting a new game session, such as loading map
  GenericOutcome outcome = Aws::GameLift::Server::ActivateGameSession();
}
```

## UpdatePlayerSessionCreationPolicy()
<a name="integration-server-sdk5-cpp-updateplayersessioncreationpolicy"></a>

Aggiorna la capacità della sessione di gioco corrente di accettare nuove sessioni giocatore. Una sessione di gioco può essere configurata per accettare o rifiutare tutte le nuove sessioni giocatore.

### Sintassi
<a name="integration-server-sdk5-cpp-updateplayersessioncreationpolicy-syntax"></a>

```
GenericOutcome UpdatePlayerSessionCreationPolicy(Aws::GameLift::Model::PlayerSessionCreationPolicy newPlayerSessionPolicy);
```

### Parameters
<a name="integration-server-sdk5-cpp-updateplayersessioncreationpolicy-parameter"></a>

**playerCreationSessionPolitica**  
Tipo: valore `PlayerSessionCreationPolicy` [enum](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-enums).  
Obbligatorio: sì

### Valore restituito
<a name="integration-server-sdk5-cpp-updateplayersessioncreationpolicy-return"></a>

Restituisce un risultato generico costituito da successo o fallimento con un messaggio di errore.

### Esempio
<a name="integration-server-sdk5-cpp-updateplayersessioncreationpolicy-example"></a>

Questo esempio definisce la policy di partecipazione alla sessione di gioco corrente per accettare tutti i giocatori.

```
Aws::GameLift::GenericOutcome outcome = 
  Aws::GameLift::Server::UpdatePlayerSessionCreationPolicy(Aws::GameLift::Model::PlayerSessionCreationPolicy::ACCEPT_ALL);
```

## GetGameSessionId()
<a name="integration-server-sdk5-cpp-getgamesessionid"></a>

Recupera l'ID della sessione di gioco ospitata dal processo del server attivo. 

Per i processi inattivi che non vengono attivati con una sessione di gioco, la chiamata restituisce un. [GameLiftError](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-datatypes-gamelifterror)

### Sintassi
<a name="integration-server-sdk5-cpp-getgamesessionid-syntax"></a>

```
AwsStringOutcome GetGameSessionId()
```

### Parameters
<a name="integration-server-sdk5-cpp-getgamesessionid-parameter"></a>

Questa operazione non prevede parametri.

### Valore restituito
<a name="integration-server-sdk5-cpp-getgamesessionid-return"></a>

Se l'esito è positivo, l'ID della sessione di gioco verrà restituito come oggetto [AwsStringOutcome](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-datatypes-awsstringoutcome). Se l'esito è negativo, verrà restituito un messaggio di errore.

Per i processi inattivi che non vengono attivati con una sessione di gioco, la chiamata restituisce `Success` = `True` e `GameSessionId` =. `""`

### Esempio
<a name="integration-server-sdk5-cpp-getgamesessionid-example"></a>

```
Aws::GameLift::AwsStringOutcome sessionIdOutcome = Aws::GameLift::Server::GetGameSessionId();
```

## GetTerminationTime()
<a name="integration-server-sdk5-cpp-getterm"></a>

Restituisce il tempo di arresto pianificato di un processo del server, se è disponibile un tempo di chiusura. Un processo server interviene dopo aver ricevuto una `onProcessTerminate()` richiamata da. Amazon GameLift Servers Amazon GameLift Serverschiama `onProcessTerminate()` per i seguenti motivi: 
+ Quando il processo del server ha segnalato problemi di salute o non ha risposto. Amazon GameLift Servers
+ Quando si termina l'istanza durante un evento di scale-down.
+ [Quando un'istanza viene terminata a causa di un'interruzione di un'istanza spot.](spot-tasks.md)

### Sintassi
<a name="integration-server-sdk5-cpp-getterm-syntax"></a>

```
AwsDateTimeOutcome GetTerminationTime()
```

### Valore restituito
<a name="integration-server-sdk5-cpp-getterm-return"></a>

In caso di successo, restituisce l'ora di terminazione come oggetto. `AwsDateTimeOutcome` Il valore è il tempo di terminazione, espresso in segni di spunta trascorsi da allora. `0001 00:00:00` Ad esempio, il valore della data e dell'ora è uguale ai segni di `2020-09-13 12:26:40 -000Z` spunta. `637355968000000000` Se non è disponibile alcun orario di terminazione, restituisce un messaggio di errore.

Se il processo non ha ricevuto un ProcessParameters. OnProcessTerminate() callback, viene restituito un messaggio di errore. Per ulteriori informazioni sulla chiusura di un processo server, vedere. [Rispondi a una notifica di chiusura del processo del server](gamelift-sdk-server-api.md#gamelift-sdk-server-terminate)

### Esempio
<a name="integration-server-sdk5-cpp-getterm-example"></a>

```
Aws::GameLift::AwsLongOutcome TermTimeOutcome = Aws::GameLift::Server::GetTerminationTime(); 
```

## AcceptPlayerSession()
<a name="integration-server-sdk5-cpp-acceptplayersession"></a>

Notifica Amazon GameLift Servers che un giocatore con l'ID di sessione specificato si è connesso al processo del server e deve essere convalidato. Amazon GameLift Serversverifica che l'ID della sessione del giocatore sia valido. Dopo la convalida della sessione di gioco, Amazon GameLift Servers modifica lo stato dello slot del giocatore da RISERVATO ad ATTIVO. 

### Sintassi
<a name="integration-server-sdk5-cpp-acceptplayersession-syntax"></a>

```
GenericOutcome AcceptPlayerSession(String playerSessionId)
```

### Parameters
<a name="integration-server-sdk5-cpp-acceptplayersession-parameter"></a>

playerSessionId  
ID univoco rilasciato Amazon GameLift Servers quando viene creata una nuova sessione giocatore.

### Valore restituito
<a name="integration-server-sdk5-cpp-acceptplayersession-return"></a>

Restituisce un risultato generico composto da successo o fallimento con un messaggio di errore. 

### Esempio
<a name="integration-server-sdk5-cpp-acceptplayersession-example"></a>

Questo esempio gestisce una richiesta di connessione che include la convalida e il rifiuto di una sessione giocatore non valida. IDs

```
void ReceiveConnectingPlayerSessionID (Connection& connection, const std::string& playerSessionId)
{
  Aws::GameLift::GenericOutcome connectOutcome = Aws::GameLift::Server::AcceptPlayerSession(playerSessionId);
  if(connectOutcome.IsSuccess())
  {
    connectionToSessionMap.emplace(connection, playerSessionId);
    connection.Accept();
  }
  else 
  {
    connection.Reject(connectOutcome.GetError().GetMessage();
  }       
}
```

## RemovePlayerSession()
<a name="integration-server-sdk5-cpp-removeplayersession"></a>

Notifica Amazon GameLift Servers che un giocatore si è disconnesso dal processo del server. In risposta, Amazon GameLift Servers modifica lo slot del giocatore rendendolo disponibile. 

### Sintassi
<a name="integration-server-sdk5-cpp-removeplayersession-syntax"></a>

```
GenericOutcome RemovePlayerSession(String playerSessionId)
```

### Parameters
<a name="integration-server-sdk5-cpp-removeplayersession-parameter"></a>

**`playerSessionId`**  
ID univoco rilasciato Amazon GameLift Servers quando viene creata una nuova sessione di gioco.

### Valore restituito
<a name="integration-server-sdk5-cpp-removeplayersession-return"></a>

Restituisce un risultato generico composto da successo o fallimento con un messaggio di errore.

### Esempio
<a name="integration-server-sdk5-cpp-removeplayersession-example"></a>

```
Aws::GameLift::GenericOutcome disconnectOutcome = Aws::GameLift::Server::RemovePlayerSession(playerSessionId);
```

## DescribePlayerSessions()
<a name="integration-server-sdk5-cpp-describeplayersessions"></a>

Recupera i dati della sessione del giocatore che includono impostazioni, metadati della sessione e dati del giocatore. Utilizzate questo metodo per ottenere informazioni su quanto segue:
+ Una sessione per giocatore singolo
+ Tutte le sessioni dei giocatori in una sessione di gioco
+ Tutte le sessioni dei giocatori sono associate a un ID giocatore singolo

### Sintassi
<a name="integration-server-sdk5-cpp-describeplayersessions-syntax"></a>

```
DescribePlayerSessionsOutcome DescribePlayerSessions(DescribePlayerSessionsRequest describePlayerSessionsRequest)
```

### Parameters
<a name="integration-server-sdk5-cpp-describeplayersessions-parameter"></a>

**[DescribePlayerSessionsRequest](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-playersessions)**  
Un [DescribePlayerSessionsRequest](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-playersessions) oggetto che descrive le sessioni dei giocatori da recuperare.

### Valore restituito
<a name="integration-server-sdk5-cpp-describeplayersessions-return"></a>

Se l'esito è positivo, restituisce un oggetto [DescribePlayerSessionsOutcome](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-datatypes-describeplayersessionsoutcome) contenente un set di oggetti di sessione giocatore corrispondente ai parametri della richiesta.

### Esempio
<a name="integration-server-sdk5-cpp-describeplayersessions-example"></a>

Questo esempio richiede che tutte le sessioni dei giocatori siano connesse attivamente a una sessione di gioco specificata. Omettendo *NextToken*e impostando il valore *Limite* su 10, Amazon GameLift Servers restituisce i primi 10 record di sessione tra giocatori corrispondenti alla richiesta.

```
// Set request parameters
Aws::GameLift::Server::Model::DescribePlayerSessionsRequest request;
request.SetPlayerSessionStatusFilter(Aws::GameLift::Server::Model::PlayerSessionStatusMapper::GetNameForPlayerSessionStatus(Aws::GameLift::Server::Model::PlayerSessionStatus::Active));
request.SetLimit(10);
request.SetGameSessionId("the game session ID");    // can use GetGameSessionId()

// Call DescribePlayerSessions
Aws::GameLift::DescribePlayerSessionsOutcome playerSessionsOutcome = Aws::GameLift::Server::DescribePlayerSessions(request);
```

## StartMatchBackfill()
<a name="integration-server-sdk5-cpp-startmatchbackfill"></a>

Invia una richiesta per trovare nuovi giocatori per gli slot aperti in una sessione di gioco creata con FlexMatch. Per ulteriori informazioni, consulta la funzione di [FlexMatchriempimento](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-backfill.html).

Questa operazione è asincrona. Se vengono abbinati nuovi giocatori, Amazon GameLift Servers fornisce dati aggiornati sul matchmaker utilizzando la funzione di callback. `OnUpdateGameSession()`

Un processo del server può avere un solo backfill degli abbinamenti attivo alla volta. Per inviare una nuova richiesta, chiama prima [StopMatchBackfill()](#integration-server-sdk5-cpp-stopmatchbackfill) per annullare la richiesta originale.

### Sintassi
<a name="integration-server-sdk5-cpp-startmatchbackfill-syntax"></a>

```
StartMatchBackfillOutcome StartMatchBackfill (StartMatchBackfillRequest startBackfillRequest);
```

### Parameters
<a name="integration-server-sdk5-cpp-startmatchbackfill-parameter"></a>

**[StartMatchBackfillRequest](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-startmatchbackfillrequest)**  
Un StartMatchBackfillRequest oggetto che comunica le seguenti informazioni:  
+ ID del ticket da assegnare alla richiesta di backfill. Queste informazioni sono facoltative; se non viene fornito alcun ID, ne Amazon GameLift Servers genererà uno.
+ Matchmaker a cui inviare la richiesta. L'ARN di configurazione completo è obbligatorio. Questo valore si trova nei dati del matchmaker della sessione di gioco.
+ L'ID della sessione di gioco da riempire.
+ I dati di matchmaking disponibili per i giocatori attuali della sessione di gioco.

### Valore restituito
<a name="integration-server-sdk5-cpp-startmatchbackfill-return"></a>

Restituisce un [StartMatchBackfillOutcome](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-datatypes-startmatchbackfilloutcome) oggetto con l'ID del ticket match backfill, oppure restituisce un errore con un messaggio di errore. 

### Esempio
<a name="integration-server-sdk5-cpp-startmatchbackfill-example"></a>

```
// Build a backfill request
std::vector<Player> players;
Aws::GameLift::Server::Model::StartMatchBackfillRequest startBackfillRequest;
startBackfillRequest.SetTicketId("1111aaaa-22bb-33cc-44dd-5555eeee66ff");  // optional, autogenerated if not provided
startBackfillRequest.SetMatchmakingConfigurationArn("arn:aws:gamelift:us-west-2:111122223333:matchmakingconfiguration/MyMatchmakerConfig"); //from the game session matchmaker data
startBackfillRequest.SetGameSessionArn("the game session ARN");        // can use GetGameSessionId()
startBackfillRequest.SetPlayers(players);                                  // from the game session matchmaker data

// Send backfill request
Aws::GameLift::StartMatchBackfillOutcome backfillOutcome = 
  Aws::GameLift::Server::StartMatchBackfill(startBackfillRequest);

// Implement callback function for backfill
void Server::OnUpdateGameSession(Aws::GameLift::Server::Model::GameSession gameSession, Aws::GameLift::Server::Model::UpdateReason updateReason, std::string backfillTicketId)
{
  // handle status messages
  // perform game-specific tasks to prep for newly matched players
}
```

## StopMatchBackfill()
<a name="integration-server-sdk5-cpp-stopmatchbackfill"></a>

Annulla una richiesta di match backfill attiva. Per ulteriori informazioni, consulta la funzione di [FlexMatchriempimento](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-backfill.html).

### Sintassi
<a name="integration-server-sdk5-cpp-stopmatchbackfill-syntax"></a>

```
GenericOutcome StopMatchBackfill (StopMatchBackfillRequest stopBackfillRequest);
```

### Parameters
<a name="integration-server-sdk5-cpp-stopmatchbackfill-parameter"></a>

**[StopMatchBackfillRequest](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-stopmatchbackfillrequest)**  
Un StopMatchBackfillRequest oggetto che identifica il ticket di matchmaking da annullare:   
+ L'ID del ticket assegnato alla richiesta di riempimento.
+ Il matchmaker a cui è stata inviata la richiesta di riempimento.
+ La sessione di gioco associata alla richiesta di riempimento.

### Valore restituito
<a name="integration-server-sdk5-cpp-stopmatchbackfill-return"></a>

Restituisce un risultato generico composto da successo o fallimento con un messaggio di errore.

### Esempio
<a name="integration-server-sdk5-cpp-stopmatchbackfill-example"></a>

```
// Set backfill stop request parameters

Aws::GameLift::Server::Model::StopMatchBackfillRequest stopBackfillRequest;
stopBackfillRequest.SetTicketId("1111aaaa-22bb-33cc-44dd-5555eeee66ff");
stopBackfillRequest.SetGameSessionArn("the game session ARN"); // can use GetGameSessionId()
stopBackfillRequest.SetMatchmakingConfigurationArn("arn:aws:gamelift:us-west-2:111122223333:matchmakingconfiguration/MyMatchmakerConfig");
// from the game session matchmaker data

Aws::GameLift::GenericOutcome stopBackfillOutcome = 
  Aws::GameLift::Server::StopMatchBackfill(stopBackfillRequest);
```

## GetComputeCertificate()
<a name="integration-server-sdk5-cpp-getcomputecertificate"></a>

Recupera il percorso del certificato TLS utilizzato per crittografare la connessione di rete tra la risorsa di elaborazione Amazon GameLift Servers Anywhere e. Amazon GameLift Servers Puoi utilizzare il percorso del certificato quando registri il tuo dispositivo di elaborazione in una flotta Anywhere. Amazon GameLift Servers Per ulteriori informazioni, consultare [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).

### Sintassi
<a name="integration-server-sdk5-cpp-getcomputecertificate-syntax"></a>

```
GetComputeCertificateOutcome Server::GetComputeCertificate()
```

### Valore restituito
<a name="integration-server-sdk5-cpp-getcomputecertificate-return"></a>

Restituisce una [GetComputeCertificateOutcome](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-datatypes-getcomputecertificateoutcome).

### Esempio
<a name="integration-server-sdk5-cpp-getcomputecertificate-example"></a>

```
Aws::GameLift::GetComputeCertificateOutcome certificate = Aws::GameLift::Server::GetComputeCertificate();
```

## GetFleetRoleCredentials()
<a name="integration-server-sdk5-cpp-getfleetrolecredentials"></a>

Recupera le credenziali del ruolo IAM che autorizzano Amazon GameLift Servers a interagire con altri. Servizi AWS Per ulteriori informazioni, consulta [Connect il server di gioco Amazon GameLift Servers ospitato ad altre AWS risorse](gamelift-sdk-server-resources.md).

### Sintassi
<a name="integration-server-sdk5-cpp-getfleetrolecredentials-syntax"></a>

```
GetFleetRoleCredentialsOutcome GetFleetRoleCredentials(GetFleetRoleCredentialsRequest request);
```

### Parameters
<a name="integration-server-sdk5-cpp-getfleetrolecredentials-parameters"></a>

[GetFleetRoleCredentialsRequest](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-getfleetrolecredentialsrequest)

### Valore restituito
<a name="integration-server-sdk5-cpp-getfleetrolecredentials-return"></a>

Restituisce un oggetto [GetFleetRoleCredentialsOutcome](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-datatypes-getfleetrolecredentialsoutcome).

### Esempio
<a name="integration-server-sdk5-cpp-getfleetrolecredentials-example"></a>

```
// form the fleet credentials request 
Aws::GameLift::Server::Model::GetFleetRoleCredentialsRequest getFleetRoleCredentialsRequest; 
getFleetRoleCredentialsRequest.SetRoleArn("arn:aws:iam::123456789012:role/service-role/exampleGameLiftAction");

Aws::GameLift::GetFleetRoleCredentialsOutcome credentials = Aws::GameLift::Server::GetFleetRoleCredentials(getFleetRoleCredentialsRequest);
```

Questo esempio mostra l'uso del `RoleSessionName` valore opzionale per assegnare un nome alla sessione di credenziali a fini di controllo. Se non si fornisce un nome per la sessione di ruolo, viene utilizzato il valore predefinito *[host-id]* "*[fleet-id]*-».

```
// form the fleet credentials request 
Aws::GameLift::Server::Model::GetFleetRoleCredentialsRequest getFleetRoleCredentialsRequest; 
getFleetRoleCredentialsRequest.SetRoleArn("arn:aws:iam::123456789012:role/service-role/exampleGameLiftAction");
getFleetRoleCredentialsRequest.SetRoleSessionName("MyFleetRoleSession"); 

Aws::GameLift::GetFleetRoleCredentialsOutcome credentials = Aws::GameLift::Server::GetFleetRoleCredentials(getFleetRoleCredentialsRequest);
```

## Distruggi ()
<a name="integration-server-sdk5-cpp-ref-destroy"></a>

Libera l'SDK del server di Amazon GameLift Servers gioco dalla memoria. È consigliabile chiamare questo metodo dopo `ProcessEnding()` e prima di terminare il processo. Se utilizzi una flotta Anywhere e non interrompi i processi del server dopo ogni sessione di gioco, chiama `Destroy()` e poi `InitSDK()` reinizializza prima di notificare Amazon GameLift Servers che il processo è pronto per ospitare una sessione di gioco. `ProcessReady()`

### Sintassi
<a name="integration-server-sdk5-cpp-ref-destroy-syntax"></a>

```
GenericOutcome Aws::GameLift::Server::Destroy();
```

### Parameters
<a name="integration-server-sdk5-cpp-ref-destroy-parameter"></a>

Non ci sono parametri.

### Valore restituito
<a name="integration-server-sdk5-cpp-ref-destroy-return"></a>

Restituisce un risultato generico costituito da successo o fallimento con un messaggio di errore.

### Esempio
<a name="integration-server-sdk5-cpp-ref-destroy-example"></a>

```
Aws::GameLift::GenericOutcome processEndingOutcome = Aws::GameLift::Server::ProcessEnding();
Aws::GameLift::Server::Destroy();

// Exit the process with success or failure
if (processEndingOutcome.IsSuccess()) {
  exit(0);
}
else {
  cout << "ProcessEnding() failed. Error: " << processEndingOutcome.GetError().GetErrorMessage();
  exit(-1);
}
```