Amazon GameLift ServersRealtimereferência da API do cliente (C#): retornos de chamada assíncronos - Amazon GameLift Servers

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

Amazon GameLift ServersRealtimereferência da API do cliente (C#): retornos de chamada assíncronos

Use essa referência da API Realtime do cliente C# para ajudá-lo a preparar seu jogo multijogador para uso em Amazon GameLift Servers Realtime Amazon GameLift Servers frotas.

Um cliente de jogo precisa implementar esses métodos de retorno de chamada para responder a eventos. O servidor Realtime chama esses retornos de chamada para enviar informações relacionadas ao jogo para o cliente do jogo. Retornos de chamada dos mesmos eventos também podem ser implementados com a lógica de jogos personalizada no script de servidor Realtime. Consulte Retornos de chamada de script para Amazon GameLift ServersRealtime.

Os métodos de retorno de chamada são definidos em ClientEvents.cs.

OnOpen()

Chamado quando o processo do servidor aceita a solicitação de conexão do cliente do jogo e abre uma conexão.

Sintaxe

public void OnOpen()

Parâmetros

Esse método não aceita parâmetros.

Valor de retorno

Esse método não retorna nada.

OnClose()

Chamado quando o processo do servidor encerra a conexão com o cliente do jogo, como após uma sessão do jogo.

Sintaxe

public void OnClose()

Parâmetros

Esse método não aceita parâmetros.

Valor de retorno

Esse método não retorna nada.

OnError()

Chamado quando ocorre uma falha para uma solicitação de API do cliente em tempo real. Esse retorno de chamada pode ser personalizado para lidar com uma variedade de erros de conexão.

Sintaxe

private void OnError(byte[] args)

Parâmetros

Esse método não aceita parâmetros.

Valor de retorno

Esse método não retorna nada.

OnDataReceived()

Chamado quando o cliente do jogo recebe uma mensagem do servidor Realtime. Este é o método principal pelo qual as mensagens e as notificações são recebidas por um cliente do jogo.

Sintaxe

public void OnDataReceived(DataReceivedEventArgs dataReceivedEventArgs)

Parâmetros

dataReceivedEventArgs

Informações relacionadas à atividade de mensagem.

Tipo: DataReceivedEventArgs

Obrigatório: sim

Valor de retorno

Esse método não retorna nada.

OnGroupMembershipUpdated()

Chamado quando a associação de um grupo ao qual o jogador pertence foi atualizada. Esse retorno de chamada também é invocado quando um cliente chama RequestGroupMembership.

Sintaxe

public void OnGroupMembershipUpdated(GroupMembershipEventArgs groupMembershipEventArgs)

Parâmetros

groupMembershipEventArgs

Informações relacionadas à atividade de associação do grupo.

Tipo: GroupMembershipEventArgs

Obrigatório: sim

Valor de retorno

Esse método não retorna nada.