Cómo integrar Launcher con Epic Games Store

Cómo funciona

Puede integrar su juego con Launcher en Epic Games Store (EGS). Le permite promocionar otros juegos en EGS a través de Xsolla Launcher.

Requisitos previos

Para establecer la integración con EGS, necesita:

• un ID de aplicación de Epic (Artifact ID)
• una cuenta con el rol de administrador y una aplicación de juego en el portal del desarrollador de Epic Games
• una compilación de juego para su publicación en EGS
• un lanzador listo para su uso configurado en Cuenta del editor
• la última versión de BuildPatch Tool

Obtener el ID de aplicación de Epic (Artifact ID)

Para obtener su ID de aplicación de Epic:

1. Inicie sesión en el portal del desarrollador de Epic Games.
2. Vaya a sus productos de juego.
3. En la tarjeta de juego, seleccione la opción Epic Games Store.

4. En el menú lateral, haga clic en Artifacts and Binaries y elija el sandbox y el artefacto.

5. Haga clic en el nombre del artefacto para ver el ID de aplicación de Epic

Pasos de la integración

Configurar la autorización

1. Si no dispone de una política de cliente, cree una:
   1. Inicie sesión en el portal del desarrollador de Epic Games.
   2. En la configuración de su producto (juego) vaya a Product Settings > Clients > Add new client policy.
   3. Añada un nombre para la política en el campo Client policy.
   4. Seleccione la política GameClient de la lista desplegable Client policy type.
   5. Haga clic en Add new policy.

2. Cree un cliente de inicio de sesión:
   1. En la configuración de su producto, vaya a Product Settings > Clients > Add new client.
   2. Añada un nombre para el cliente en el campo Client name.
   3. Seleccione la política de cliente recién creada del desplegable Client policy.

3. Haga clic en Create Application.

4. Asigne el cliente creado:
   1. Haga clic en Linked Clients en la parte superior derecha.
   2. Seleccione el cliente creado de la lista desplegable Select Clients.

5. Asegúrese de que los permisos están configurados; haga clic en la barra de navegación Permissions. Si está marcado como Not configured, active y desactive cualquiera de las opciones y guarde los cambios.

6. En su proyecto en Cuenta del editor vaya a la sección Login.
7. Seleccione una opción de inicio de sesión y vaya a Autenticación > Plataformas de publicación > Epic Games.
8. Rellene los campos ID de aplicación y Clave secreta de la aplicación. Puede copiar los valores de los campos del portal del desarrollador de Epic Games (en Product Settings > Clients > Edit client).
9. Haga clic en Guardar cambios.

Configurar la plataforma EGS y descargar archivos

1. En su proyecto en Cuenta del editor vaya a la sección Launcher.
2. Busque el lanzador en el panel y haga clic en Editar lanzador.
3. Vaya a la sección Configuración y haga clic en Configurar a la derecha del logotipo de la plataforma de Epic Games.

4. Introduzca el ID de aplicación de Epic de su juego.
5. Para asegurarse de que la asignación de derechos de usuario funciona correctamente, especifique el ID de Audience Item. Realice los siguientes pasos para obtener el ID:
   1. En la configuración de su producto, vaya a Epic Games Store > Offers.
   2. Determine qué ofertas se utilizarán para que los lanzadores comprueben la titularidad. Si el usuario tiene una oferta de derechos que usted ha elegido, el lanzador considerará que el usuario es el propietario del juego.
   Haga clic en Edit offer para ver el Audience Item ID.

7. Haga clic en Descargar host para descargar el archivo LauncherHost.zip para Windows o macOS.
8. Haga clic en Descargar configuración para descargar el archivo de configuración hostArgs.json para Windows o macOS.

Generar y descargar el instalador del lanzador

Preparar la compilación de juego para EGS

1. Descomprima el archivo LauncherHost.zip (descargado en el paso anterior) en cualquier carpeta. Este archivo contiene el directorio GameBuild que se utilizará para preparar las compilaciones del juego que se subirán a Epic Dev Portal.

• LauncherHost.exe: un archivo ejecutable para la utilidad de LauncherHost
• Qt5Core.dll vcruntime140-140_1.dll, msvcp140-140_1.dll: bibliotecas de servicio para la utilidad de LauncherHost.exe
• installer: un directorio que contiene el instalador del lanzador

Estructura de directorio para MacOS:

• LauncherHost: un archivo ejecutable para la utilidad de LauncherHost
• Frameworks: una carpeta del sistema para las bibliotecas de utilidad de LauncherHost
• installer: una carpeta que contiene el instalador del lanzador

2. Cree una nueva carpeta en la carpeta GameBuild.
3. Copie y pegue la compilación del juego en esa carpeta.
4. Establezca el nombre del archivo ejecutable del juego (Windows/macOS) en Juego > Compilación > Archivos ejecutables y especifique la ruta relativa al archivo ejecutable del juego.

5. Copie el instalador del lanzador y el archivo hostArgs.json al directorio GameBuild. Como resultado, el directorio GameBuild debería tener la siguiente estructura:
   • Para Windows:

\---GameBuild
    |   hostArgs.json
    |   LauncherHost.exe
    |   msvcp140.dll
    |   msvcp140_1.dll
    |   Qt5Core.dll
    |   vcruntime140.dll
    |   vcruntime140_1.dll
    |
    \---installer
            installer.exe

2. • Para macOS:

\---GameBuild
    |   hostArgs.json
    |   LauncherHost
    |
    +---Frameworks
    |   \---QtCore.framework
    |       \---Versions
    |           \---5
    |               |   QtCore
    |               |
    |               \---Resources
    |                       Info.plist
    |                       QtCore.prl
    |
    \---installer
            Launcher.pkg

Subir compilaciones de juego a EGS

1. Descomprima la herramienta BuildPatch Tool descargada anteriormente.
2. Cree un directorio para BuildPatch Tool que se utilizará como directorio caché para las compilaciones de juego.
3. Vaya al directorio descomprimido BuildPatchTool_x.y.z/Engine/Binaries/Win64 (variará en función de la versión de BuildPatch Tool y del sistema operativo).
4. Abra un terminal dentro de este directorio y ejecute el siguiente comando para subir los binarios del juego. Consulte la documentación para obtener más información.

.\BuildPatchTool.exe
  -ClientId="<YourClientId>"
  -ClientSecret="<secret>"
  -mode=UploadBinary
  -OrganizationId="<YourOrg>"
  -ProductId="<YourProduct>"
  -ArtifactId="<YourArtifact>"
  -BuildRoot="<absolute-path-to-GameBuild-directory>"
  -CloudDir="<absolute-path-to-cache-directory>"
  -BuildVersion="1.0.2-launcher-win"
  -AppLaunch="LauncherHost.exe"
  -AppArgs=""

Los parámetros de comando:

• ClientId y ClientSecret están disponibles en Epic Dev Portal en Product Settings > BPT Credentials.

• OrganizationId está disponible en la sección General Settings de la pestaña Organization > Settings.

• ProductId está disponible en la sección EOS SDK Credentials de la pestaña Product Settings > SDK Download & Credentials.

• Para obtener los valores de los parámetros ArtifactId y BuildVersion, consulte las instrucciones. El valor del parámetro BuildVersion también está disponible en el menú de acciones de la tarjeta de juego en el lanzador de Epic Games.

• AppLaunch: la ruta del archivo ejecutable principal relativa a BuildRoot en el siguiente formato:
  • LauncherHost.exe: para Windows LauncherHost: para MacOS

• AppArgs: argumentos de lanzamiento adicionales. Puede ser una cadena vacía.

Asigne plataformas al artefacto

1. Vaya a la página del artefacto.
2. En la parte derecha, desplácese hasta la sección Inactive binaries, haga clic en el botón del menú de acciones (…), haga clic en Assign platforms. Seleccione las plataformas correspondientes.

Obtener acceso de desarrollador al juego en el lanzador de EGS

1. Añada un nuevo usuario a grupos:
   1. Acceda a la sección Product Settings > Player Groups.
   2. Haga clic en el botón del menú de acciones (…) de un grupo de jugadores concreto y haga clic en Edit Group.
   3. Vaya a la pestaña Add accounts, seleccione Epic Games como proveedor de identidad y especifique el ID de cuenta.

2. Genere claves de acceso:
   1. Vaya a la sección Epic Games Store > Access keys de la configuración de su proyecto.
   2. Haga clic en Generate keys en la parte superior derecha.

2. 3. Seleccione el sandbox y la oferta para la que quiere generar las claves.

2. 4. Introduzca el nombre de las claves en el campo Batch name.
   5. Seleccione el tipo Testing.
   6. Especifique la cantidad.

2. 5. Una vez creadas las claves, descárguelas. Haga clic en el botón del menú de acciones (…) y seleccione Download.

5. Haga clic en el botón de perfil en la parte superior derecha del lanzador de EGS y haga clic en Redeem Code.
6. Canjee la clave descargada. Una vez canjeada correctamente la clave de una oferta, el usuario tendrá derecho a esa oferta concreta.

Actualizar las compilaciones de juego

Para actualizar las compilaciones de juego existentes, repita los pasos para preparar las compilaciones de juego, subirlas a EGS y asignarlas al artefacto.