GameLift Server Amazon SDK per Go: tipi di dati

Puoi utilizzare questo SDK riferimento al server Amazon GameLift Go per aiutarti a preparare il gioco multiplayer da utilizzare con Amazon GameLift. Per dettagli sul processo di integrazione, consultaAggiungi Amazon GameLift al tuo server di gioco.

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 Flotte non TLS abilitate:. 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 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 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ì