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à.
Server SDK (Unreal) perAmazon GameLift Servers: tipi di dati
Utilizza il Amazon GameLift Servers server SDK for Unreal Reference 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
Nota
Questo riferimento si riferisce a una versione precedente del server SDK forAmazon GameLift Servers. Per la versione più recente, consulta Server C++ (Unreal) SDK 5.x per Amazon GameLift Servers -- Tipi di dati.
Questa API è definita in GameLiftServerSDK.h e GameLiftServerSDKModels.h.
Per configurare il plugin Unreal Engine e vedere esempi di codice Integrazione Amazon GameLift Servers in un progetto Unreal Engine.
Server SDK (Unreal) per Amazon GameLift Servers -- Azioni
Argomenti
FDescribePlayerSessionsRequest
Questo tipo di dati viene utilizzato per specificare quale sessione del giocatore recuperare. Puoi utilizzarlo come segue:
-
Fornisci un PlayerSessionId messaggio per richiedere una sessione di gioco specifica.
-
Fornisci un GameSessionId campo per richiedere tutte le sessioni dei giocatori nella sessione di gioco specificata.
-
Fornisci un PlayerId campo per richiedere tutte le sessioni di gioco per il giocatore specificato.
Per le raccolte di grandi dimensioni delle sessioni giocatore, utilizza i parametri di paginazione per recuperare i risultati in blocchi 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: stringa
Obbligatorio: no
- Limite
-
Numero massimo di risultati da restituire. Utilizzate questo parametro con NextTokenper ottenere risultati sotto forma di set di pagine sequenziali. Se viene specificato un ID sessione giocatore, questo parametro verrà ignorato.
Tipo: Integer
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: stringa
Obbligatorio: no
- PlayerId
-
Identificatore univoco per un giocatore. IDs I giocatori sono definiti dallo sviluppatore. Per informazioni, consulta Genera giocatore IDs.
▬Tipo: stringa
Obbligatorio: no
- PlayerSessionId
-
Identificatore univoco della sessione giocatore.
▬Tipo: stringa
Obbligatorio: no
- PlayerSessionStatusFilter
-
Stato sessione giocatore su cui filtrare i risultati. Tra gli stati sessione giocatore possibili sono inclusi i seguenti:
-
RISERVATO — La richiesta di sessione del giocatore è stata ricevuta, ma il giocatore non si è ancora connesso al server. Il processo and/or è stato convalidato.
-
ACTIVE (ATTIVO) - Il giocatore è stato convalidato dal processo del server ed è attualmente collegato.
-
COMPLETED (COMPLETATO) - La connessione del giocatore è stata interrotta.
-
TIMEDOUT — È stata ricevuta una richiesta di sessione di gioco, ma il giocatore che non si and/or è connesso non è stata convalidata entro il limite di timeout (60 secondi).
▬Tipo: stringa
Obbligatorio: no
-
FProcessParametri
Questo tipo di dati contiene il set di parametri inviato al servizio Amazon GameLift Servers in una chiamata ProcessReady().
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: numero intero
Obbligatorio: sì
- logParameters
-
Un oggetto con un elenco di percorsi delle directory per i file log delle sessioni di gioco.
Tipo: TArray < FString >
Obbligatorio: no
- onStartGameSessione
-
Nome della funzione di callback richiamata dal Amazon GameLift Servers servizio per attivare una nuova sessione di gioco. Amazon GameLift Serverschiama questa funzione in risposta alla richiesta del client. CreateGameSession La funzione di callback accetta un GameSessionoggetto (definito nel Amazon GameLift ServersService API Reference).
Tipo: FOnStartGameSession
Obbligatorio: sì
- onProcessTerminate
-
Nome della funzione di callback richiamata dal Amazon GameLift Servers servizio per forzare la chiusura del processo del server. Dopo aver richiamato questa funzione, Amazon GameLift Servers attende per cinque minuti l'arresto del processo del server e risponde con una chiamata ProcessEnding() prima di arrestare il processo del server.
Tipo: Delegato FSimple
Obbligatorio: no
- onHealthCheck
-
Nome della funzione di callback richiamata dal Amazon GameLift Servers servizio per richiedere un rapporto sullo stato di salute del processo del server. Amazon GameLift Serverschiama questa funzione ogni 60 secondi. Dopo aver richiamato questa funzione, Amazon GameLift Servers attende per 60 secondi l'arrivo di una risposta e, se non ne riceve alcuna, registra il processo del server come non integro.
Tipo: FOnHealthCheck
Obbligatorio: no
- onUpdateGameSessione
-
Nome della funzione di callback richiamata dal Amazon GameLift Servers servizio per passare 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 GameSessionoggetto, uno status update (
updateReason) e l'ID del ticket match backfill.Tipo: FOnUpdateGameSession
Obbligatorio: no
FStartMatchBackfillRequest
Questo tipo di dati viene utilizzato per inviare una richiesta di backfill di abbinamento. Le informazioni vengono comunicate al servizio Amazon GameLift Servers in una chiamata StartMatchBackfill().
Indice
- GameSessionArn
-
Identificatore univoco della sessione di gioco. L'operazione API GetGameSessionId() restituisce l'identificatore nel formato ARN.
Tipo: FString
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 dei matchmaker in Lavora con i dati dei matchmaker.
Tipo: FString
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 Guida di riferimento Amazon GameLift Servers API per una descrizione del formato degli oggetti Player. Per trovare gli attributi dei giocatori e gli incarichi della squadra, cerca nell'oggetto della sessione di gioco, nella proprietà dei dati del matchmaker. IDs Se la latenza viene utilizzata dal matchmaker, raccogliere la latenza aggiornata per la regione attuale e includerla nei dati di ciascun giocatore.
Obbligatorio: sì
- TicketId
-
Identificatore univoco per un abbinamento o un ticket di richiesta di backfill degli abbinamenti. Se non viene fornito alcun valore qui, ne Amazon GameLift Servers 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: FString
Obbligatorio: no
FStopMatchBackfillRequest
Questo tipo di dati viene utilizzato per annullare una richiesta di backfill di abbinamento. Le informazioni vengono comunicate al servizio Amazon GameLift Servers in una chiamata StopMatchBackfill().
Indice
- GameSessionArn
-
Identificatore univoco della sessione di gioco associato alla richiesta in fase di annullamento.
Tipo: FString
Obbligatorio: sì
- MatchmakingConfigurationArn
-
Identificatore univoco del matchmaker a cui è stata inviata questa richiesta.
Tipo: FString
Obbligatorio: sì
- TicketId
-
Identificatore univoco del ticket di richiesta di backfill da annullare.
Tipo: FString
Obbligatorio: sì
