Clientes del juego
Cloud Gem Framework puede generar clientes de juego para su API de servicio.
El cliente de juego puede llamar a algunas operaciones de API en nombre del jugador.
A otras operaciones solo se puede llamar a través de otros roles para usarlas en Cloud Gem Portal u otras herramientas. De forma predeterminada, el cliente utiliza las credenciales
de AWS al asumir el rol Player a través de un grupo de identidades de Amazon Cognito. Este proceso, que se describe
en detalle en Player Identity, se puede ver en el siguiente diagrama.
Generación de un cliente de juego
Generar un cliente de juego es sencillo.
Para generar un cliente de juego
Escriba el siguiente comando:
lmbr_aws cloud-gem-framework generate-service-api-code --resource-group<group>
El comando generate-service-api-code lee el archivo swagger.json que contiene las definiciones para la API de servicio del grupo de recursos. El comando
crea un archivo de encabezado C++ que implementa un componente Lumberyard. El archivo
de encabezado se llama <group>ClientComponent.h
La ubicación del directorio del archivo de encabezado depende de si <group> hace referencia a una gema en la nube o a un recurso definido por el proyecto.
Ubicaciones de archivos de encabezados de componentes generados
| Tipo de parámetro | Ubicación del archivo de encabezado |
|---|---|
| Gema en la nube | Gems |
| Grupo de recursos | Code\ |
Accesibilidad del archivo de encabezado de componentes
La ubicación predeterminada del archivo de encabezado generado para una gema no es
accesible fuera de dicha gema. Normalmente, la API de servicio de la gema en la nube
es privada de la gema, y esta expone su funcionalidad a través de sus propios componentes
personalizados. Si desea proporcionar acceso directo a la API de la gema de la nube
desde otras gemas o desde el código del juego, puede mover el archivo de encabezado
generado al directorio Code\Include de la gema.
Notas
-
Para utilizar el cliente generado, añada el archivo generado a la gema o la lista de archivos WAF del proyecto y, a continuación, compile la gema o el proyecto.
-
Puede utilizar el componente de cliente generado para invocar a la API desde C++ o Lua. Para obtener más información, consulte Llamar a una API de juegos.
-
Para ver código de muestra, consulte Ejemplo de código de cliente de juegos generado.
