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à.

# Go server SDK perAmazon GameLift Servers: tipi di dati
<a name="integration-server-sdk-go-datatypes"></a>

Usa il riferimento all'SDK 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).

`GameLiftServerAPI.go`definisce le azioni dell'SDK del server Go.

[Go server SDK per Amazon GameLift Servers -- Azioni](integration-server-sdk-go-actions.md)

**Topics**
+ [LogParameters](#integration-server-sdk-go-dataypes-log)
+ [MetricsParameters](#integration-server-sdk-go-dataypes-metrics)
+ [ProcessParameters](#integration-server-sdk-go-dataypes-process)
+ [UpdateGameSession](#integration-server-sdk-go-dataypes-updategamesession)
+ [GameSession](#integration-server-sdk-go-dataypes-gamesession)
+ [ServerParameters](#integration-server-sdk-go-dataypes-serverparameters)
+ [StartMatchBackfillRequest](#integration-server-sdk-go-dataypes-startmatchbackfillrequest)
+ [Player](#integration-server-sdk-go-dataypes-player)
+ [DescribePlayerSessionsRequest](#integration-server-sdk-go-dataypes-playersessions)
+ [StopMatchBackfillRequest](#integration-server-sdk-go-dataypes-stopmatchbackfillrequest)
+ [GetFleetRoleCredentialsRequest](#integration-server-sdk-go-dataypes-getfleetrolecredentialsrequest)

## LogParameters
<a name="integration-server-sdk-go-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-sdk-go-actions.md#integration-server-sdk-go-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. <br />I percorsi di registro devono essere assoluti. Ad esempio, se la build del gioco memorizza i log delle sessioni di gioco in un percorso come`MyGame\sessionLogs\`, il percorso si troverebbe `c:\game\MyGame\sessionLogs` su un'istanza di Windows.<br />**Tipo:** `[]string`<br />**Obbligatorio:** no | 

## MetricsParameters
<a name="integration-server-sdk-go-dataypes-metrics"></a>

Un oggetto che comunica i parametri di configurazione per l'inizializzazione del sistema di metriche. Questa configurazione viene utilizzata per impostare la segnalazione StatSD, la segnalazione di arresti anomali e il comportamento di elaborazione delle metriche. Il server di gioco fornisce `MetricsParameters` to Amazon GameLift Servers come parte di una [InitMetrics()](integration-server-sdk-go-actions.md#integration-server-sdk-go-initmetrics) chiamata.


|  |  | 
| --- |--- |
| **Proprietà** | Descrizione | 
| StatsdHost | L'host del server StatSD per la segnalazione delle metriche (ad esempio, «localhost»).<br />**Tipo:** `string`<br />**Obbligatorio:** sì | 
| StatsdPort | La porta del server StatSD per la segnalazione delle metriche (ad esempio, 8125).<br />**Tipo:** `int`<br />**Obbligatorio:** sì | 
| CrashReporterHost | L'host crash reporter per il tracciamento degli arresti anomali e il monitoraggio dei processi.<br />**Tipo:** `string`<br />**Obbligatorio:** sì | 
| CrashReporterPort | La porta crash reporter per il tracciamento degli incidenti e il monitoraggio dei processi.<br />**Tipo:** `int`<br />**Obbligatorio:** sì | 
| FlushIntervalMs | L'intervallo di flush delle metriche in millisecondi. Controlla la frequenza con cui le metriche vengono inviate a StatSD.<br />**Tipo:** `int`<br />**Obbligatorio:** sì | 
| MaxPacketSize | La dimensione massima del pacchetto per le metriche in byte. Limita la dimensione dei pacchetti UDP inviati a StatSD.<br />**Tipo:** `int`<br />**Obbligatorio:** sì | 

## ProcessParameters
<a name="integration-server-sdk-go-dataypes-process"></a>

Un oggetto che descrive la comunicazione tra un processo server e. Amazon GameLift Servers Il processo server fornisce queste informazioni a Amazon GameLift Servers con una chiamata a[ProcessReady()](integration-server-sdk-go-actions.md#integration-server-sdk-go-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:** `LogParameters`<br />**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:** `OnHealthCheck func() bool`<br />**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-sdk-go-actions.md#integration-server-sdk-go-processending) chiamata prima di chiudere il processo server.**Tipo:** `OnProcessTerminate func()`<br />**Obbligatorio:** sì | 
| OnStartGameSession | La funzione di callback che Amazon GameLift Servers richiama il passaggio di 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-sdk-go-dataypes-gamesession) oggetto, uno status update (updateReason) e l'ID del ticket match backfill.**Tipo:** `OnStartGameSession func (model.GameSession )`<br />**Obbligatorio:** sì | 
| OnUpdateGameSession | La funzione di callback che Amazon GameLift Servers richiama per passare informazioni aggiornate sulla sessione di gioco al processo del server. Amazon GameLift Serverschiama questa funzione dopo aver elaborato una richiesta di match backfill per fornire dati aggiornati sul matchmaker. **Tipo:** `OnUpdateGameSession func (model.UpdateGameSession)`<br />**Obbligatorio:** no | 
| Port | Il numero di porta su cui il processo del 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:** `int`<br />**Obbligatorio:** sì | 

## UpdateGameSession
<a name="integration-server-sdk-go-dataypes-updategamesession"></a>

Gli aggiornamenti 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-sdk-go-dataypes-gamesession). L'GameSessionoggetto contiene proprietà che descrivono una sessione di gioco. **Tipo:** `GameSession GameSession()`<br />**Obbligatorio:** sì | 
| UpdateReason | Il motivo per cui la sessione di gioco viene aggiornata.**Tipo:** `UpdateReason UpdateReason()`<br />**Obbligatorio:** sì | 
| BackfillTicketId | L'ID del ticket di backfill che tenta di aggiornare la sessione di gioco.**Tipo:** `String`<br />**Obbligatorio:** no | 

## GameSession
<a name="integration-server-sdk-go-dataypes-gamesession"></a>

I dettagli di una sessione di gioco. 


| Properties | **Descrizione** | 
| --- | --- | 
| GameSessionId | Un identificatore univoco per la sessione di gioco. Una sessione di gioco Amazon Resource Name (ARN) ha il seguente formato:. `arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>`<br />**Tipo:** `String`<br />**Obbligatorio:** no | 
| Name | Un'etichetta descrittiva della sessione di gioco. <br />**Tipo:** `String`<br />**Obbligatorio:** no | 
| FleetId | Un identificatore univoco per la flotta su cui è in esecuzione la sessione di gioco.<br />**Tipo:** `String`<br />**Obbligatorio:** no | 
| MaximumPlayerSessionCount | Il numero massimo di connessioni dei giocatori alla sessione di gioco.<br />**Tipo:** `Integer`<br />**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.<br />**Tipo:** `Integer`<br />**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.<br />**Tipo:** `String`<br />**Obbligatorio:** no | 
| GameSessionData | Un set di proprietà personalizzate della sessione di gioco, formattate come valore di stringa singola. <br />**Tipo:** `String`<br />**Obbligatorio:** no | 
| MatchmakerData | Le informazioni sul processo di matchmaking utilizzato per creare la sessione di gioco, in sintassi JSON, sono 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.<br />**Tipo:** `String`<br />**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.<br />**Tipo:** `map[string] string`<br />**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-sdk-go-datatypes.html)<br />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.<br />**Tipo:** `String`<br />**Obbligatorio:** no | 

## ServerParameters
<a name="integration-server-sdk-go-dataypes-serverparameters"></a>

Informazioni utilizzate per mantenere la connessione tra un server Amazon GameLift Servers Anywhere e il servizio. Amazon GameLift Servers Queste informazioni vengono utilizzate quando si avviano nuovi processi server con[InitSDK()](integration-server-sdk-go-actions.md#integration-server-sdk-go-initsdk). Per i server ospitati su istanze EC2 Amazon GameLift Servers gestite, utilizza un oggetto vuoto.


| Properties | **Descrizione** | 
| --- | --- | 
| WebSocketURL | `GameLiftServerSdkEndpoint`Amazon GameLift ServersRestituisce quando si utilizza una [https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html)risorsa di calcolo Amazon GameLift Servers Anywhere.<br />**Tipo:** `string`<br />**Obbligatorio:** sì | 
| ProcessID | Un identificatore univoco registrato nel processo del server che ospita il gioco.<br />**Tipo:** `string`<br />**Obbligatorio:** sì | 
| HostID | L'identificatore univoco della risorsa di elaborazione che ospita il nuovo processo del server. <br />`HostID`Viene `ComputeName` utilizzato al momento della registrazione del computer. Per ulteriori informazioni, consulta [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).<br />**Tipo:** `string`<br />**Obbligatorio:** sì | 
| FleetID | L'identificatore univoco della flotta su cui è registrato il calcolo. Per ulteriori informazioni, consulta [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).**Tipo:** `string`<br />**Obbligatorio:** sì | 
| AuthToken | Il token di autenticazione generato da Amazon GameLift Servers questo codice autentica il server. Amazon GameLift Servers Per ulteriori informazioni, consulta [GetComputeAuthToken](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_GetComputeAuthToken.html).**Tipo:** `string`<br />**Obbligatorio:** sì | 

## StartMatchBackfillRequest
<a name="integration-server-sdk-go-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-sdk-go-actions.md#integration-server-sdk-go-startmatchbackfill)


| Properties | **Descrizione** | 
| --- | --- | 
| GameSessionArn | L'identificatore univoco della sessione di gioco. L'operazione API `[GetGameSessionId](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-server-sdk-go-actions.html#integration-server-sdk-go-getgamesessionid)` restituisce l'identificatore in formato ARN.<br />**Tipo:** `String`<br />**Obbligatorio:** sì | 
| MatchmakingConfigurationArn | L'identificatore univoco (sotto forma di ARN) che il matchmaker deve 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. Per ulteriori informazioni sui dati del matchmaker, vedi [Lavora](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-server.html#match-server-data.html) con i dati del matchmaker.<br />**Tipo:** `String`<br />**Obbligatorio:** sì | 
| Players | Un insieme di dati che rappresenta tutti i giocatori che sono attualmente impegnati nella sessione di gioco. Il matchmaker utilizza queste informazioni per cercare nuovi giocatori che rappresentano un buon abbinamento per i giocatori attuali.<br />**Tipo:** `[]model.Player`<br />**Obbligatorio:** sì | 
| TicketId | L'identificatore univoco di 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. <br />**Tipo:** `String`<br />**Obbligatorio:** no | 

## Player
<a name="integration-server-sdk-go-dataypes-player"></a>

L'oggetto che rappresenta un giocatore in matchmaking. Quando inizia una richiesta di matchmaking, un giocatore ha un ID giocatore, attributi e possibilmente dati sulla 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. <br />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.<br />**Tipo:** `map[string] int`<br />**Obbligatorio:** no | 
| PlayerAttributes | Una raccolta di coppie chiave:valore che contengono 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.<br />Per ulteriori informazioni sugli attributi dei giocatori, vedi [AttributeValue](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_AttributeValue.html).<br />**Tipo:** `map[string] AttributeValue`<br />**Obbligatorio:** no | 
| PlayerId | Un identificatore univoco per un giocatore.<br />**Tipo:** `String`<br />**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.<br />**Tipo:** `String`<br />**Obbligatorio:** no | 

## DescribePlayerSessionsRequest
<a name="integration-server-sdk-go-dataypes-playersessions"></a>

Un oggetto che specifica le sessioni dei giocatori da recuperare. Il processo server fornisce queste informazioni con una [DescribePlayerSessions()](integration-server-sdk-go-actions.md#integration-server-sdk-go-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. <br />Il formato dell'ID della sessione di gioco è`arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>`. `GameSessionID`È una stringa ID personalizzata o una stringa generata. <br />**Tipo:** `String`<br />**Obbligatorio:** no | 
| PlayerSessionID | L'identificatore univoco per la sessione di un giocatore. Usa questo parametro per richiedere una singola sessione di gioco specifica.<br />**Tipo:** `String`<br />**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).<br />**Tipo:** `String`<br />**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-sdk-go-datatypes.html)<br />**Tipo:** `String`<br />**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.<br />**Tipo:** `String`<br />**Obbligatorio:** no | 
| Limit | Numero massimo di risultati da restituire. Se fornisci un ID di sessione del giocatore, questo parametro viene ignorato.<br />**Tipo:** `int`<br />**Obbligatorio:** no | 

## StopMatchBackfillRequest
<a name="integration-server-sdk-go-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-sdk-go-actions.md#integration-server-sdk-go-stopmatchbackfill)


| Properties | **Descrizione** | 
| --- | --- | 
| GameSessionArn | L'identificatore univoco della sessione di gioco della richiesta che viene annullata.<br />**Tipo:** `string`<br />**Obbligatorio:** no | 
| MatchmakingConfigurationArn | L'identificatore univoco del matchmaker a cui è stata inviata questa richiesta.<br />**Tipo:** `string`<br />**Obbligatorio:** no | 
| TicketId | L'identificatore univoco del ticket di richiesta di riempimento da annullare.<br />**Tipo:** `string`<br />**Obbligatorio:** no | 

## GetFleetRoleCredentialsRequest
<a name="integration-server-sdk-go-dataypes-getfleetrolecredentialsrequest"></a>

Le credenziali del ruolo che estendono l'accesso limitato alle tue AWS risorse al server di gioco. Per ulteriori informazioni, consultare [Configurare un ruolo di servizio IAM per Amazon GameLift Servers](setting-up-role.md).


| Properties | **Descrizione** | 
| --- | --- | 
| RoleArn | L'ARN del ruolo di servizio che estende l'accesso limitato alle AWS risorse.**Tipo:** `string`<br />**Obbligatorio:** sì | 
| RoleSessionName | Il nome della sessione che descrive l'uso delle credenziali del ruolo.**Tipo:** `string`<br />**Obbligatorio:** sì |