Referencia de la API de cliente de Servidores en tiempo real (C#): Acciones

Esta referencia de la API de cliente de tiempo real de C# puede ayudarle a preparar el juego multijugador para utilizarlo con Servidores en tiempo real implementados en 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 enum ConnectionStatus que indica el estado de 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. Dado que esta solicitud se envía mediante el método de entrega de confianza (TCP), las solicitudes erróneas activan 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. Dado que esta solicitud se envía mediante el método de entrega de confianza (TCP), las solicitudes erróneas activan 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.