SDK del servidor (Unreal) para Amazon GameLift Servers: tipos de datos
Utilice la referencia del SDK del servidor de Amazon GameLift Servers para Unreal como ayuda para integrar su juego multijugador para el alojamiento con Amazon GameLift Servers. Para obtener ayuda con el proceso de integración, consulte Adición de Amazon GameLift Servers al servidor de juegos con el SDK del servidor.
nota
Esta referencia es para una versión anterior del SDK del servidor de Amazon GameLift Servers. Para obtener la última versión, consulte SDK del servidor de C++ (Unreal) 5.x para Amazon GameLift Servers: tipos de datos.
Esta API se define en GameLiftServerSDK.h y GameLiftServerSDKModels.h.
Para configurar el complemento Unreal Engine y ver ejemplos de código, consulte Integración de Amazon GameLift Servers en un proyecto de Unreal Engine.
SDK del servidor (Unreal) para Amazon GameLift Servers: acciones
Temas
FDescribePlayerSessionsRequest
Este tipo de datos se utiliza para especificar qué sesión o sesiones de jugador recuperar. Puede utilizarlo para las siguientes tareas:
-
Proporcionar un PlayerSessionId para solicitar una sesión de jugador específica.
-
Proporcionar un GameSessionId para solicitar todas las sesiones de jugador de la sesión de juego especificada.
-
Proporcionar un PlayerId para solicitar todas las sesiones de jugador del jugador especificado.
Para grandes conjuntos de sesiones de jugador, utilice los parámetros de paginación para recuperar los resultados en bloques consecutivos.
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 <cadena de ID> es una cadena de ID personalizada o (si se especificó una cuando se creó la sesión de juego) una cadena generada.Tipo: cadena
Requerido: no
- Límite
-
Número máximo de resultados a devolver. Use este parámetro con NextToken para obtener resultados en un conjunto de páginas secuenciales. Si se especifica un ID de sesión de jugador, este parámetro se ignora.
Tipo: entero
Requerido: 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: cadena
Requerido: no
- PlayerId
-
Identificador único de un jugador. Los ID de jugador los define el desarrollador. Consulte Generación de ID de jugador.
Tipo: cadena
Requerido: no
- PlayerSessionId
-
Identificador único de una sesión de jugador.
Tipo: cadena
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: cadena
Requerido: no
-
FProcessParameters
Este tipo de datos contiene el conjunto de parámetros enviado al servicio Amazon GameLift Servers en una llamada a ProcessReady().
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.
Tipo: TArray<FString>
Requerido: no
- onStartGameSession
-
Nombre de la función de devolución de llamada que invoca el servicio Amazon GameLift Servers para activar una sesión de juego nueva. Amazon GameLift Servers llama a esta función en respuesta a la solicitud de cliente CreateGameSession. La función de devolución de llamada toma un objeto GameSession (definido en la Referencia de la API del servicio Amazon GameLift Servers).
Tipo: FOnStartGameSession
Obligatorio: sí
- onProcessTerminate
-
Nombre de la función de devolución de llamada que invoca el servicio Amazon GameLift Servers para forzar el cierre del proceso del servidor. Después de llamar a esta función, Amazon GameLift Servers espera cinco minutos hasta que el proceso del servidor se cierre y responde con una llamada ProcessEnding() antes de apagar el proceso del servidor.
Tipo: FSimpleDelegate
Requerido: no
- onHealthCheck
-
Nombre de la función de devolución de llamada que invoca el servicio Amazon GameLift Servers para solicitar un informe de estado del proceso del servidor. Amazon GameLift Servers llama a esta función cada 60 segundos. Después de llamar a esta función, Amazon GameLift Servers espera una respuesta durante 60 segundos y si no recibe ninguna, registra el proceso del servidor como en mal estado.
Tipo: FOnHealthCheck
Requerido: no
- onUpdateGameSession
-
Nombre de la función de devolución de llamada que invoca el servicio Amazon GameLift Servers para proporcionar un objeto de sesión de juego actualizado. Amazon GameLift Servers llama a esta función una vez que se ha procesado una solicitud de reposición de emparejamiento para proporcionar datos actualizados del emparejador. Pasa un objeto GameSession, una actualización de estado (
updateReason) y el ID del ticket de reposición de emparejamiento.Tipo: FOnUpdateGameSession
Requerido: no
FStartMatchBackfillRequest
Este tipo de datos se utiliza para enviar una solicitud de reposición de emparejamiento. La información se comunica al servicio Amazon GameLift Servers en una llamada a StartMatchBackfill().
Contenido
- GameSessionArn
-
Identificador único de la sesión de juego. La acción de la API GetGameSessionId() devuelve el identificador en formato de ARN.
Tipo: FString
Obligatorio: sí
- MatchmakingConfigurationArn
-
Identificador único, en forma de un ARN, que el emparejador utiliza para esta solicitud. Para encontrar el emparejador 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 emparejador. Puede obtener más información sobre los datos del emparejador en Trabajo con datos del emparejador.
Tipo: FString
Obligatorio: sí
- Players
-
Un conjunto de datos que representa a todos los jugadores que están actualmente en la sesión de juego. El emparejador utiliza esta información para buscar nuevos jugadores que son idóneos para los jugadores actuales. Para obtener una descripción del formato del objeto Player, consulte la Guía de referencia de la API de Amazon GameLift Servers. 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 emparejador. Si el emparejador utiliza latencia, recopile la latencia actualizada para la región actual e inclúyala en los datos de cada jugador.
Tipo: TArray<FPlayer>
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 Servers 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: FString
Requerido: no
FStopMatchBackfillRequest
Este tipo de datos se utiliza para cancelar una solicitud de reposición de emparejamiento. La información se comunica al servicio Amazon GameLift Servers en una llamada a StopMatchBackfill().
Contenido
- GameSessionArn
-
Identificador único de sesión de juego asociado a la solicitud que se va a cancelar.
Tipo: FString
Obligatorio: sí
- MatchmakingConfigurationArn
-
Identificador único del emparejador al que se envió esta solicitud.
Tipo: FString
Obligatorio: sí
- TicketId
-
Identificador único del ticket de solicitud de reposición que se va a cancelar.
Tipo: FString
Obligatorio: sí
