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à.
# Eventi di collocamento delle sessioni di gioco
Amazon GameLift Serversemette eventi per ogni richiesta di posizionamento della sessione di gioco man mano che viene elaborata. Puoi pubblicare questi eventi su un argomento di Amazon SNS, come descritto in. [Imposta la notifica degli eventi per il posizionamento della sessione di gioco](queue-notification.md) Questi eventi vengono inoltre trasmessi ad Amazon CloudWatch Events quasi in tempo reale e con la massima diligenza possibile.
Questo argomento descrive la struttura degli eventi di collocamento delle sessioni di gioco e fornisce un esempio per ogni tipo di evento. Per ulteriori informazioni sullo stato delle richieste di posizionamento delle sessioni di gioco, consulta [GameSessionPlacement](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSessionPlacement.html)l'*Amazon GameLift ServersAPI Reference*.
## Sintassi degli eventi di posizionamento
Gli eventi sono rappresentati come oggetti JSON. La struttura degli eventi è conforme al modello CloudWatch Events, con campi di primo livello simili e dettagli specifici del servizio.
I campi di primo livello includono quanto segue (vedi [Event Pattern](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) per maggiori dettagli):
version
Questo campo è sempre impostato su 0 (zero).
id
Identificatore di tracciamento univoco per l'evento.
detail-type (tipo di dettaglio)
Il valore è sempre`GameLift Queue Placement Event`.
origine
Il valore è sempre`aws.gamelift`.
account
L' AWS account che viene utilizzato per gestireAmazon GameLift Servers.
time
Timestamp dell'evento.
region
La AWS regione in cui viene elaborata la richiesta di collocamento. Questa è la regione in cui si trova la coda della sessione di gioco in uso.
risorse
Valore ARN della coda della sessione di gioco che sta elaborando la richiesta di posizionamento.
## PlacementFulfilled
La richiesta di collocamento è stata soddisfatta con successo. È stata avviata una nuova sessione di gioco e sono state create nuove sessioni per ogni giocatore elencato nella richiesta di posizionamento della sessione di gioco. Le informazioni sulla connessione del giocatore sono disponibili.
**Sintassi dettagliata:**
PlacementID
Un identificatore univoco assegnato alla richiesta di posizionamento della sessione di gioco.
port
Il numero di porta per la nuova sessione di gioco.
gameSessionArn
L'identificatore ARN per la nuova sessione di gioco.
ipAddress
L'indirizzo IP della sessione di gioco.
Nome DNS
L'identificatore DNS assegnato all'istanza che esegue la nuova sessione di gioco. Il formato dei valori è diverso a seconda che l'istanza che esegue la sessione di gioco sia abilitata per TLS. Quando si connettono a una sessione di gioco su una flotta che supporta TLS, i giocatori devono utilizzare il nome DNS, non l'indirizzo IP.
Flotte abilitate per TLS:. `..amazongamelift.com`
Non-TLS-enabled flotte:. `ec2-.compute.amazonaws.com`
startTime
Timestamp che indica quando questa richiesta è stata inserita nella coda.
endTime
Timestamp che indica quando questa richiesta è stata soddisfatta.
gameSessionRegion
AWS Regione di residenza della flotta che ospita la sessione di gioco.
gameSessionLocation
L'ubicazione della flotta in cui è in corso la sessione di gioco. Questo valore potrebbe specificare la regione di origine della flotta o una località remota.
playerGatewayStatus
Lo stato del gateway del giocatore presso la sede della flotta che esegue questa sessione di gioco.
I valori possibili includono:
+ `ENABLED`— Il Player Gateway è disponibile per instradare le connessioni dei giocatori per questa sessione di gioco.
+ `DISABLED`— Il gateway del giocatore non è disponibile per questa sessione di gioco.
ComputeName
Un'etichetta descrittiva per la risorsa di calcolo che ospita la sessione di gioco. Per le flotte EC2, questo è l'ID dell'istanza EC2. Per le flotte di container, a ciascun gruppo di container di server di gioco su un'istanza di flotta viene assegnato un nome di calcolo. Per le flotte Anywhere, questo è il nome di calcolo personalizzato.
placedPlayerSessions
La raccolta di sessioni di gioco che sono state create per ogni giocatore nella richiesta di posizionamento della sessione di gioco.
### Esempio
```
{
"version": "0",
"id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementFulfilled",
"placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
"port": "6262",
"gameSessionArn": "arn:aws:gamelift:us-west-2::gamesession/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa/us-east-1/4444dddd-55ee-66ff-77aa-8888bbbb99cc",
"ipAddress": "98.987.98.987",
"dnsName": "ec2-12-345-67-890.us-west-2.compute.amazonaws.com",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z",
"gameSessionRegion": "us-west-2",
"playerGatewayStatus": "ENABLED",
"gameSessionLocation": "us-east-1",
"computeName": "i-1234567890abcdef0",
"placedPlayerSessions": [
{
"playerId": "player-1"
"playerSessionId": "psess-1232131232324124123123"
}
]
}
}
```
## PlacementCancelled
La richiesta di collocamento è stata annullata con una chiamata al GameLift servizio. [StopGameSessionPlacement](https://docs.aws.amazon.com/gamelift/latest/apireference/API_StopGameSessionPlacement.html)
**Dettaglio:**
ID di posizionamento
Un identificatore univoco assegnato alla richiesta di posizionamento della sessione di gioco.
startTime
Timestamp che indica quando questa richiesta è stata inserita nella coda.
endTime
Timestamp che indica quando questa richiesta è stata annullata.
### Esempio
```
{
"version": "0",
"id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementCancelled",
"placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z"
}
}
```
## PlacementTimedOut
Il posizionamento della sessione di gioco non è stato completato correttamente prima della scadenza del limite di tempo della coda. La richiesta di piazzamento può essere inoltrata nuovamente se necessario.
**Dettaglio:**
ID di posizionamento
Un identificatore univoco assegnato alla richiesta di posizionamento della sessione di gioco.
startTime
Timestamp che indica quando questa richiesta è stata inserita nella coda.
endTime
Timestamp che indica quando questa richiesta è stata annullata.
### Esempio
```
{
"version": "0",
"id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementTimedOut",
"placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z"
}
}
```
## PlacementFailed
Amazon GameLift Serversnon è stato in grado di soddisfare la richiesta di sessione di gioco. Ciò è generalmente causato da un errore interno imprevisto. La richiesta di collocamento può essere inoltrata nuovamente se necessario.
**Dettaglio:**
ID di posizionamento
Un identificatore univoco assegnato alla richiesta di posizionamento della sessione di gioco.
startTime
Timestamp che indica quando questa richiesta è stata inserita nella coda.
endTime
Timestamp che indica quando questa richiesta non è riuscita.
### Esempio
```
{
"version": "0",
"id": "39c978f3-ba46-3f7c-e787-55bfcca1bd31",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "252386620677",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:252386620677:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementFailed",
"placementId": "e4a1119a-39af-45cf-a990-ef150fe0d453",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z"
}
}
```