View a markdown version of this page

Go server SDK per Server Amazon GameLift -- Tipi di dati - GameLift Server Amazon
LogParametersMetricsParametersProcessParametersUpdateGameSessionGameSessionServerParametersStartMatchBackfillRequestPlayerDescribePlayerSessionsRequestStopMatchBackfillRequestGetFleetRoleCredentialsRequest

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

Go server SDK per Server Amazon GameLift -- Tipi di dati

Usa il riferimento all'SDK del server per integrare il tuo gioco multiplayer su cui eseguire l'hosting. Amazon GameLift Servers Per indicazioni sul processo di integrazione, consultaAdd (Aggiungi) GameLift Server Amazon al tuo server di gioco con il server SDK.

GameLiftServerAPI.godefinisce le azioni Go server SDK.

Go server SDK per Server Amazon GameLift -- Azioni

LogParameters

Un oggetto che identifica i file generati durante una sessione di gioco che desideri Amazon GameLift Servers caricare e archiviare al termine della sessione di gioco. Il server di gioco LogParameters lo fornisce Amazon GameLift Servers come parte di un ProcessParameters oggetto in una ProcessReady() chiamata.

Proprietà

 Descrizione
LogPaths

L'elenco dei percorsi di directory dei file di registro del server di gioco che desideri Amazon GameLift Servers archiviare per accessi futuri. Il processo del server genera questi file durante ogni sessione di gioco. Definisci i percorsi e i nomi dei file nel tuo server di gioco e li memorizzi nella directory principale di build del gioco.

I percorsi dei log devono essere assoluti. Ad esempio, se la build del gioco memorizza i log delle sessioni di gioco in un percorso comeMyGame\sessionLogs\, il percorso si troverebbe c:\game\MyGame\sessionLogs su un'istanza di Windows.

Tipo: []string

Obbligatorio: no

MetricsParameters

Un oggetto che comunica i parametri di configurazione per l'inizializzazione del sistema di metriche. Questa configurazione viene utilizzata per impostare i report StatsD, i report sugli arresti anomali e il comportamento di elaborazione delle metriche. Il server di gioco lo fornisce MetricsParameters Amazon GameLift Servers come parte di una InitMetrics() chiamata.

Proprietà

 Descrizione
StatsdHost

L'host del server StatsD per la segnalazione delle metriche (ad esempio, «localhost»).

Tipo: string

Obbligatorio: sì
StatsdPort

La porta del server StatsD per la segnalazione delle metriche (ad esempio, 8125).

Tipo: int

Obbligatorio: sì
CrashReporterHost

L'host di crash reporter per il tracciamento degli arresti anomali e il monitoraggio dei processi.

Tipo: string

Obbligatorio: sì
CrashReporterPort

La porta crash reporter per il tracciamento degli incidenti e il monitoraggio dei processi.

Tipo: int

Obbligatorio: sì
FlushIntervalMs

L'intervallo di flush delle metriche in millisecondi. Controlla la frequenza con cui le metriche vengono inviate a StatsD.

Tipo: int

Obbligatorio: sì
MaxPacketSize

La dimensione massima del pacchetto per le metriche in byte. Limita la dimensione dei pacchetti UDP inviati a StatsD.

Tipo: int

Obbligatorio: sì

ProcessParameters

Un oggetto che descrive la comunicazione tra un processo server e. Amazon GameLift Servers Il processo server fornisce queste informazioni a Amazon GameLift Servers con una chiamata aProcessReady().

Proprietà

 Descrizione
LogParameters Un oggetto con i percorsi di directory dei file generati durante una sessione di gioco. Amazon GameLift Serverscopia e archivia i file per accessi futuri.

Tipo: LogParameters

Obbligatorio: no
OnHealthCheck La funzione di callback che Amazon GameLift Servers richiama la richiesta di un rapporto sullo stato di salute del processo del server. Amazon GameLift Serverschiama questa funzione ogni 60 secondi e attende una risposta per 60 secondi. Il processo del server ritorna TRUE se è integro, FALSE se non è integro. Se non viene restituita alcuna risposta, Amazon GameLift Servers registra il processo server come non integro.

Tipo: OnHealthCheck func() bool

Obbligatorio: no
OnProcessTerminate La funzione di callback che Amazon GameLift Servers richiama per forzare l'arresto del processo del server. Dopo aver richiamato questa funzione, Amazon GameLift Servers attende 5 minuti che il processo server si chiuda e risponde con una ProcessEnding() chiamata prima di arrestare il processo server.

Tipo: OnProcessTerminate func()

Obbligatorio: sì
OnStartGameSession La funzione di callback che Amazon GameLift Servers richiama il passaggio di un oggetto di sessione di gioco aggiornato al processo del server. Amazon GameLift Serverschiama questa funzione quando una richiesta di match backfill è stata elaborata per fornire dati di matchmaker aggiornati. Passa un GameSession oggetto, un aggiornamento dello stato (updateReason) e l'ID del ticket Match Backfill.

Tipo: OnStartGameSession func (model.GameSession )

Obbligatorio: sì
OnUpdateGameSession La funzione di callback che Amazon GameLift Servers richiama il passaggio delle informazioni aggiornate sulla sessione di gioco al processo del server. Amazon GameLift Serverschiama questa funzione dopo aver elaborato una richiesta di backfill della partita per fornire dati di matchmaker aggiornati.

Tipo: OnUpdateGameSession func (model.UpdateGameSession)

Obbligatorio: no
Port Il numero di porta su cui il processo del server ascolta le connessioni dei nuovi 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: int

Obbligatorio: sì

UpdateGameSession

Gli aggiornamenti a un oggetto della sessione di gioco, che includono il motivo per cui la sessione di gioco è stata aggiornata e il relativo ID del ticket di backfill se il backfill viene utilizzato per riempire le sessioni dei giocatori nella sessione di gioco.

Properties Descrizione
GameSession Oggetto GameSession. L'GameSessionoggetto contiene proprietà che descrivono una sessione di gioco.

Tipo: GameSession GameSession()

Obbligatorio: sì
UpdateReason Il motivo per cui la sessione di gioco viene aggiornata.

Tipo: UpdateReason UpdateReason()

Obbligatorio: sì
BackfillTicketId L'ID del ticket di backfill che tenta di aggiornare la sessione di gioco.

Tipo: String

Obbligatorio: no

GameSession

I dettagli di una sessione di gioco.

Properties Descrizione
GameSessionId

Un identificatore univoco per la sessione di gioco. Una sessione di gioco Amazon Resource Name (ARN) ha il seguente formato:. arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>

Tipo: String

Obbligatorio: no
Nome

Un'etichetta descrittiva della sessione di gioco.

Tipo: String

Obbligatorio: no
FleetId

Un identificatore univoco della flotta su cui è in corso la sessione di gioco.

Tipo: String

Obbligatorio: no
MaximumPlayerSessionCount

Il numero massimo di connessioni dei giocatori alla sessione di gioco.

Tipo: Integer

Obbligatorio: no
Porta

Il numero di porta per la sessione di gioco. Per connettersi a un server di Amazon GameLift Servers gioco, un'app richiede sia l'indirizzo IP che il numero di porta.

Tipo: Integer

Obbligatorio: no
IpAddress

L'indirizzo IP della sessione di gioco. Per connettersi a un server di Amazon GameLift Servers gioco, un'app richiede sia l'indirizzo IP che il numero di porta.

Tipo: String

Obbligatorio: no
GameSessionData

Un set di proprietà personalizzate della sessione di gioco, formattate come valore di stringa singola.

Tipo: String

Obbligatorio: no
MatchmakerData

Le informazioni sul processo di matchmaking utilizzato per creare la sessione di gioco, in sintassi JSON, formattate come stringa. Oltre alla configurazione del matchmaking utilizzata, contiene dati su tutti i giocatori assegnati alla partita, inclusi gli attributi dei giocatori e le assegnazioni delle squadre.

Tipo: String

Obbligatorio: no
GameProperties

Un insieme di proprietà personalizzate per una sessione di gioco, formattate come coppie chiave:valore. Queste proprietà vengono passate con una richiesta di avvio di una nuova sessione di gioco.

Tipo: map[string] string

Obbligatorio: no
DnsName

L'identificatore DNS assegnato all'istanza che esegue la sessione di gioco. I valori hanno il seguente formato:

  • TLS-enabled flotte:<unique identifier>.<region identifier>.amazongamelift.com.

  • Non-TLS-enabled flotte:. ec2-<unique identifier>.compute.amazonaws.com

Quando ti connetti a una sessione di gioco in corso su una TLS-enabled flotta, devi utilizzare il nome DNS, non l'indirizzo IP.

Tipo: String

Obbligatorio: no

ServerParameters

Informazioni utilizzate per mantenere la connessione tra un server Amazon GameLift Servers Anywhere e il Amazon GameLift Servers servizio. Queste informazioni vengono utilizzate quando si avviano nuovi processi server conInitSDK(). Per i server ospitati su istanze EC2 Amazon GameLift Servers gestite, utilizza un oggetto vuoto.

Properties Descrizione
WebSocketURL

I GameLiftServerSdkEndpoint Amazon GameLift Servers rendimenti quando si utilizza una RegisterCompute risorsa di calcolo Amazon GameLift Servers Anywhere.

Tipo: string

Obbligatorio: sì
ProcessID

Un identificatore univoco registrato nel processo del server che ospita il gioco.

Tipo: string

Obbligatorio: sì
HostID

L'identificatore univoco della risorsa di calcolo che ospita il nuovo processo server.

HostIDÈ quello ComputeName utilizzato quando hai registrato il tuo computer. Per ulteriori informazioni, consulta RegisterCompute.

Tipo: string

Obbligatorio: sì
FleetID L'identificatore univoco del parco macchine a cui è registrato il computer. Per ulteriori informazioni, consulta RegisterCompute.

Tipo: string

Obbligatorio: sì
AuthToken Il token di autenticazione generato da Amazon GameLift Servers questo autentica il server. Amazon GameLift Servers Per ulteriori informazioni, consulta GetComputeAuthToken.

Tipo: string

Obbligatorio: sì

StartMatchBackfillRequest

Informazioni utilizzate per creare una richiesta di backfill per il matchmaking. Il server di gioco comunica queste informazioni durante una chiamataAmazon GameLift Servers. StartMatchBackfill()

Properties Descrizione
GameSessionArn

L'identificatore univoco della sessione di gioco. L'operazione API GetGameSessionId restituisce l'identificatore in formato ARN.

Tipo: String

Obbligatorio: sì
MatchmakingConfigurationArn

L'identificatore univoco (sotto forma di ARN) che il matchmaker deve utilizzare per questa richiesta. L'ARN del matchmaker per la sessione di gioco originale si trova nell'oggetto della sessione di gioco nella proprietà dei dati del matchmaker. Per ulteriori informazioni sui dati del matchmaker, vedi Lavorare con i dati del matchmaker.

Tipo: String

Obbligatorio: sì
Players

Un set di dati che rappresenta tutti i giocatori attualmente impegnati nella sessione di gioco. Il matchmaker utilizza queste informazioni per cercare nuovi giocatori che rappresentano un buon abbinamento per i giocatori attuali.

Tipo: []model.Player

Obbligatorio: sì
TicketId

L'identificatore univoco per un ticket di richiesta di matchmaking o match backfill. Se non fornisci un valore, Amazon GameLift Servers ne genera uno. Utilizzare questo identificatore per monitorare lo stato del ticket di backfill degli abbinamenti o annullare la richiesta, se necessario.

Tipo: String

Obbligatorio: no

Player

L'oggetto che rappresenta un giocatore nel matchmaking. Quando inizia una richiesta di matchmaking, un giocatore ha un ID giocatore, attributi e possibilmente dati di latenza. Amazon GameLift Serversaggiunge informazioni sulla squadra dopo che è stata effettuata una partita.

Properties Descrizione
LatencyInMS

Un insieme di valori espressi in millisecondi che indicano la quantità di latenza che un giocatore sperimenta quando è connesso a una posizione.

Se viene utilizzata questa proprietà, il giocatore viene abbinato solo per le località elencate. Se un matchmaker ha una regola che valuta la latenza dei giocatori, i giocatori devono segnalare la latenza per essere abbinati.

Tipo: map[string] int

Obbligatorio: no
PlayerAttributes

Una raccolta di coppie chiave:valore che contengono informazioni sui giocatori da utilizzare nel matchmaking. Le chiavi degli attributi del giocatore devono corrispondere a quelle PlayerAttributes utilizzate in un set di regole di matchmaking.

Per ulteriori informazioni sugli attributi dei giocatori, vedere AttributeValue.

Tipo: map[string] AttributeValue

Obbligatorio: no
PlayerId

Un identificatore univoco per un giocatore.

Tipo: String

Obbligatorio: no
Team

Il nome della squadra a cui viene assegnato il giocatore in una partita. Definisci il nome della squadra nel set di regole del matchmaking.

Tipo: String

Obbligatorio: no

DescribePlayerSessionsRequest

Un oggetto che specifica quali sessioni di giocatore recuperare. Il processo server fornisce queste informazioni con una DescribePlayerSessions() chiamata a. Amazon GameLift Servers

Properties Descrizione
GameSessionID

Un 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 èarn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. GameSessionIDÈ una stringa ID personalizzata o una stringa generata.

Tipo: String

Obbligatorio: no
PlayerSessionID

L'identificatore univoco per una sessione del giocatore. Usa questo parametro per richiedere una singola sessione specifica del giocatore.

Tipo: String

Obbligatorio: no
PlayerID

L'identificatore univoco di un giocatore. Usa questo parametro per richiedere tutte le sessioni dei giocatori per un giocatore specifico. Consulta Genera giocatore IDs.

Tipo: String

Obbligatorio: no
PlayerSessionStatusFilter

Lo stato della sessione del giocatore su cui filtrare i risultati. I possibili stati delle sessioni dei giocatori includono:

  • RISERVATO: la richiesta di sessione del giocatore è stata ricevuta, ma il giocatore non si è connesso al processo del server né è stato convalidato.

  • ATTIVO: il giocatore è stato convalidato dal processo del server ed è connesso.

  • COMPLETATO: la connessione del giocatore si è interrotta.

  • TIMEDOUT: è stata ricevuta una richiesta di sessione del giocatore, ma il giocatore non si è connesso o non è stato convalidato entro il limite di timeout (60 secondi).

Tipo: String

Obbligatorio: no
NextToken

Il token che indica l'inizio della pagina successiva dei risultati. Per specificare l'inizio del set di risultati, non fornire un valore. Se fornisci un ID di sessione del giocatore, questo parametro viene ignorato.

Tipo: String

Obbligatorio: no
Limit

Numero massimo di risultati da restituire. Se fornisci un ID di sessione del giocatore, questo parametro viene ignorato.

Tipo: int

Obbligatorio: no

StopMatchBackfillRequest

Informazioni utilizzate per annullare una richiesta di backfill per il matchmaking. Il server di gioco comunica queste informazioni al Amazon GameLift Servers servizio durante una chiamata. StopMatchBackfill()

Properties Descrizione
GameSessionArn

L'identificatore univoco della sessione di gioco della richiesta annullata.

Tipo: string

Obbligatorio: no
MatchmakingConfigurationArn

L'identificatore univoco del matchmaker a cui è stata inviata questa richiesta.

Tipo: string

Obbligatorio: no
TicketId

L'identificativo univoco del ticket di richiesta di rimborso da annullare.

Tipo: string

Obbligatorio: no

GetFleetRoleCredentialsRequest

Le credenziali del ruolo che estendono l'accesso limitato alle tue AWS risorse al server di gioco. Per ulteriori informazioni, consulta Configurare un ruolo di servizio IAM per Amazon GameLift Servers.

Properties Descrizione
RoleArn L'ARN del ruolo di servizio che estende l'accesso limitato alle tue AWS risorse.

Tipo: string

Obbligatorio: sì
RoleSessionName Il nome della sessione che descrive l'uso delle credenziali del ruolo.

Tipo: string

Obbligatorio: sì