Riferimento Amazon GameLift Server SDK (C#): tipi di dati

Puoi usare questo riferimento all'SDK per server Amazon GameLift C# per aiutarti a preparare il tuo gioco multiplayer da utilizzare con Amazon. GameLift Per informazioni dettagliate sul processo di integrazione, consultaAggiungi Amazon GameLift al tuo server di gioco.

• Operazioni

• Tipi di dati

LogParameters

Questo tipo di dati viene utilizzato per identificare i file generati durante una sessione di gioco che desideri che Amazon GameLift carichi e archivi una volta terminata la sessione di gioco. Queste informazioni vengono comunicate al GameLift servizio Amazon durante una ProcessReady() chiamata.

Indice

logPaths

Elenco dei percorsi delle directory dei file di log del server di gioco che desideri che Amazon GameLift memorizzi per accessi futuri. Questi file vengono generati da un processo server durante ogni sessione di gioco; i percorsi dei file e i nomi sono definiti nel server di gioco e memorizzati nella directory root build di gioco. I percorsi dei log devono essere assoluti. Ad esempio, se la build di gioco archivia i log della sessione di gioco in un percorso come MyGame\sessionlogs\, il percorso di log è c:\game\MyGame\sessionLogs (su un'istanza Windows) o /local/game/MyGame/sessionLogs (su un'istanza Linux).

Tipo: List<String>

Campo obbligatorio: no

DescribePlayerSessionsRequest

Questo tipo di dati viene utilizzato per specificare quale sessione del giocatore recuperare. Può essere usato in diversi modi: (1) fornire PlayerSessionId a richiedere una sessione di gioco specifica; (2) fornire GameSessionId a richiedere tutte le sessioni dei giocatori nella sessione di gioco specificata; o (3) fornire PlayerId a per richiedere tutte le sessioni dei giocatori per il giocatore specificato. Per le raccolte di grandi dimensioni delle sessioni giocatore, utilizzare i parametri di paginazione per recuperare i risultati in pagine sequenziali.

Indice

GameSessionId

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 è il seguente: arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. Il valore di <ID string> corrisponde a una stringa ID personalizzata o (se ne è stata specificata una al momento della creazione della sessione di gioco) a una stringa generata.

Tipo: string

Campo obbligatorio: no

Limite

Numero massimo di risultati da restituire. Utilizzate questo parametro con NextTokenper ottenere risultati sotto forma di un insieme di pagine sequenziali. Se viene specificato un ID sessione giocatore, questo parametro verrà ignorato.

Tipo: integer

Campo obbligatorio: no

NextToken

Token che indica l'inizio della pagina sequenziale successiva relativa ai risultati. Utilizzare il token restituito con una chiamata precedente a questa operazione. Per specificare l'inizio del set di risultati, non specificare un valore. Se viene specificato un ID sessione giocatore, questo parametro verrà ignorato.

Tipo: string

Campo obbligatorio: no

PlayerId

Identificatore univoco per un giocatore. Gli ID giocatore sono definiti dallo sviluppatore. Consultare Genera gli ID dei giocatori.

Tipo: string

Campo obbligatorio: no

PlayerSessionId

Identificatore univoco della sessione giocatore.

Tipo: string

Campo obbligatorio: no

PlayerSessionStatusFilter

Stato sessione giocatore su cui filtrare i risultati. Tra gli stati sessione giocatore possibili sono inclusi i seguenti:

• RESERVED (RISERVATO) - La richiesta della sessione giocatore è stata ricevuta, ma il giocatore non si è ancora connesso al processo server e/o è stato convalidato.

• ACTIVE (ATTIVO) - Il giocatore è stato convalidato dal processo del server ed è attualmente collegato.

• COMPLETED (COMPLETATO) - La connessione del giocatore è stata interrotta.

• TIMEDOUT (SCADUTO) - È stata ricevuta la richiesta di una sessione giocatore, ma il giocatore non si è connesso e/o non è stato convalidato entro il limite di timeout (60 secondi).

Tipo: string

Campo obbligatorio: no

ProcessParameters

Questo tipo di dati contiene il set di parametri inviati al GameLift servizio Amazon durante una ProcessReady() chiamata.

Indice

port

Numero di porta a cui il processo del server rimarrà in attesa di nuove connessioni dei 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

Campo obbligatorio: sì

logParameters

Un oggetto con un elenco di percorsi delle directory per i file log delle sessioni di gioco.

Tipo: Aws::GameLift::Server::LogParameters

Campo obbligatorio: sì

onStartGameSessione

Nome della funzione di callback che il GameLift servizio Amazon richiama per attivare una nuova sessione di gioco. Amazon GameLift chiama questa funzione in risposta alla richiesta del cliente CreateGameSession. La funzione di callback accetta un GameSessionoggetto (definito nell'Amazon GameLift Service API Reference).

Tipo: void OnStartGameSessionDelegate(GameSession gameSession)

Campo obbligatorio: sì

onProcessTerminate

Nome della funzione di callback che il GameLift servizio Amazon richiama per forzare l'arresto del processo del server. Dopo aver richiamato questa funzione, Amazon GameLift attende cinque minuti che il processo del server si spenga e risponda con una ProcessEnding() chiamata prima di chiudere il processo del server.

Tipo: void OnProcessTerminateDelegate()

Campo obbligatorio: sì

onHealthCheck

Nome della funzione di callback che il GameLift servizio Amazon richiama per richiedere un rapporto sullo stato di salute dal processo del server. Amazon GameLift chiama questa funzione ogni 60 secondi. Dopo aver richiamato questa funzione, Amazon GameLift attende 60 secondi per ricevere una risposta e, se non ne riceve alcuna, registra il processo del server come non integro.

Tipo: bool OnHealthCheckDelegate()

Campo obbligatorio: sì

onUpdateGameSessione

Nome della funzione di callback che il GameLift servizio Amazon richiama per passare un oggetto della sessione di gioco aggiornato al processo del server. Amazon GameLift richiama questa funzione quando viene elaborata una richiesta di backfill della partita per fornire dati aggiornati sul matchmaker. Passa un GameSessionoggetto, un aggiornamento di stato (updateReason) e l'ID del ticket di backfill corrispondente.

Tipo: void OnUpdateGameSessionDelegate ( UpdateGameSession updateGameSession )

Campo obbligatorio: no

StartMatchBackfillRequest

Questo tipo di dati viene utilizzato per inviare una richiesta di backfill di abbinamento. Le informazioni vengono comunicate al GameLift servizio Amazon durante una StartMatchBackfill() chiamata.

Indice

GameSessionArn

Identificatore univoco della sessione di gioco. Il metodo SDK GetGameSessionId() restituisce l'identificatore in formato ARN.

Tipo: String

Campo obbligatorio: sì

MatchmakingConfigurationArn

Identificatore univoco, sotto forma di un ARN, che il matchmaker utilizza per questa richiesta. Per trovare il matchmaker utilizzato per creare la sessione di gioco originale, esaminare l'oggetto sessione di gioco nella proprietà dei dati del matchmaker. Scopri di più sui dati del matchmaker in Lavora con i dati del matchmaker.

Tipo: String

Campo obbligatorio: sì

Players

Un set 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. Consulta la Amazon GameLift API Reference Guide per una descrizione del formato degli oggetti di Player. Per trovare gli attributi dei giocatori, gli ID e gli incarichi delle squadre, osservare l'oggetto delle sessioni di gioco nella proprietà dei dati del matchmaker. Se la latenza viene utilizzata dal matchmaker, raccogliere la latenza aggiornata per la regione attuale e includerla nei dati di ciascun giocatore.

Tipo: Giocatore[ ]

Campo obbligatorio: sì

TicketId

Identificatore univoco per un abbinamento o un ticket di richiesta di backfill degli abbinamenti. Se non viene fornito alcun valore qui, Amazon ne GameLift genererà uno sotto forma di UUID. Utilizzare questo identificatore per monitorare lo stato del ticket di backfill degli abbinamenti o annullare la richiesta, se necessario.

Tipo: string

Campo obbligatorio: no

StopMatchBackfillRequest

Questo tipo di dati viene utilizzato per annullare una richiesta di backfill di abbinamento. Le informazioni vengono comunicate al GameLift servizio Amazon durante una StopMatchBackfill() chiamata.

Indice

GameSessionArn

Identificatore univoco della sessione di gioco associato alla richiesta in fase di annullamento.

Tipo: String

Campo obbligatorio: sì

MatchmakingConfigurationArn

Identificatore univoco del matchmaker a cui è stata inviata questa richiesta.

Tipo: String

Campo obbligatorio: sì

TicketId

Identificatore univoco del ticket di richiesta di backfill da annullare.

Tipo: String

Campo obbligatorio: sì