GameLift Server Amazon SDK per Go: tipi di dati - Amazon GameLift
LogParametersProcessParametersUpdateGameSessionGameSessionServerParametersStartMatchBackfillRequestPlayerDescribePlayerSessionsRequestStopMatchBackfillRequestGetFleetRoleCredentialsRequest

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

GameLift Server Amazon SDK per Go: tipi di dati

Usa il riferimento Amazon GameLift Go server SDK 5.x per integrare il tuo gioco multiplayer per l'hosting con Amazon GameLift. Per indicazioni sul processo di integrazione, consultaAggiungi Amazon GameLift al tuo server di gioco.

GameLiftServerAPI.godefinisce le SDK azioni del server Go.

GameLift Server Amazon SDK per Go: azioni

LogParameters

Un oggetto che identifica i file generati durante una sessione di gioco che desideri che Amazon GameLift carichi e archivi al termine della sessione di gioco. Il server di gioco fornisce LogParameters ad Amazon GameLift 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 che Amazon GameLift memorizzi 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 di build del gioco principale.

I percorsi di registro 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

Required: No

ProcessParameters

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

Proprietà

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

Tipo: LogParameters

Required: No
OnHealthCheck La funzione di callback GameLift richiamata da Amazon per richiedere un rapporto sullo stato di salute del processo del server. Amazon GameLift chiama 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 registra il processo del server come non integro.

Tipo: OnHealthCheck func() bool

Required: No
OnProcessTerminate La funzione di callback GameLift richiamata da Amazon per forzare l'arresto del processo server. Dopo aver chiamato questa funzione, Amazon GameLift attende 5 minuti che il processo server si spenga e risponda con una ProcessEnding() chiamata prima di chiudere il processo server.

Tipo: OnProcessTerminate func()

Campo obbligatorio: sì
OnStartGameSession La funzione di callback GameLift richiamata da Amazon per passare un oggetto di sessione di gioco aggiornato al processo del server. Amazon GameLift chiama questa funzione quando viene elaborata una richiesta di match backfill per fornire dati aggiornati sul matchmaker. Passa un GameSession oggetto, uno status update (updateReason) e l'ID del ticket match backfill.

Tipo: OnStartGameSession func (model.GameSession )

Campo obbligatorio: sì
OnUpdateGameSession La funzione di callback GameLift richiamata da Amazon per passare informazioni aggiornate sulla sessione di gioco al processo del server. Amazon GameLift chiama questa funzione dopo aver elaborato una richiesta di match backfill per fornire dati aggiornati del matchmaker.

Tipo: OnUpdateGameSession func (model.UpdateGameSession)

Required: No
Port Il numero di porta su cui il processo del server ascolta le connessioni di 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

Campo obbligatorio: sì

UpdateGameSession

Gli aggiornamenti a un oggetto della sessione di gioco, che include 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.

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

Tipo: GameSession GameSession()

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

Tipo: UpdateReason UpdateReason()

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

Tipo: String

Required: No

GameSession

I dettagli di una sessione di gioco.

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

Required: No
Nome

Un'etichetta descrittiva della sessione di gioco.

Tipo: String

Required: No
FleetId

Un identificatore univoco per la flotta su cui è in esecuzione la sessione di gioco.

Tipo: String

Required: No
MaximumPlayerSessionCount

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

Tipo: Integer

Required: No
Porta

Il numero di porta per la sessione di gioco. Per connettersi a un server di GameLift gioco Amazon, un'app necessita sia dell'indirizzo IP che del numero di porta.

Tipo: Integer

Required: No
IpAddress

L'indirizzo IP della sessione di gioco. Per connettersi a un server di GameLift gioco Amazon, un'app necessita sia dell'indirizzo IP che del numero di porta.

Tipo: String

Required: No
GameSessionData

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

Tipo: String

Required: No
MatchmakerData

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

Tipo: String

Required: 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

Required: No
DnsName

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

  • TLSflotte abilitate:. <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 esecuzione su una flotta TLS abilitata, devi usare il DNS nome, non l'indirizzo IP.

Tipo: String

Required: No

ServerParameters

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

Proprietà Descrizione
WebSocketURL

GameLiftServerSdkEndpointAmazon GameLift restituisce quando sei RegisterComputeun cliente Amazon GameLift Anywhere risorsa di calcolo.

Tipo: string

Campo obbligatorio: sì
ProcessID

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

Tipo: string

Campo obbligatorio: sì
HostID

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

HostIDViene ComputeName utilizzato al momento della registrazione del computer. Per ulteriori informazioni, vedere RegisterCompute.

Tipo: string

Campo obbligatorio: sì
FleetID L'identificatore univoco della flotta su cui è registrato il calcolo. Per ulteriori informazioni, vedere. RegisterCompute

Tipo: string

Campo obbligatorio: sì
AuthToken Il token di autenticazione generato da Amazon GameLift che autentica il tuo server su Amazon. GameLift Per ulteriori informazioni, consulta. GetComputeAuthToken

Tipo: string

Campo obbligatorio: sì

StartMatchBackfillRequest

Informazioni utilizzate per creare una richiesta di riempimento del matchmaking. Il server di gioco comunica queste informazioni ad Amazon GameLift tramite una StartMatchBackfill() chiamata.

Proprietà Descrizione
GameSessionArn

L'identificatore univoco della sessione di gioco. L'APIoperazione GetGameSessionId restituisce l'identificatore nel ARN formato.

Tipo: String

Campo obbligatorio: sì
MatchmakingConfigurationArn

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

Tipo: String

Campo obbligatorio: sì
Players

Un insieme 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.

Tipo: []model.Player

Campo obbligatorio: sì
TicketId

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

Tipo: String

Required: No

Player

L'oggetto che rappresenta un giocatore in matchmaking. Quando inizia una richiesta di matchmaking, un giocatore ha un ID giocatore, attributi e possibilmente dati sulla latenza. Amazon GameLift aggiunge le informazioni sulla squadra dopo la fine di una partita.

Proprietà Descrizione
LatencyInSM

Un insieme di valori espressi in millisecondi che indica 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 posizioni 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

Required: 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, vedi AttributeValue.

Tipo: map[string] AttributeValue

Required: No
PlayerId

Un identificatore univoco per un giocatore.

Tipo: String

Required: No
Team

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

Tipo: String

Required: No

DescribePlayerSessionsRequest

Un oggetto che specifica le sessioni dei giocatori da recuperare. Il processo del server fornisce queste informazioni con una DescribePlayerSessions() chiamata ad Amazon GameLift.

Proprietà Descrizione
GameSessionID

Un identificatore di sessione di gioco univoco. 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

Required: No
PlayerSessionID

L'identificatore univoco per la sessione di un giocatore. Usa questo parametro per richiedere una singola sessione di gioco specifica.

Tipo: String

Required: No
PlayerID

L'identificatore univoco di un giocatore. Usa questo parametro per richiedere tutte le sessioni di gioco per un giocatore specifico. Per informazioni, consulta Genera gli ID dei giocatori.

Tipo: String

Required: No
PlayerSessionStatusFilter

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

  • RESERVED— La richiesta di sessione del giocatore è stata ricevuta, ma il giocatore non si è connesso al processo del server o non è stato convalidato.

  • ACTIVE— Il giocatore è stato convalidato dal processo del server ed è connesso.

  • COMPLETED— La connessione del giocatore è interrotta.

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

Tipo: String

Required: 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

Required: No
Limit

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

Tipo: int

Required: No

StopMatchBackfillRequest

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

Proprietà Descrizione
GameSessionArn

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

Tipo: string

Required: No
MatchmakingConfigurationArn

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

Tipo: string

Required: No
TicketId

L'identificatore univoco del ticket di richiesta di riempimento da annullare.

Tipo: string

Required: No

GetFleetRoleCredentialsRequest

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

Proprietà Descrizione
RoleArn Il ruolo ARN di servizio che estende l'accesso limitato alle tue AWS risorse.

Tipo: string

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

Tipo: string

Campo obbligatorio: sì