Referência da API (C#) do cliente dos servidores em tempo real: retornos de chamada assíncronos

Use essa referência de API C# do cliente em tempo real para ajudar a preparar o jogo multijogador a ser usado com os servidores em tempo real implantados em frotas do Amazon GameLift.

Um cliente de jogo precisa implementar esses métodos de retorno de chamada para responder a eventos. O servidor em tempo real 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 em tempo real. Consulte Retornos de chamada de script para servidores em tempo real.

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 em tempo real. 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

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

Valor de retorno

Esse método não retorna nada.