Amazon GameLift ServersRealtimereferência da API do cliente (C#): tipos de dados

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

• Ações síncronas

• Retornos de chamada assíncronos

• Tipos de dados

ClientConfiguration

Informações sobre como o cliente do jogo se conecta a um servidor Realtime.

Conteúdo

ConnectionType

Tipo de client/server conexão a ser usada, segura ou não segura. Se você não especificar um tipo de conexão, o padrão será desprotegido.

nota

Ao se conectar a um servidor em tempo real em uma frota protegida com um certificado TLS, você deve usar o valor RT_OVER_WSS_DTLS_. TLS12

Tipo: um valor ConnectionType enum.

Obrigatório: Não

ConnectionToken

Informações sobre o and/or jogador cliente do jogo que está solicitando uma conexão com um Realtime servidor.

Conteúdo

playerSessionId

ID exclusivo emitido Amazon GameLift Servers quando uma nova sessão de jogador é criada. O ID da sessão do jogador é especificado em um PlayerSession objeto, que é retornado em resposta a uma chamada do cliente para as ações da GameLift API StartGameSessionPlacement CreateGameSession,, DescribeGameSessionPlacement, ou DescribePlayerSessions.

Tipo: string

Obrigatório: Sim

payload

Informações definidas pelo desenvolvedor a serem comunicadas ao servidor Realtime na conexão. Isso inclui quaisquer dados arbitrários que possam ser usados para um mecanismo de login personalizado. Para obter exemplos, uma carga útil pode fornecer informações de autenticação a serem processadas pelo script do servidor Realtime antes de permitir que um cliente se conecte.

Tipo: matriz de bytes

Obrigatório: Não

RTMessage

Conteúdo e informações de entrega de uma mensagem. Uma mensagem deve especificar um jogador ou um grupo de destino.

Conteúdo

opCode

Código de operação definido pelo desenvolvedor que identifica um evento de jogo ou ação, como uma movimentação do jogador ou uma notificação do servidor. O código de operação de uma mensagem fornece o contexto para a carga útil de dados que está sendo fornecida. As mensagens criadas usando NewMessage () já têm o código de operação definido, mas ele pode ser alterado a qualquer momento.

Tipo: inteiro

Obrigatório: Sim

targetPlayer

ID exclusivo que identifica o jogador que é o destinatário pretendido da mensagem que está sendo enviada. O destino pode ser o próprio servidor (usando o ID do servidor) ou outro jogador (usando um ID do jogador).

Tipo: inteiro

Obrigatório: não

targetGroup

ID exclusivo que identifica o grupo que é o destinatário pretendido da mensagem que está sendo enviada. IDs Os grupos são definidos pelo desenvolvedor.

Tipo: inteiro

Obrigatório: não

deliveryIntent

Indica se a mensagem deve ser enviada usando a conexão TCP confiável ou o canal UDP rápido. Mensagens criadas usando NewMessage().

Tipo: DeliveryIntent enum

Valores válidos: FAST | RELIABLE

Obrigatório: Sim

payload

Conteúdo da mensagem. Essas informações são estruturadas conforme necessário para serem processadas pelo cliente do jogo com base no código de operação fornecido. Pode conter dados de estado do jogo ou outras informações que precisem ser transmitidas entre os clientes de jogos ou entre um cliente de jogo e o servidor em tempo real.

Tipo: matriz de bytes

Obrigatório: Não

DataReceivedEventArgs

Os dados fornecidos com um retorno de chamada OnDataReceived().

Conteúdo

sender (remetente)

ID exclusivo que identifica a entidade (ID do jogador ou ID do servidor) que originou a mensagem.

Tipo: inteiro

Obrigatório: Sim

opCode

Código de operação definido pelo desenvolvedor que identifica um evento de jogo ou ação, como uma movimentação do jogador ou uma notificação do servidor. O código de operação de uma mensagem fornece o contexto para a carga útil de dados que está sendo fornecida.

Tipo: inteiro

Obrigatório: Sim

dados

Conteúdo da mensagem. Essas informações são estruturadas conforme necessário para serem processadas pelo cliente do jogo com base no código de operação fornecido. Pode conter dados de estado do jogo ou outras informações que precisem ser transmitidas entre os clientes de jogos ou entre um cliente de jogo e o servidor em tempo real.

Tipo: matriz de bytes

Obrigatório: Não

GroupMembershipEventArgs

Os dados fornecidos com um retorno de chamada OnGroupMembershipUpdated().

Conteúdo

sender (remetente)

ID exclusivo que identifica o jogador que solicitou uma atualização da associação do grupo.

Tipo: inteiro

Obrigatório: Sim

opCode

Código de operação definido pelo desenvolvedor que identifica um evento ou uma ação de jogo.

Tipo: inteiro

Obrigatório: Sim

groupId

ID exclusivo que identifica o grupo que é o destinatário pretendido da mensagem que está sendo enviada. IDs Os grupos são definidos pelo desenvolvedor.

Tipo: inteiro

Obrigatório: Sim

playerId

Lista de jogadores IDs que são membros atuais do grupo especificado.

Tipo: matriz de inteiros

Obrigatório: Sim

Enumerações

Os enums definidos para o SDK do cliente Amazon GameLift Servers Realtime são definidos da seguinte forma:

ConnectionStatus

• CONECTADO — O cliente do jogo está conectado ao Realtime servidor somente com uma conexão TCP. Todas as mensagens, independentemente da intenção de entrega, são enviadas via TCP.

• CONNECTED_SEND_FAST — O cliente do jogo está conectado ao Realtime servidor com uma conexão TCP e uma conexão UDP. No entanto, a capacidade de receber mensagens por meio de UDP ainda não é verificada; como resultado, todas as mensagens enviadas para o cliente do jogo usam TCP.

• CONNECTED_SEND_AND_RECEIVE_FAST — O cliente do jogo está conectado ao servidor com uma conexão TCP e uma conexão UDP. Realtime O cliente do jogo pode enviar e receber mensagens usando TCP ou UDP.

• CONNECTING O cliente do jogo enviou uma solicitação de conexão e o servidor Realtime a está processando.

• DISCONNECTED_CLIENT_CALL — O cliente do jogo foi desconectado do Realtime servidor em resposta a uma solicitação do cliente do jogo. Disconnect()

• DESCONECTADO — O cliente do jogo foi desconectado do Realtime servidor por um motivo diferente de uma chamada de desconexão do cliente.

ConnectionType

• TLS12 RT_OVER_WSS_DTLS_ — Tipo de conexão segura.

  Para uso com servidores em tempo real que estão sendo executados em uma Amazon GameLift Servers frota com um certificado TLS gerado. Ao usar uma conexão segura, o tráfego TCP é criptografado usando TLS 1.2 e o tráfego UDP é criptografado usando DTLS 1.2.

• RT_OVER_WS_UDP_UNSECURED: tipo de conexão não segura.

• RT_OVER_WEBSOCKET: tipo de conexão não segura. Esse valor não é mais preferível.

DeliveryIntent

• FAST: entregue usando um canal UDP.

• RELIABLE: entregue usando uma conexão TCP.