

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

# Integra Amazon GameLift Servers FleetIQ in un server di gioco
<a name="gsg-integrate-gameserver"></a>

Questo argomento descrive le attività necessarie per preparare il progetto del server di gioco con cui comunicare Amazon GameLift Servers FleetIQ. [Amazon GameLift ServersFleetIQmigliori pratiche](gsg-best-practices.md)Per ulteriori indicazioni, fare riferimento a.



# Registra i server di gioco
<a name="gsg-integrate-gameserver-register"></a>

Quando un processo del server di gioco viene avviato ed è pronto per ospitare il gameplay dal vivo, deve registrarsi presso Amazon GameLift Servers FleetIQ chiamando [RegisterGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_RegisterGameServer.html). La registrazione consente Amazon GameLift Servers FleetIQ per rispondere ai sistemi di matchmaking o ad altri servizi client quando richiedono informazioni sulla capacità del server o richiedono un server di gioco. Al momento della registrazione, il server di gioco può fornire Amazon GameLift Servers FleetIQ con i dati pertinenti al server di gioco e le informazioni sulla connessione, inclusi la porta e l'indirizzo IP utilizzati per le connessioni client in entrata.

```
AWS gamelift register-game-server \
    --game-server-id UniqueId-1234 \
    --game-server-group-name MyLiveGroup \
    --instance-id i-1234567890 \
    --connection-info "1.2.3.4:123" \
    --game-server-data "{\"key\": \"value\"}"
```

# Aggiorna lo stato del server di gioco
<a name="gsg-integrate-gameserver-update"></a>

Una volta registrato, un server di gioco dovrebbe segnalare regolarmente lo stato di salute e di utilizzo per mantenere sincronizzato lo stato della capacità del server Amazon GameLift Servers FleetIQ. Segnala lo stato di salute e di utilizzo chiamando [UpdateGameServer().](https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameServer.html) Nell'esempio seguente, il server di gioco segnala che è in buono stato e non è attualmente occupato ad ospitare giocatori o a giocare.

```
AWS gamelift update-game-server \
    --game-server-group-name MyLiveGroup \
    --game-server-id UniqueId-1234 \
    --health-check HEALTHY \
    --utilization-status AVAILABLE
```

**Health status (Stato di integrità)**

Se il tuo server di gioco dispone di un meccanismo per monitorare lo stato di salute, puoi utilizzare questo meccanismo per attivare un aggiornamento sullo stato di salute del server di gioco su Amazon GameLift Servers FleetIQ. 

**Stato di utilizzo**

La segnalazione dello stato di utilizzo del server di gioco continua Amazon GameLift Servers FleetIQ informati su quali server di gioco sono attualmente ideali e disponibili per nuove sessioni di gioco. Il tuo server di gioco deve disporre di un meccanismo che attivi un aggiornamento dello stato di utilizzo a Amazon GameLift Servers FleetIQ. Ad esempio, potresti attivare l'aggiornamento quando i giocatori si connettono al server di gioco o all'inizio di una sessione di gioco. 

All'avvio di una sessione di gioco, il client o i servizi di matchmaking richiedono un server di gioco disponibile (chiamando [ClaimGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html)), richiedono ai giocatori di connettersi al server di gioco e attivano il server di gioco per avviare il gioco. Questo processo è descritto in. [Integrazione Amazon GameLift Servers FleetIQ in un client di gioco](gsg-integrate-gameclient.md) Una «dichiarazione» del server di gioco è valida per 60 secondi e il server di gioco deve essere in grado di aggiornare lo stato di utilizzo in questa finestra. Se lo stato di utilizzo non è aggiornato, Amazon GameLift Servers FleetIQ rimuove il reclamo, presuppone che il server di gioco sia disponibile e può riservare il server di gioco per la richiesta di reclamo di un altro cliente.

```
AWS gamelift update-game-server \
    --game-server-group-name MyLiveGroup \
    --game-server-id UniqueId-1234 \
    --health-check HEALTHY \
    --utilization-status UTILIZED
```

# Annulla la registrazione dei server di gioco
<a name="gsg-integrate-gameserver-deregister"></a>

Quando una partita si conclude, il server di gioco deve annullare la registrazione da Amazon GameLift Servers FleetIQ [usando DeregisterGameServer ().](https://docs.aws.amazon.com/gamelift/latest/apireference/API_DeregisterGameServer.html)

```
AWS gamelift deregister-game-server \
    --game-server-group-name MyLiveGroup \
    --game-server-id UniqueId-1234
```