Referencia GameLift del SDK (C#) del servidor de Amazon: tipos de datos

Puedes usar esta referencia del SDK del servidor GameLift C# de Amazon como ayuda para preparar tu juego multijugador para usarlo con Amazon GameLift. Para obtener detalles sobre el proceso de integración, consulteAñade Amazon GameLift a tu servidor de juegos.

• Acciones

• Tipos de datos

LogParameters

Este tipo de datos se utiliza para identificar qué archivos generados durante una sesión de juego quieres que Amazon GameLift cargue y almacene una vez que finalice la sesión de juego. Esta información se comunica al GameLift servicio de Amazon en unaProcessReady() llamada.

Contenido

logPaths

Lista de rutas de directorio a los archivos de registro del servidor de juegos que quieres que Amazon almacene GameLift para acceder a ellos en el future. Estos archivos los genera un proceso del servidor durante cada sesión de juego; las rutas de archivo y los nombres se definen en el servidor de juegos y se almacenan en el directorio raíz de compilación de juegos. Las rutas de registro deben ser absolutas. Por ejemplo, si la compilación del juego almacena los logs de sesión de juego en una ruta del tipo MyGame\sessionlogs\, entonces la ruta de los logs sería c:\game\MyGame\sessionLogs (en una instancia Windows) o /local/game/MyGame/sessionLogs (en una instancia Linux).

Tipo: Lista<String>

Obligatorio: no

DescribePlayerSessionsRequest

Este tipo de datos se utiliza para especificar qué sesión o sesiones de jugador recuperar. Se puede usar de varias maneras: (1) proporciona una PlayerSessionId para solicitar una sesión de jugador específica; (2) proporciona una GameSessionId para solicitar todas las sesiones de jugador de la sesión de juego especificada; o (3) proporciona una PlayerId para solicitar todas las sesiones de jugador para el jugador especificado. Para grandes recopilaciones de sesiones de jugador, utilice los parámetros de paginación para recuperar resultados como páginas secuenciales.

Contenido

GameSessionId

Identificador único de la sesión de juego. Use este parámetro para solicitar todas las sesiones de jugador de la sesión de juego especificada. El formato de ID de la sesión de juego es el siguiente: arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. El valor de la <ID string> es una cadena de ID personalizada (si se especificó una cuando se creó la sesión de juego) o una cadena generada.

Tipo: String

Requerido: No

Límite

Número máximo de resultados a devolver. Utilice este parámetro con NextTokenpara obtener los resultados como un conjunto de páginas secuenciales. Si se especifica un ID de sesión de jugador, este parámetro se ignora.

Tipo: entero

Obligatorio: no

NextToken

Token que indica el inicio de la siguiente página de resultados secuencial. Utilice el token devuelto con una llamada anterior a esta acción. Para especificar el inicio del conjunto de resultados, no indique ningún valor. Si se especifica un ID de sesión de jugador, este parámetro se ignora.

Tipo: String

Requerido: No

PlayerId

Identificador único de un jugador. Los ID de jugador los define el desarrollador. Consulte GenS S S S S S.

Tipo: String

Requerido: No

PlayerSessionId

Identificador único de una sesión de jugador.

Tipo: String

Requerido: No

PlayerSessionStatusFilter

Estado de la sesión de juego para filtrar los resultados. Los posibles estados de sesión de jugador son:

• RESERVED: se ha recibido la solicitud de sesión de jugador, pero el jugador aún no se ha conectado al proceso del servidor o aún no se ha validado.

• ACTIVE: el proceso del servidor ha validado el jugador y actualmente está conectado.

• COMPLETED: ha caído la conexión del jugador.

• TIMEDOUT: se ha recibido una solicitud de sesión de jugador, pero el jugador no se ha conectado y/o no se ha validado en el plazo de tiempo de espera (60 segundos).

Tipo: String

Requerido: No

ProcessParameters

Este tipo de datos contiene el conjunto de parámetros enviados al GameLift servicio de Amazon en unaProcessReady() llamada.

Contenido

puerto

Es el número de puerto al que escucha el proceso del servidor para conexiones de jugador nuevas. El valor debe estar en el rango de puertos configurado para cualquier flota que implemente esa compilación de servidor de juegos. Este número de puerto se incluye en los objetos de sesión de juego y de jugador, que las sesiones de juego utilizan a la hora de conectarse a un proceso del servidor.

Tipo: entero

Obligatorio: sí

logParameters

Objeto con una lista de rutas de directorio a archivos de log de la sesión de juego.

Escriba: Aws::GameLift::Server::LogParameters

Obligatorio: sí

onStartGameSesión

Nombre de la función de devolución de llamada que el GameLift servicio de Amazon invoca para activar una nueva sesión de juego. Amazon GameLift llama a esta función en respuesta a la solicitud del cliente CreateGameSession. La función de devolución de llamada toma un GameSessionobjeto (definido en la referencia de la API GameLift de Amazon Service).

Escriba: void OnStartGameSessionDelegate(GameSession gameSession)

Obligatorio: sí

onProcessTerminate

Nombre de la función de devolución de llamada que el GameLift servicio de Amazon invoca para forzar el cierre del proceso del servidor. Tras activar esta función, Amazon GameLift espera cinco minutos a que se cierre el proceso del servidor y responde con unaProcessEnding() llamada antes de cerrar el proceso del servidor.

Escriba: void OnProcessTerminateDelegate()

Obligatorio: sí

onHealthCheck

Nombre de la función de devolución de llamada que el GameLift servicio de Amazon invoca para solicitar un informe de estado del proceso del servidor. Amazon GameLift llama a esta función cada 60 segundos. Tras llamar a esta función, Amazon GameLift espera 60 segundos para recibir una respuesta y, si no se recibe ninguna, registra el proceso del servidor como no saludable.

Escriba: bool OnHealthCheckDelegate()

Obligatorio: sí

onUpdateGameSesión

Nombre de la función de devolución de llamada que el GameLift servicio de Amazon invoca para pasar un objeto de sesión de juego actualizado al proceso del servidor. Amazon GameLift llama a esta función cuando se ha procesado una solicitud de relleno de coincidencias para proporcionar datos de emparejamiento actualizados. Pasa un GameSessionobjeto, una actualización de estado (updateReason) y el ID del ticket de relleno de coincidencia.

Escriba: void OnUpdateGameSessionDelegate ( UpdateGameSession updateGameSession )

Obligatorio: no

StartMatchBackfillRequest

Este tipo de datos se utiliza para enviar una solicitud de reposición de emparejamiento. La información se comunica al GameLift servicio de Amazon en unaStartMatchBackfill() llamada.

Contenido

GameSessionArn

Identificador único de la sesión de juego. El método SDKGetGameSessionId() devuelve el identificador en formato ARN.

Tipo: String

Obligatorio: sí

MatchmakingConfigurationArn

Identificador único, en forma de un ARN, que el creador de emparejamientos utiliza para esta solicitud. Para encontrar el creador de emparejamientos que se usó para crear la sesión de juego original, busque en el objeto de sesión de juego, en la propiedad de datos del creador de emparejamientos. Obtén más información sobre los datos de Matchmaker en Trabaja con datos de Matchmaker.

Tipo: String

Obligatorio: sí

Players

Un conjunto de datos que representa a todos los jugadores que están actualmente en la sesión de juego. El creador de emparejamientos utiliza esta información para buscar nuevos jugadores que son idóneos para los jugadores actuales. Consulte la Guía de referencia GameLift de la API de Amazon para obtener una descripción del formato de objetos del reproductor. Para encontrar los atributos, ID y asignaciones de equipo del jugador, busque en el objeto de sesión de juego, en la propiedad de datos del creador de emparejamientos. Si el creador de emparejamientos utiliza latencia, recopile la latencia actualizada para la región actual e inclúyala en los datos de cada jugador.

Tipo: Player[ ]

Obligatorio: sí

TicketId

Identificador único para un ticket de solicitud de emparejamiento o reposición de emparejamiento. Si no se proporciona ningún valor aquí, Amazon GameLift generará uno en forma de UUID. Use este identificador para realizar un seguimiento del estado del ticket de reposición de emparejamiento o cancelar la solicitud si es necesario.

Tipo: String

Requerido: No

StopMatchBackfillRequest

Este tipo de datos se utiliza para cancelar una solicitud de reposición de emparejamiento. La información se comunica al GameLift servicio de Amazon en unaStopMatchBackfill() llamada.

Contenido

GameSessionArn

Identificador único de sesión de juego asociado a la solicitud que se va a cancelar.

Tipo: String

Obligatorio: sí

MatchmakingConfigurationArn

Identificador único del creador de emparejamientos al que se envió esta solicitud.

Tipo: String

Obligatorio: sí

TicketId

Identificador único del ticket de solicitud de reposición que se va a cancelar.

Tipo: String

Obligatorio: sí