Imposta la notifica degli eventi per il posizionamento delle sessioni di gioco

Puoi utilizzare le notifiche degli eventi per monitorare lo stato delle singole richieste di piazzamento. Ti consigliamo di impostare le notifiche relative agli eventi per tutti i giochi con un elevato volume di attività di posizionamento.

Sono disponibili due opzioni per impostare le notifiche di eventi.

• Fai Amazon GameLift Servers pubblicare notifiche di eventi su un argomento di Amazon Simple Notification Service (Amazon SNS) utilizzando una coda.

• Usa EventBridge gli eventi Amazon pubblicati automaticamente e la sua suite di strumenti per la gestione degli eventi.

Per un elenco degli eventi di posizionamento delle sessioni di gioco emessi daAmazon GameLift Servers, consultaEventi di collocamento delle sessioni di gioco.

Importante

Per i sistemi di posizionamento ad alto volume, consigliamo di utilizzare argomenti Amazon SNS standard (non FIFO) anziché argomenti FIFO. Gli argomenti FIFO hanno limiti di pubblicazione inferiori rispetto agli argomenti standard, il che può comportare eccezioni limitate in caso di carico elevato. Se riscontri problemi di limitazione con gli argomenti FIFO, potresti perdere le notifiche di posizionamento in coda.

Configura un argomento SNS

Amazon GameLift ServersPer pubblicare tutti gli eventi generati da una coda di sessione di gioco su un argomento, imposta il campo di destinazione della notifica su un argomento.

Per configurare un argomento SNS per la notifica di eventi Amazon GameLift Servers

1. Accedi AWS Management Console e apri la console Amazon SNS nella versione v3/home. https://console.aws.amazon.com/sns/

2. Dalla pagina Argomenti SNS, scegli Crea argomento e segui le istruzioni per creare il tuo argomento.

3. In Politica di accesso, procedi come segue:

   1. Scegli il metodo Avanzato.

   2. Aggiungi la seguente sezione in grassetto dell'oggetto JSON alla policy esistente.

      JSON

      {
        "Version": "2008-10-17",
        "Id": "__default_policy_ID",
        "Statement": [
          {
            "Sid": "__default_statement_ID",
            "Effect": "Allow",
            "Principal": {
              "AWS": "*"
            },
            "Action": [
              "SNS:GetTopicAttributes",
              "SNS:SetTopicAttributes",
              "SNS:AddPermission",
              "SNS:RemovePermission",
              "SNS:DeleteTopic",
              "SNS:Subscribe",
              "SNS:ListSubscriptionsByTopic",
              "SNS:Publish"
            ],
            "Resource": "arn:aws:sns:us-east-1:111122223333:your_topic_name",
            "Condition": {
              "StringEquals": {
                "AWS:SourceAccount": "your_account"
              }
            }
          },
          {
            "Sid": "__console_pub_0",
            "Effect": "Allow",
            "Principal": { 
              "Service": "gamelift.amazonaws.com" 
            },
            "Action": "sns:Publish",
            "Resource": "arn:aws:sns:us-east-1:111122223333:your_topic_name",
            "Condition": {
              "ArnLike": {
              "aws:SourceArn": "arn:aws:gamelift:us-east-1:111122223333:gamesessionqueue/your_queue_name"
              }
            }
          }
        ]
      }
      

   3. (Facoltativo) Aggiungete un ulteriore controllo degli accessi all'argomento aggiungendo condizioni alla politica delle risorse.

4. Scegli Create topic (Crea argomento).

5. Dopo aver creato l'argomento SNS, aggiungilo alle code durante la creazione della coda oppure modifica una coda esistente per aggiungerlo.

Configura un argomento SNS con crittografia lato server

La crittografia lato server (SSE) consente di archiviare dati sensibili in argomenti crittografati. SSE protegge il contenuto dei messaggi negli argomenti Amazon SNS utilizzando chiavi gestite in AWS Key Management Service (AWS KMS). Per ulteriori informazioni sulla crittografia lato server con Amazon SNS, consulta Encryption at rest nella Amazon Simple Notification Service Developer Guide.

Per impostare un argomento SNS con crittografia lato server, consulta i seguenti argomenti:

• Creazione di una chiave nella Guida per gli sviluppatori AWS Key Management Service

• Abilitazione di SSE per un argomento nella Amazon Simple Notification Service Developer Guide

Quando crei la tua chiave KMS, utilizza la seguente politica per le chiavi KMS:

{ 
    "Effect": "Allow", 
    "Principal": { 
        "Service": "gamelift.amazonaws.com" 
     },
    "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
    ],
    "Resource": "*",
    "Condition": {
        "ArnLike": { 
            "aws:SourceArn": "arn:aws:gamelift:your_region:your_account:gamesessionqueue/your_queue_name" 
        },
        "StringEquals": { 
            "kms:EncryptionContext:aws:sns:topicArn": "arn:aws:sns:your_region:your_account:your_sns_topic_name" 
        }
    }
}

Configura EventBridge

Amazon GameLift Serverspubblica automaticamente tutti gli eventi di posizionamento delle sessioni di gioco su EventBridge. Con EventBridge puoi impostare regole per indirizzare gli eventi alle destinazioni per l'elaborazione. Ad esempio, puoi impostare una regola per indirizzare l'evento PlacementFulfilled a una AWS Lambda funzione che gestisce le attività che precedono la connessione a una sessione di gioco. Per ulteriori informazioni su EventBridge, consulta What is Amazon EventBridge? nella Amazon EventBridge User Guide.

Di seguito sono riportati alcuni esempi di EventBridge regole da utilizzare con le Amazon GameLift Servers code:

Corrisponde agli eventi di tutte le code Amazon GameLift Servers

{
    "source": [
        "aws.gamelift"
    ],
    "detail-type": [
        "GameLift Queue Placement Event"
    ]
}

Corrisponde agli eventi di una coda specifica

{
    "source": [
        "aws.gamelift"
    ],
    "detail-type": [
        "GameLift Queue Placement Event"
    ],
    "resources": [
        "arn:aws:gamelift:your_region:your_account:gamesessionqueue/your_queue_name"
    ]
}