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á.
GameLift Servidor Amazon SDK 4.x para C#: tipos de dados
Use a SDK referência do servidor Amazon GameLift C# para integrar seu jogo multijogador para hospedagem na Amazon GameLift. Para obter orientação sobre o processo de integração, consulteAdicione GameLift a Amazon ao seu servidor de jogos.
nota
Essa referência é para uma versão anterior do GameLift servidor AmazonSDK. Para obter a versão mais recente, consulte GameLift Servidor Amazon SDK 5.x para C# e Unity: tipos de dados.
GameLift Servidor Amazon SDK 4.x para C#: ações
LogParameters
Esse tipo de dados é usado para identificar quais arquivos gerados durante uma sessão de jogo você deseja que GameLift a Amazon envie e armazene após o término da sessão de jogo. Essas informações são comunicadas ao GameLift serviço da Amazon em uma ProcessReady() chamada.
Conteúdo
- logPaths
-
Lista de caminhos de diretório para os arquivos de log do servidor de jogos que você deseja que GameLift a Amazon armazene para acesso futuro. Esses arquivos são gerados por um processo de servidor durante cada sessão de jogo; caminhos de arquivo e nomes são definidos no servidor de jogo e armazenados no diretório de compilação do jogo raiz. Os caminhos de registro devem ser caminhos absolutos. Por exemplo, se a compilação do jogo armazenasse logs de sessão de jogo em um caminho como
MyGame\sessionlogs\
, o caminho de log seriac:\game\MyGame\sessionLogs
(em uma instância do Windows) ou/local/game/MyGame/sessionLogs
(em uma instância do Linux).Tipo: List<String>
Obrigatório: Não
DescribePlayerSessionsRequest
Esse tipo de dados é usado para especificar quais sessões de jogador recuperar. Ele pode ser usado de várias maneiras: (1) forneça PlayerSessionId a para solicitar uma sessão específica do jogador; (2) forneça GameSessionId a para solicitar todas as sessões do jogador na sessão de jogo especificada; ou (3) forneça PlayerId a para solicitar todas as sessões do jogador especificado. Para coleções maiores de sessões de jogador, use os parâmetros de paginação para recuperar resultados como páginas sequenciais.
Conteúdo
- GameSessionId
-
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 de jogo é o seguinte:
arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>
. O valor de <ID string> é uma string de ID personalizada (se uma tiver sido especificada quando a sessão do jogo foi criada) ou uma string gerada.Tipo: string
Obrigatório: Não
- Limite
-
O número máximo de resultados a serem retornados. Use esse parâmetro com NextTokenpara obter resultados como um conjunto de páginas sequenciais. Se um ID de sessão de jogador for especificado, esse parâmetro será ignorado.
Tipo: número inteiro
Obrigatório: não
- NextToken
-
Token indicando o início da próxima página sequencial de resultados. Use o token retornado com uma chamada anterior para essa ação. Para especificar o início do conjunto de resultados, não especifique um valor. Se um ID de sessão de jogador for especificado, esse parâmetro será ignorado.
Tipo: string
Obrigatório: Não
- PlayerId
-
Identificador exclusivo para um jogador. IDsOs jogadores são definidos pelo desenvolvedor. Consulte Gerar IDs de jogador.
Tipo: string
Obrigatório: Não
- PlayerSessionId
-
Identificador exclusivo para uma sessão de jogador.
Tipo: string
Obrigatório: Não
- PlayerSessionStatusFilter
-
Status da sessão de jogador para filtrar resultados. Entre os status da sessão de jogador possíveis estão os seguintes:
-
RESERVED— A solicitação de sessão do jogador foi recebida, mas o jogador ainda não se conectou ao processo do servidor e/ou foi validado.
-
ACTIVE— O player foi validado pelo processo do servidor e está conectado no momento.
-
COMPLETED— A conexão do player foi interrompida.
-
TIMEDOUT— Uma solicitação de sessão do jogador foi recebida, mas o jogador não se conectou e/ou não foi validado dentro do limite de tempo limite (60 segundos).
Tipo: string
Obrigatório: Não
-
ProcessParameters
Esse tipo de dados contém o conjunto de parâmetros enviados ao GameLift serviço da Amazon em uma ProcessReady() chamada.
Conteúdo
- porta
-
Número da porta em que o processo de servidor escutará 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.
Tipo: número inteiro
Obrigatório: Sim
- logParameters
-
Objeto com uma lista de caminhos de diretório para arquivos de log da sessão de jogo.
Tipo:
Aws::GameLift::Server::LogParameters
Obrigatório: Sim
- onStartGameSessão
-
Nome da função de retorno de chamada que o GameLift serviço da Amazon invoca para ativar uma nova sessão de jogo. A Amazon GameLift chama essa função em resposta à solicitação do cliente CreateGameSession. A função de retorno de chamada usa um GameSessionobjeto (definido na Amazon GameLift Service API Reference).
Tipo:
void OnStartGameSessionDelegate(GameSession gameSession)
Obrigatório: Sim
- onProcessTerminate
-
Nome da função de retorno de chamada que o GameLift serviço da Amazon invoca para forçar o encerramento do processo do servidor. Depois de chamar essa função, a Amazon GameLift espera cinco minutos até que o processo do servidor seja encerrado e responda com uma ProcessEnding() chamada antes de encerrar o processo do servidor.
Tipo:
void OnProcessTerminateDelegate()
Obrigatório: Sim
- onHealthCheck
-
Nome da função de retorno de chamada que o GameLift serviço da Amazon invoca para solicitar um relatório de status de saúde do processo do servidor. A Amazon GameLift chama essa função a cada 60 segundos. Depois de chamar essa função, a Amazon GameLift espera 60 segundos por uma resposta e, se nenhuma for recebida, registra o processo do servidor como não íntegro.
Tipo:
bool OnHealthCheckDelegate()
Obrigatório: Sim
- onUpdateGameSessão
-
Nome da função de retorno de chamada que o GameLift serviço da Amazon invoca para passar um objeto de sessão de jogo atualizado para o processo do servidor. A Amazon GameLift chama essa função quando uma solicitação de preenchimento de correspondência é processada para fornecer dados atualizados do matchmaker. Ele passa um GameSessionobjeto, uma atualização de status (
updateReason
) e o ID do tíquete de preenchimento correspondente.Tipo:
void OnUpdateGameSessionDelegate ( UpdateGameSession updateGameSession )
Obrigatório: Não
StartMatchBackfillRequest
Esse tipo de dados é usado para enviar uma solicitação de alocação de marcação de jogos. As informações são comunicadas ao GameLift serviço da Amazon em uma StartMatchBackfill() chamada.
Conteúdo
- GameSessionArn
-
Identificador da sessão de jogo exclusivo. O SDK método GetGameSessionId() retorna o identificador em ARN formato.
Tipo: string
Obrigatório: Sim
- MatchmakingConfigurationArn
-
Identificador único, na forma de umARN, para o matchmaker usar para esta solicitação. Para encontrar o marcador de jogos usado para criar a sessão de jogo original, procure no objeto de sessão do jogo, na propriedade de dados do marcador de jogos. Saiba mais sobre os dados de marcador de jogos em Trabalhar com dados do marcador de jogos.
Tipo: sequência
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. Consulte o Guia de GameLift API referência da Amazon para obter uma descrição do formato do objeto Player. Para encontrar os atributos do jogador e as atribuições da equipe, procure no objeto da sessão do jogo, na propriedade de dados do matchmaker. IDs Se o marcador de jogos usa latência, obtenha a latência atualizada para a região atual e a inclua nos dados de cada jogador.
Tipo: 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 nenhum valor for fornecido aqui, a Amazon GameLift gerará um na forma deUUID. Use esse identificador para acompanhar o status do tíquete de alocação de correspondência ou cancelar a solicitação, se necessário.
Tipo: string
Obrigatório: Não
StopMatchBackfillRequest
Esse tipo de dados é usado para cancelar uma solicitação de alocação de marcação de jogo. As informações são comunicadas ao GameLift serviço da Amazon em uma StopMatchBackfill() chamada.
Conteúdo
- GameSessionArn
-
O identificador de sessão de jogo exclusivo associado à solicitação que está sendo cancelada.
Tipo: sequência
Obrigatório: Sim
- MatchmakingConfigurationArn
-
O identificador exclusivo do marcador de jogos para o qual essa solicitação foi enviada.
Tipo: sequência
Obrigatório: Sim
- TicketId
-
O identificador exclusivo do tíquete de solicitação de alocação a ser cancelado.
Tipo: sequência
Obrigatório: Sim