Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Referencia del cliente Realtime Servers API (C#): Acciones

Esta API referencia de C# Realtime Client puede ayudarlo a preparar su juego multijugador para usarlo con los servidores Realtime implementados en las flotas de Amazon. GameLift

Client()

Inicializa un nuevo cliente para comunicarse con el servidor Realtime e identifica el tipo de conexión que se va a utilizar.

Sintaxis

public Client(ClientConfiguration configuration)

Parámetros

Valor devuelto

Devuelve una instancia del cliente de Realtime para comunicarse con el servidor Realtime.

Connect()

Solicita una conexión a un proceso del servidor que aloja una sesión de juego.

Sintaxis

public ConnectionStatus Connect(string endpoint, int remoteTcpPort, int listenPort, ConnectionToken token)

Parámetros

Valor devuelto

Devuelve un valor de ConnectionStatusenumeración que indica el estado de la conexión del cliente.

Disconnect()

Cuando se está conectado a una sesión del juego, desconecta el cliente del juego de la sesión del juego.

Sintaxis

public void Disconnect()

Parámetros

Esta acción no tiene parámetros.

Valor devuelto

Este método no devuelve nada.

NewMessage()

Crea un nuevo objeto de mensaje con un código de operación especificado. Tras devolver un objeto de mensaje, complete el contenido del mensaje especificando un objetivo, actualizando el método de entrega y añadiendo una carga de datos según sea necesario. Tras completar este proceso, envíe el mensaje con SendMessage().

Sintaxis

public RTMessage NewMessage(int opCode)

Parámetros

Valor devuelto

Devuelve un objeto RTMessage que contiene el código de operación especificado y el método de entrega predeterminado. El parámetro de intento de entrega está configurado como FAST de forma predeterminada.

SendMessage()

Envía un mensaje a un jugador o grupo mediante el método de entrega especificado.

Sintaxis

public void SendMessage(RTMessage message)

Parámetros

Valor devuelto

Este método no devuelve nada.

JoinGroup()

Añade el jugador a la pertenencia a un grupo especificado. Los grupos pueden contener a cualquiera de los jugadores conectados al juego. Tras unirse, el jugador recibe todos los mensajes futuros enviados al grupo y puede enviar los mensajes a la totalidad del grupo.

Sintaxis

public void JoinGroup(int targetGroup)

Parámetros

Valor devuelto

Este método no devuelve nada. Como esta solicitud se envía mediante el método de entrega reliable (TCP), una solicitud fallida desencadena la devolución de llamada. OnError()

LeaveGroup()

Elimina al jugador de la pertenencia a un grupo especificado. Cuando ya no esté en el grupo, el jugador no recibe los mensajes enviados al grupo y no puede enviar mensajes a todo el grupo.

Sintaxis

public void LeaveGroup(int targetGroup)

Parámetros

Valor devuelto

Este método no devuelve nada. Como esta solicitud se envía mediante el método de entrega reliable (TCP), una solicitud fallida desencadena la devolución de llamada. OnError()

RequestGroupMembership()

Solicita que se envíe una lista de los jugadores en el grupo especificado al cliente del juego. Cualquier jugador puede solicitar esta información, independientemente de si son miembros del grupo o no. En respuesta a esta solicitud, la lista de miembros se envía al cliente a través de una devolución de llamada OnGroupMembershipUpdated().

Sintaxis

public void RequestGroupMembership(int targetGroup)

Parámetros

Valor devuelto

Este método no devuelve nada.