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.

FLogParameters

Un objeto que identifica los archivos generados durante una sesión de juego que quieres que Amazon GameLift cargue y almacene una vez finalizada la sesión de juego. El servidor del juego proporcionaLogParameters a Amazon GameLift como parte de unProcessParameters objeto de unaProcessReady() llamada.

Properties

Descripción

LogPaths

La 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. El proceso del servidor genera estos archivos durante cada sesión de juego. Define las rutas y los nombres de los archivos en el servidor del juego y los almacena en el directorio raíz de compilación del juego. Las rutas de registro deben ser absolutas. Por ejemplo, si la compilación del juego almacena los registros de sesión del juego en una ruta comoMyGame\sessionLogs\, entonces la ruta estaríac:\game\MyGame\sessionLogs en una instancia de Windows. Tipo: std:vector<std::string> Obligatorio: no

FProcessParameters

Este tipo de datos contiene el conjunto de parámetros enviados a Amazon GameLift en unProcessReady().

Properties	Descripción
LogParameters	Un objeto con rutas de directorio a los archivos que se generan durante una sesión de juego. Amazon GameLift copia y almacena los archivos para acceder a ellos en el future. Tipo: Aws::GameLift::Server::FLogParameters Obligatorio: no
OnHealthCheck	La función de devolución de llamada que Amazon GameLift invoca para solicitar un informe de estado del servidor. Amazon GameLift llama a esta función cada 60 segundos y espera 60 segundos para recibir una respuesta. El proceso del servidor regresaTRUE si está en buen estado,FALSE si no está en buen estado. Si no se devuelve ninguna respuesta, Amazon GameLift registra el proceso del servidor como no en buen estado. Tipo: std::function<bool()> onHealthCheck Obligatorio: no
OnProcessTerminate	La función de devolución de llamada que Amazon GameLift invoca para forzar el cierre del proceso del servidor. Tras activar esta función, Amazon GameLift espera 5 minutos a que se cierre el proceso del servidor y responde con unaProcessEnding() llamada antes de cerrar el proceso del servidor. Tipo: std::function<void()> onProcessTerminate Obligatorio: sí
OnRefreshConnection	El nombre de la función de devolución de llamada que Amazon GameLift invoca para actualizar la conexión con el servidor del juego. Tipo: void OnRefreshConnectionDelegate() Obligatorio: sí
OnStartGameSession	La función de devolución de llamada que Amazon GameLift invoca para activar una nueva sesión de juego. Amazon GameLift llama a esta función en respuesta a una solicitud de un cliente CreateGameSession. La función de devolución de llamada pasa un GameSessionobjeto, tal como se define en la referencia de la GameLift API de Amazon. Tipo: const std::function<void(Aws::GameLift::Model::GameSession)> onStartGameSession Obligatorio: sí
OnUpdateGameSession	La función de devolución de llamada que Amazon GameLift 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. Tipo: std::function<void(Aws::GameLift::Server::Model::UpdateGameSession)> onUpdateGameSession Obligatorio: no
Port	El número de puerto que el servidor procesa para detectar nuevas conexiones de jugadores. 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: Integer Obligatorio: sí

FUpdateGameSession

Este tipo de datos se actualiza a un objeto de sesión de juego, que incluye el motivo por el que se actualizó la sesión de juego y el ID del ticket de relleno correspondiente si el relleno se utiliza para rellenar las sesiones de los jugadores en la sesión de juego.

Propiedades	Descripción
GameSession	GameSessionObjeto definido por la GameLift API de Amazon. ElGameSession objeto contiene propiedades que describen una sesión de juego. Tipo: Aws::GameLift::Server::GameSession Obligatorio: sí
UpdateReason	El motivo por el que se actualiza la sesión del juego. Tipo: Aws::GameLift::Server::UpdateReason Obligatorio: sí
BackfillTicketId	El identificador del ticket de recarga que intenta actualizar la sesión de juego. Tipo: std::string Obligatorio: no

FGameSession

Este tipo de datos proporciona detalles de una sesión de juego.

Propiedades	Descripción
GameSessionId	Un identificador único de una sesión de juego. El ARN de una sesión de juego tiene el siguiente formato:arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>. Tipo: std::string Obligatorio: no
Nombre	Una etiqueta descriptiva de la sesión de juego. Tipo: std::string Obligatorio: no
FleetId	Un identificador único para la flota en la que tiene lugar la sesión de juego. Tipo: std::string Obligatorio: no
MaximumPlayerSessionCount	El número máximo de conexiones de jugadores a la sesión de juego. Tipo: int Obligatorio: no
Port	El número de puerto de la sesión de juego. Para conectarse a un servidor de GameLift juegos de Amazon, la aplicación necesita tanto la dirección IP como el número de puerto. Tipo: in Obligatorio: no
IpAddress	La dirección IP de la sesión de juego. Para conectarse a un servidor de GameLift juegos de Amazon, la aplicación necesita tanto la dirección IP como el número de puerto. Tipo: std::string Obligatorio: no
GameSessionData	Un conjunto de propiedades de sesión de juego personalizadas, formateadas como un valor de una sola cadena. Tipo: std::string Obligatorio: no
MatchmakerData	Información sobre el proceso de emparejamiento que se utilizó para crear la sesión de juego, en sintaxis JSON, con formato de cadena. Además de la configuración de emparejamiento utilizada, contiene datos sobre todos los jugadores asignados a la partida, incluidos los atributos de los jugadores y las asignaciones de equipo. Tipo: std::string Obligatorio: no
GameProperties	Un conjunto de propiedades personalizadas de una sesión de juego, formateadas como pares de clave-valor. Estas propiedades se pasan junto con una solicitud de iniciar una nueva sesión de juego. Tipo: std :: vector < GameProperty > Obligatorio: no
DnsName	El identificador DNS asignado a la instancia que ejecuta la sesión del juego. Los valores tienen el siguiente formato: Flotas compatibles con TLS:<unique identifier>.<region identifier>.amazongamelift.com. Flotas no compatibles con TLS:ec2-<unique identifier>.compute.amazonaws.com. Cuando te conectes a una sesión de juego que se ejecute en una flota habilitada para TLS, debes usar el nombre DNS, no la dirección IP. Tipo: std::string Obligatorio: no

FServerParameters

Objeto que contiene información sobre un GameLift Anywhere servidor de Amazon. El servidor comunica esta información al GameLift servicio de Amazon al iniciar un nuevo proceso de servidor conInitSDK(). Este parámetro no se usa con los servicios alojados en instancias de EC2 GameLift gestionadas por Amazon.

Propiedades	Descripción
webSocketUrl	GameLiftServerSdkEndpointAmazon GameLift regresa cuando RegisterComputebusca un recurso de GameLift Anywhere cómputo de Amazon. Tipo: std::string Obligatorio: sí
ID de proceso	Un identificador único registrado en el proceso del servidor que aloja tu juego. Tipo: std::string Obligatorio: sí
hostId	ElHostID es el queComputeName se usó cuando registró su computadora. Para obtener más información, consulte RegisterCompute. Tipo: std::string Obligatorio: sí
ID de flota	El identificador único de la flota en la que está registrado el cálculo. Para obtener más información, consulte RegisterCompute. Tipo: std::string Obligatorio: sí
Token de autenticación	El token de autenticación generado por Amazon GameLift que autentica tu servidor en Amazon GameLift. Para obtener más información, consulte GetComputeAuthToken. Tipo: std::string Obligatorio: sí

FStartMatchBackfillRequest

Este tipo de datos cancela una solicitud de relleno de matchmaking. El servidor del juego comunica esta información a Amazon GameLift en unaStopMatchBackfill() llamada.

Propiedades	Descripción
GameSessionArn	Identificador de sesión de juego único. La operación de APIGetGameSessionId devuelve el identificador en formato ARN. Tipo: std::string Obligatorio: sí
MatchmakingConfigurationArn	Un identificador único, en forma de ARN, para que el emparejador lo utilice en esta solicitud. El ARN del emparejador de la sesión de juego original se encuentra en el objeto de sesión de juego de la propiedad de datos del emparejador. Obtén más información sobre los datos de Matchmaker en Trabaja con datos de Matchmaker. Tipo: std::string Obligatorio: sí
Players	Conjunto de datos que representa a todos los jugadores que están 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. Tipo: std::vector<Player> Obligatorio: sí
TicketId	Un identificador único para un ticket de emparejamiento o solicitud de reposición de emparejamiento. Si no proporcionas un valor, Amazon lo GameLift generará. Use este identificador para realizar un seguimiento del estado del ticket de reposición de emparejamiento o cancelar la solicitud si es necesario. Tipo: std::string Obligatorio: no

FPlayer

Este tipo de datos representa a un jugador en el matchmaking. Al iniciar una solicitud de emparejamiento, un jugador tiene un identificador de jugador, atributos y, posiblemente, datos de latencia. Amazon GameLift añade la información del equipo después de que se haya realizado una partida.

Propiedades	Descripción
LatencyInSRA.	Conjunto de valores expresados en milisegundos que indican la cantidad de latencia que experimenta un jugador cuando se conecta a una ubicación. Si se utiliza esta propiedad, el jugador solo será emparejado con las ubicaciones de la lista. Si un creador de emparejamientos tiene una regla que evalúa la latencia de los jugadores, estos deben informar de la latencia para ser emparejados. Tipo: Dictionary<string,int> Obligatorio: no
PlayerAttributes	Una colección de pares de clave-valor que contiene información del jugador para su uso en emparejamiento. Las claves de atributos del jugador deben coincidir con las PlayerAttributes utilizadas en un conjunto de reglas de emparejamiento. Para obtener más información acerca de los atributos de jugador, consulte AttributeValue. Tipo: std::map<std::string,AttributeValue> Obligatorio: no
PlayerId	Un identificador único para un jugador. Tipo: std::string Obligatorio: no
Equipo	El nombre del equipo al que está asignado el jugador en una partida. El nombre de equipo se define en el conjunto de reglas de emparejamiento. Tipo: std::string Obligatorio: no

FDescribePlayerSessionsRequest

Objeto que especifica qué sesiones del jugador se van a recuperar. El proceso del servidor proporciona esta información mediante unaDescribePlayerSessions() llamada a Amazon GameLift.

Propiedades	Descripción
GameSessionId	Identificador de sesión de juego único. Use este parámetro para solicitar todas las sesiones de jugador de la sesión de juego especificada. El formato de ID de sesión del juego esarn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. GameSessionIDEs una cadena de identificación personalizada o un Tipo: std::string Obligatorio: no
PlayerSessionId	El identificador único de una sesión de jugador. Usa este parámetro para solicitar una única sesión de jugador específica. Tipo: std::string Obligatorio: no
PlayerId	El identificador único para un jugador. Usa este parámetro para solicitar todas las sesiones de un jugador específico. Consulte GenS S S S S S. Tipo: std::string Obligatorio: no
PlayerSessionStatusFilter	El estado de la sesión del jugador para filtrar los resultados. Los posibles estados de la sesión del jugador incluyen: RESERVADO: se recibió la solicitud de sesión del jugador, pero el jugador no se ha conectado al proceso del servidor ni se ha validado. ACTIVO: el proceso del servidor validó el reproductor y está conectado. COMPLETADO: se ha interrumpido la conexión del jugador. TIEMPO DE ESPERA: se recibió una solicitud de sesión de un jugador, pero el jugador no se conectó o no se validó dentro del límite de tiempo de espera (60 segundos). Tipo: std::string Obligatorio: no
NextToken	El token que indica el inicio de la siguiente página de resultados. Para especificar el inicio del conjunto de resultados, no proporcione ningún valor. Si proporciona un ID de sesión de jugador, este parámetro se ignora. Tipo: std::string Obligatorio: no
Límite	El número máximo de resultados que devolver. Si proporciona un ID de sesión de jugador, este parámetro se ignora. Tipo: int Obligatorio: no

FStopMatchBackfillRequest

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.

Propiedades	Descripción
GameSessionArn	Un identificador de sesión de juego único de la solicitud que se cancela. Tipo: char[] Obligatorio: no
MatchmakingConfigurationArn	Un identificador único del emparejador al que se ha enviado esta solicitud. Tipo: char[] Obligatorio: no
TicketId	Un identificador único para el ticket de solicitud de reposición que se va a cancelar. Tipo: char[] Obligatorio: no

FGetCustomerRoleCredentialsRequest

Este tipo de datos proporciona credenciales de rol que amplían el acceso limitado a tusAWS recursos al servidor del juego. Para obtener más información, consulte Configure un rol de servicio de IAM para Amazon GameLift.

Propiedades	Descripción
RoleArn	El Nombre de recurso de Amazon (ARN) del rol de servicio que ofrece acceso limitado a susAWS recursos. Tipo: char[] Obligatorio: no
RoleSessionName	El nombre de la sesión que describe el uso de las credenciales del rol. Tipo: char[] Obligatorio: no