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

Puedes usar esta SDK referencia del servidor Amazon GameLift Go como ayuda para preparar tu juego multijugador para usarlo con Amazon GameLift. Para obtener más información sobre el proceso de integración, consulte Añade Amazon GameLift a tu servidor de juegos.

LogParameters

Un objeto que identifica los archivos generados durante una sesión de juego que quieres que Amazon GameLift suba y almacene una vez finalizada la sesión de juego. El servidor del juego proporciona LogParameters a Amazon GameLift como parte de un ProcessParameters objeto en una ProcessReady() llamada.

Propiedades

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 futuro. El proceso del servidor genera esos archivos durante una sesión de juego. Defina los nombres y las rutas de los archivos en el servidor de juegos y almacénelos en el directorio raíz de compilación del juego. Las rutas del registro deben ser absolutas. Por ejemplo, si la compilación del juego almacena los registros de sesión de juego en una ruta del tipo MyGame\sessionLogs\, la ruta sería c:\game\MyGame\sessionLogs en una instancia de Windows. Tipo: []string Obligatorio: no

ProcessParameters

Objeto que describe la comunicación entre un proceso de servidor y Amazon GameLift. El proceso del servidor proporciona esta información a Amazon GameLift con una llamada aProcessReady().

Propiedades	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 futuro. Tipo: LogParameters Obligatorio: no
OnHealthCheck	La función de devolución de llamada que Amazon GameLift invoca para solicitar un informe de estado de salud al proceso del servidor. Amazon GameLift llama a esta función cada 60 segundos y espera 60 segundos para recibir una respuesta. El proceso del servidor devuelve TRUE si está en buen estado y FALSE si no. Si no se devuelve ninguna respuesta, Amazon GameLift registra el proceso del servidor como incorrecto. Tipo: OnHealthCheck func() bool Obligatorio: no
OnProcessTerminate	La función de devolución de llamada que Amazon GameLift invoca para forzar el cierre del proceso del servidor. Tras llamar a esta función, Amazon GameLift espera 5 minutos a que se cierre el proceso del servidor y responde con una ProcessEnding() llamada antes de cerrar el proceso del servidor. Tipo: OnProcessTerminate func() Obligatorio: sí
OnStartGameSession	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 partidas para proporcionar datos actualizados de los emparejadores. Transmite un GameSession objeto, una actualización de estado (updateReason) y el identificador del ticket de relleno del partido. Tipo: OnStartGameSession func (model.GameSession ) Obligatorio: sí
OnUpdateGameSession	La función de devolución de llamada que Amazon GameLift invoca para pasar la información actualizada de la sesión de juego al servidor es el proceso. Amazon GameLift llama a esta función después de procesar una solicitud de relleno de partidas para proporcionar datos actualizados de los emparejadores. Tipo: OnUpdateGameSession func (model.UpdateGameSession) Obligatorio: no
Port	El número de puerto en el que escucha el proceso del servidor para recibir 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: int Obligatorio: sí

UpdateGameSession

Las actualizaciones en 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 reposición correspondiente si la reposición se utiliza para reponer las sesiones de los jugadores en la sesión de juego.

Propiedades	Descripción
GameSession	Un objeto GameSession. El objeto GameSession contiene propiedades que describen una sesión de juego. Tipo: GameSession GameSession() Obligatorio: sí
UpdateReason	El motivo por el que se actualiza la sesión de juego. Tipo: UpdateReason UpdateReason() Obligatorio: sí
BackfillTicketId	El ID de ticket de reposición que intenta actualizar la sesión de juego. Tipo: String Obligatorio: no

GameSession

Los detalles de una sesión de juego.

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

ServerParameters

Información utilizada para mantener la conexión entre un GameLift Anywhere servidor de Amazon y el GameLift servicio de Amazon. Esta información se utiliza al inicializar nuevos procesos de servidor con InitSDK(). Para los servidores alojados en EC2 instancias GameLift gestionadas por Amazon, usa un objeto vacío.

Propiedades	Descripción
WebSocketURL	GameLiftServerSdkEndpointAmazon GameLift regresa cuando RegisterComputebuscas un recurso GameLift Anywhere informático de Amazon. Tipo: string Obligatorio: sí
ProcessID	Un identificador único registrado en el proceso del servidor que aloja el juego. Tipo: string Obligatorio: sí
HostID	El identificador único del recurso informático que aloja el nuevo proceso del servidor. El HostID es el ComputeName utilizado cuando registró el recurso informático. Para obtener más información, consulte RegisterCompute. Tipo: string Obligatorio: sí
FleetID	El identificador único de la flota en la que está registrado el recurso informático. Para obtener más información, consulte RegisterCompute. Tipo: string Obligatorio: sí
AuthToken	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: string Obligatorio: sí

StartMatchBackfillRequest

Información utilizada para crear una solicitud de reposición de emparejamiento. El servidor del juego comunica esta información a Amazon GameLift en una StartMatchBackfill() llamada.

Propiedades	Descripción
GameSessionArn	El identificador único de la sesión de juego. La API operación GetGameSessionId devuelve el identificador en ARN formato. Tipo: String Obligatorio: sí
MatchmakingConfigurationArn	El identificador único (en forma deARN) que el emparejador utilizará en esta solicitud. El emparejador de la sesión ARN de juego original se encuentra en el objeto de sesión de juego de la propiedad de datos del emparejador. Para obtener más información sobre los datos del emparejador, consulte Trabajo con datos del emparejador. 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. Tipo: []model.Player Obligatorio: sí
TicketId	El identificador único para un ticket de solicitud de emparejamiento o reposición de emparejamiento. Si no proporcionas un valor, Amazon GameLift generará uno. 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 Obligatorio: no

Jugador

El objeto que representa a un jugador en el emparejamiento. Cuando se inicia una solicitud de emparejamiento, un jugador tiene un ID de jugador, atributos y, posiblemente, datos de latencia. Amazon GameLift añade la información del equipo después de disputar un partido.

Propiedades	Descripción
LatencyInMS	Un 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 se empareja con las ubicaciones que aparecen. 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: map[string] int Obligatorio: no
PlayerAttributes	Una colección de pares de clave-valor que contienen información del jugador para su uso en el 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 sobre los atributos de los jugadores, consulte AttributeValue. Tipo: map[string] AttributeValue Obligatorio: no
PlayerId	Un identificador único de un jugador. Tipo: String Obligatorio: no
Equipo	El nombre del equipo al que está asignado el jugador en un emparejamiento. Defina el nombre del equipo se define en el conjunto de reglas de emparejamiento. Tipo: String Obligatorio: no

DescribePlayerSessionsRequest

Un objeto que especifica las sesiones de jugador que recuperar. El proceso del servidor proporciona esta información con una DescribePlayerSessions() llamada a Amazon GameLift.

Propiedades	Descripción
GameSessionID	Un identificador único de la sesión de juegos. 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 de juego es arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. El GameSessionID es una cadena de ID personalizada o una cadena generada. Tipo: String Obligatorio: no
PlayerSessionID	El identificador único de una sesión de jugador. Utilice este parámetro para solicitar una sesión de jugador específica. Tipo: String Obligatorio: no
PlayerID	El identificador único de un jugador. Utilice este parámetro para solicitar todas las sesiones de jugador para un jugador específico. Consulte Generación de ID de jugador. Tipo: String Obligatorio: no
PlayerSessionStatusFilter	El estado de la sesión de jugador para filtrar los resultados. Los posibles estados de sesión de jugador son los siguientes: RESERVED— Se ha recibido la solicitud de sesión del jugador, pero el jugador no se ha conectado al proceso del servidor ni ha sido validado. ACTIVE— El jugador ha sido validado por el proceso del servidor y está conectado. COMPLETED— Se interrumpió la conexión del jugador. TIMEDOUT— Se recibió una solicitud de sesión de un jugador, pero el jugador no se conectó o no se validó dentro del tiempo límite de espera (60 segundos). Tipo: 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 indique ningún valor. Si se especifica un ID de sesión de jugador, este parámetro se ignora. Tipo: String Obligatorio: no
Limit	El número máximo de resultados que devolver. Si se especifica un ID de sesión de jugador, este parámetro se ignora. Tipo: int Obligatorio: no

StopMatchBackfillRequest

Información utilizada para cancelar una solicitud de reposición de emparejamiento. El servidor del juego comunica esta información al GameLift servicio de Amazon en una StopMatchBackfill() llamada.

Propiedades	Descripción
GameSessionArn	El identificador único de sesión de juego de la solicitud que se va a cancelar. Tipo: string Obligatorio: no
MatchmakingConfigurationArn	El identificador único del emparejador al que se envió esta solicitud. Tipo: string Obligatorio: no
TicketId	El identificador único del ticket de solicitud de reposición que se va a cancelar. Tipo: string Obligatorio: no

GetFleetRoleCredentialsRequest

Las credenciales de rol que permiten el acceso limitado a tus AWS recursos al servidor del juego. Para obtener más información, consulte Configurar un rol de servicio de IAM para Amazon GameLift.

Propiedades	Descripción
RoleArn	El rol ARN de servicio que extiende el acceso limitado a tus AWS recursos. Tipo: string Obligatorio: sí
RoleSessionName	El nombre de la sesión que describe el uso de las credenciales del rol. Tipo: string Obligatorio: sí