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.
-
Retornos de chamada assíncronos
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.