SDK do servidor Go para Amazon GameLift Servers -- Tipos de dados - Amazon GameLift Servers
LogParametersMetricsParametersProcessParametersUpdateGameSessionGameSessionServerParametersStartMatchBackfillRequestJogadorDescribePlayerSessionsRequestStopMatchBackfillRequestGetFleetRoleCredentialsRequest

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

SDK do servidor Go para Amazon GameLift Servers -- Tipos de dados

Use a referência do SDK do servidor para integrar o jogo multijogador à hospedagem com o Amazon GameLift Servers. Para obter orientação sobre o processo de integração, consulte Integre o Amazon GameLift Servers ao seu servidor de jogos com o SDK do servidor..

GameLiftServerAPI.go define as ações do SDK do servidor Go.

SDK do servidor do Go para Amazon GameLift Servers – ações

LogParameters

Um objeto que identifica arquivos gerados durante uma sessão de jogo que você deseja que o Amazon GameLift Servers carregue e armazene após o término da sessão de jogo. O servidor do jogo fornece LogParameters ao Amazon GameLift Servers como parte de um objeto ProcessParameters em uma chamada ProcessReady().

Properties

 Descrição
LogPaths

A lista de caminhos de diretório para arquivos de log do servidor de jogos que você deseja que o Amazon GameLift Servers armazene para acesso futuro. O processo do servidor gera esses arquivos durante cada sessão de jogo. Você define caminhos e nomes de arquivos em seu servidor de jogo e os armazena no diretório raiz de construção do jogo.

Os caminhos de log devem ser absolutos. Por exemplo, se a compilação do jogo armazenasse logs de sessão de jogo em um caminho como MyGame\sessionLogs\, o caminho estará em c:\game\MyGame\sessionLogs uma instância do Windows.

Digite: []string

Obrigatório: não

MetricsParameters

Um objeto comunicando parâmetros de configuração para inicializar o sistema de métricas. Essa configuração é usada para configurar relatórios do StatsD, relatórios de falhas e comportamento de processamento de métricas. O servidor do jogo fornece MetricsParameters ao Amazon GameLift Servers como parte de uma chamada InitMetrics().

Properties

 Descrição
StatsdHost

O host do servidor StatsD para relatórios de métricas (por exemplo, “localhost”).

Digite: string

Obrigatório: Sim
StatsdPort

A porta do servidor StatsD para relatórios de métricas (por exemplo, 8125).

Digite: int

Obrigatório: Sim
CrashReporterHost

O host do relatório de acidentes para rastreamento de falhas e monitoramento de processos.

Digite: string

Obrigatório: Sim
CrashReporterPort

A porta do relatório de acidentes para rastreamento de falhas e monitoramento de processos.

Digite: int

Obrigatório: Sim
FlushIntervalMs

O intervalo para limpar os dados das métricas em milissegundos. Controla a frequência com que as métricas são enviadas ao StatsD.

Digite: int

Obrigatório: Sim
MaxPacketSize

O tamanho máximo dos pacotes para métricas em bytes. Limita o tamanho dos pacotes UDP enviados para o StatsD.

Digite: int

Obrigatório: Sim

ProcessParameters

Um objeto que descreve a comunicação entre um processo de servidor e o Amazon GameLift Servers. O processo do servidor fornece essas informações ao Amazon GameLift Servers com uma chamada para ProcessReady().

Properties

 Descrição
LogParameters Um objeto com caminhos de diretório para arquivos que são gerados durante uma sessão de jogo. O Amazon GameLift Servers copia e armazena para acessos futuros.

Digite: LogParameters

Obrigatório: não
OnHealthCheck A função de retorno de chamada que o Amazon GameLift Servers invoca para solicitar um relatório de status de integridade do processo de servidor. O Amazon GameLift Servers chama essa função a cada 60 segundos e espera 60 segundos por uma resposta. O processo do servidor retorna TRUE se estiver íntegro, FALSE se não estiver íntegro. Se nenhuma resposta for retornada, o Amazon GameLift Servers registra o processo do servidor como não íntegro.

Digite: OnHealthCheck func() bool

Obrigatório: não
OnProcessTerminate A função de retorno de chamada que o Amazon GameLift Servers invoca para forçar o encerramento do processo do servidor. Depois de chamar essa função, o Amazon GameLift Servers aguardará 5 minutos para o processo de servidor desligar e responder com uma chamada ProcessEnding() antes do desligamento do processo de servidor.

Digite: OnProcessTerminate func()

Obrigatório: Sim
OnStartGameSession O nome da função de retorno de chamada que o Amazon GameLift Servers invoca para passar um objeto de sessão de jogo atualizado ao processo do jogo. O Amazon GameLift Servers chama essa função quando uma solicitação de alocação de correspondência foi processada para fornecer dados de combinador atualizados. Ele transmite um objeto GameSession, uma atualização de status (updateReason) e o ID do tíquete de alocação de correspondência.

Digite: OnStartGameSession func (model.GameSession )

Obrigatório: Sim
OnUpdateGameSession O nome da função de retorno de chamada que o Amazon GameLift Servers invoca para passar informações de sessão de jogo atualizadas ao processo do jogo. O Amazon GameLift Servers chama essa função após processar uma solicitação de alocação de correspondência para fornecer dados de combinador atualizados.

Digite: OnUpdateGameSession func (model.UpdateGameSession)

Obrigatório: não
Port O número da porta em que o processo de servidor escuta para novas conexões de jogador. O valor deve estar dentro do intervalo de portas configurado para qualquer frota que implanta essa compilação do servidor de jogo. Esse número de porta está incluído nos objetos das sessões de jogo e jogador, que as sessões de jogo usam ao se conectar a um processo de servidor.

Digite: int

Obrigatório: Sim

UpdateGameSession

As atualizações em um objeto de sessão de jogo, que incluem o motivo pelo qual a sessão de jogo foi atualizada e o ID do tíquete de alocação relacionado, caso o preenchimento esteja sendo usado para preencher sessões de jogadores na sessão de jogo.

Propriedades Descrição
GameSession Um objeto GameSession. O objeto GameSession contém propriedades que descrevem uma sessão de jogo.

Digite: GameSession GameSession()

Obrigatório: Sim
UpdateReason O motivo pelo qual a sessão do jogo está sendo atualizada.

Digite: UpdateReason UpdateReason()

Obrigatório: Sim
BackfillTicketId O ID do tíquete de alocação que está tentando atualizar a sessão do jogo.

Digite: String

Obrigatório: não

GameSession

Os detalhes de uma sessão de jogo.

Propriedades Descrição
GameSessionId

Um identificador exclusivo da sessão de jogo. Um nome do recurso da Amazon (ARN) de sessão de jogo tem o seguinte formato: arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>.

Digite: String

Obrigatório: não
Nome

Um rótulo descritivo da sessão do jogo.

Digite: String

Obrigatório: não
FleetId

Um identificador exclusivo da frota em que a sessão de jogo está sendo executada.

Digite: String

Obrigatório: não
MaximumPlayerSessionCount

O número máximo de conexões do jogador com a sessão do jogo.

Digite: Integer

Obrigatório: não
Porta

O número da porta da sessão de jogo. Para se conectar a um servidor de jogos Amazon GameLift Servers, um aplicativo precisa do endereço IP e do número da porta.

Digite: Integer

Obrigatório: não
IpAddress

O endereço IP da sessão de jogo. Para se conectar a um servidor de jogos Amazon GameLift Servers, um aplicativo precisa do endereço IP e do número da porta.

Digite: String

Obrigatório: não
GameSessionData

Um conjunto de propriedades de sessão de jogo personalizadas, formatadas como um único valor de string.

Digite: String

Obrigatório: não
MatchmakerData

As informações sobre o processo de criação de partidas usado para criar a sessão do jogo, na sintaxe JSON, formatado como uma string. Além da configuração de criação de partidas usada, ele contém dados sobre todos os jogadores atribuídos à partida, incluindo atributos do jogador e atribuições da equipe.

Digite: String

Obrigatório: não
GameProperties

Um conjunto de propriedades personalizadas para uma sessão de jogo, formatado como pares de chave:valor. Essas propriedades são passadas com uma solicitação de início de uma nova sessão de jogo.

Digite: map[string] string

Obrigatório: não
DnsName

O identificador DNS atribuído à instância que está executando a sessão do jogo. Os valores têm o formato a seguir:

  • Frotas habilitadas para TLS: <unique identifier>.<region identifier>.amazongamelift.com.

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

Ao se conectar a uma sessão de jogo que está sendo executada em uma frota compatível com TLS, você deve usar o nome DNS, não o endereço IP.

Digite: String

Obrigatório: não

ServerParameters

Informações usadas para manter a conexão entre um servidor Amazon GameLift Servers Anywhere o serviço do Amazon GameLift Servers. Essas informações são usadas ao iniciar novos processos de servidor com InitSDK(). Para servidores hospedados em EC2 instâncias Amazon GameLift Servers gerenciadas, use um objeto vazio.

Propriedades Descrição
WebSocketURL

Os retornos GameLiftServerSdkEndpoint Amazon GameLift Servers quando você RegisterCompute para um recurso de computação Amazon GameLift Servers Anywhere.

Digite: string

Obrigatório: Sim
ProcessID

Um identificador exclusivo registrado no processo do servidor que hospeda seu jogo.

Digite: string

Obrigatório: Sim
HostID

O identificador exclusivo do recurso de computação que está hospedando o novo processo de servidor.

O HostID é o ComputeName usado quando você registrou seu computador. Para obter mais informações, consulte RegisterCompute.

Digite: string

Obrigatório: Sim
FleetID O identificador exclusivo da frota na qual o computador está registrado. Para obter mais informações, consulte RegisterCompute.

Digite: string

Obrigatório: Sim
AuthToken O token de autenticação gerado pelo Amazon GameLift Servers que autentica seu servidor no Amazon GameLift Servers. Para obter mais informações, consulte GetComputeAuthToken.

Digite: string

Obrigatório: Sim

StartMatchBackfillRequest

Informações usadas para criar uma solicitação de alocação de criação de partidas. O servidor do jogo comunica essas informações ao Amazon GameLift Servers em uma chamada StartMatchBackfill().

Propriedades Descrição
GameSessionArn

O identificador da sessão de jogo exclusivo. A operação de API retorna GetGameSessionId o identificador no formato de ARN.

Digite: String

Obrigatório: Sim
MatchmakingConfigurationArn

O identificador exclusivo (na forma de um ARN), para o marcador de jogos a ser usado para essa solicitação. O marcador de jogos da ARN da sessão de jogo original está no objeto de sessão de jogo, na propriedade de dados do marcador de jogos. Para obter mais informações sobre dados de matchmaker, consulte Trabalhar com dados de marcador de jogos.

Digite: String

Obrigatório: Sim
Jogadores

Um conjunto de dados que representa todos os jogadores que estão na sessão do jogo no momento. O marcador de jogos usa essas informações para pesquisar novos jogadores que sejam correspondências ideais para os jogadores atuais.

Digite: []model.Player

Obrigatório: Sim
TicketId

O identificador exclusivo de um tíquete de solicitação de marcação de jogo ou de alocação de correspondência. Se você não fornecer um valor, o Amazon GameLift Servers gerará um. Use esse identificador para acompanhar o status do tíquete de alocação de correspondência ou cancelar a solicitação, se necessário.

Digite: String

Obrigatório: não

Jogador

O objeto que representa um jogador em criação de partidas. Quando uma solicitação de criação de partidas começa, um jogador tem um ID de jogador, atributos, e possivelmente dados de latência. O Amazon GameLift Servers adiciona as informações de equipe após uma combinação ter sido feita.

Propriedades Descrição
LatencyInMS

Um conjunto de valores expressos em milissegundos que indicam a quantidade de latência que um jogador experimenta quando conectado a um local.

Se essa propriedade for usada, o player só será correspondido aos locais listados. Se um marcador de jogos tiver uma regra que avalie a latência do jogador, os jogadores deverão reportar a latência a ser correspondida.

Digite: map[string] int

Obrigatório: não
PlayerAttributes

Uma coleção de pares de chave:valor que contêm informações de jogadores para uso em criação de partidas. As chaves de atributos do jogador devem corresponder às PlayerAttributes usadas em um conjunto de regras de matchmaking.

Para obter mais informações sobre os atributos do jogador, consulte AttributeValue.

Digite: map[string] AttributeValue

Obrigatório: não
PlayerId

Um identificador exclusivo para um jogador.

Digite: String

Obrigatório: não
Equipe

O nome da equipe à qual o jogador está designado em uma partida. Você define o nome da equipe no conjunto de regras de criação de partidas.

Digite: String

Obrigatório: não

DescribePlayerSessionsRequest

Um objeto que especifica quais sessões de jogador devem ser recuperadas. O processo do servidor fornece essas informações com uma chamada DescribePlayerSessions() para o Amazon GameLift Servers.

Propriedades Descrição
GameSessionID

Um identificador da sessão de jogo exclusivo. Use esse parâmetro para solicitar todas as sessões de jogador da sessão de jogo especificada.

O formato do ID da sessão do jogo é arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. O GameSessionID é uma string de ID personalizada ou uma string gerada.

Digite: String

Obrigatório: não
PlayerSessionID

Um identificador exclusivo para uma sessão de jogador. Use esse parâmetro para solicitar uma única sessão de jogador específica.

Digite: String

Obrigatório: não
PlayerID

Um identificador exclusivo para um jogador. Use este parâmetro para solicitar todas as sessões de jogador para um jogador específico. Consulte Gerar IDs de jogador.

Digite: String

Obrigatório: não
PlayerSessionStatusFilter

O status da sessão de jogador para filtrar resultados. Entre os status da sessão de jogador possíveis incluem:

  • RESERVED - A solicitação de sessão do jogador foi recebida, mas o jogador não se conectou ao processo do servidor nem foi validado.

  • ACTIVE - O jogador foi validado pelo processo do servidor e está conectado.

  • COMPLETED – A conexão do jogador foi interrompida.

  • TIMEDOUT – Uma solicitação de sessão de jogador foi recebida, mas o jogador não se conectou ou não foi validado dentro do tempo limite (60 segundos).

Digite: String

Obrigatório: não
NextToken

O token que indica o início da próxima página de resultados. Para especificar o início do conjunto de resultados, não forneça um valor. Se fornecer um ID de sessão do jogador, esse parâmetro será ignorado.

Digite: String

Obrigatório: não
Limit

O número máximo de resultados a serem retornados. Se fornecer um ID de sessão do jogador, esse parâmetro será ignorado.

Digite: int

Obrigatório: não

StopMatchBackfillRequest

Informações usadas para cancelar uma solicitação de alocação de criação de partidas. O servidor do jogo comunica essas informações ao serviço Amazon GameLift Servers em uma chamada StopMatchBackfill().

Propriedades Descrição
GameSessionArn

O identificador de sessão de jogo exclusivo da solicitação que está sendo cancelada.

Digite: string

Obrigatório: não
MatchmakingConfigurationArn

O identificador exclusivo do marcador de jogos para o qual essa solicitação foi enviada.

Digite: string

Obrigatório: não
TicketId

O identificador exclusivo do tíquete de solicitação de alocação a ser cancelado.

Digite: string

Obrigatório: não

GetFleetRoleCredentialsRequest

As credenciais da função que estendem o acesso limitado aos seus AWS recursos no servidor do jogo. Para obter mais informações, consulte, Configurar um perfil de serviço do IAM para o Amazon GameLift Servers.

Propriedades Descrição
RoleArn O ARN do perfil de serviço que estende o acesso limitado aos seus recursos AWS .

Digite: string

Obrigatório: Sim
RoleSessionName O nome da sessão que descreve o uso das credenciais da função.

Digite: string

Obrigatório: Sim