Cómo integrar Launcher en Steam

Cómo funciona

Flujo multiplataforma

Puede integrar su juego con Launcher en Steam. Le permite promocionar sus otros juegos de Steam a través de Xsolla Launcher.

Si su lanzador está integrado en Steam, se instala en el ordenador del usuario como una aplicación independiente cuando se inicia Steam por primera vez. El comportamiento posterior del lanzador depende de cómo se inicie:

• Mediante Steam:
  • El lanzador sólo muestra los juegos para los que se especifica el AppID de Steam en Cuenta del editor.
  • El botón Comprar lleva a la página del juego en la aplicación de Steam.
  • El botón Instalar inicia la instalación del juego a través del SDK de Steam en la aplicación de Steam.
  • El lanzador redirige al usuario a Steam para las compras dentro del juego.
  • Si ha habilitado la tienda en la configuración del proyecto del lanzador para un juego específico y ha proporcionado su AppID de Steam, el lanzador recuperará información sobre los contenidos descargables disponibles para ese juego desde Steam y creará tarjetas para estos contenidos descargables en la tienda de Xsolla Launcher. Cuando los usuarios pulsan en el botón Comprar, son redirigidos a la página de los artículos en la aplicación de Steam.
  • Xsolla Login crea automáticamente una cuenta de usuario dentro del ecosistema de Xsolla usando los datos del usuario desde Steam. Esto le permite ver todos los usuarios del lanzador de Cuenta del editor en la base de datos de de Xsolla Login. Los usuarios pueden utilizar la misma cuenta al lanzar el lanzador fuera de Steam y realizar compras dentro del juego a través de la tienda de Xsolla Launcher. Por lo tanto, incluso cuando se lanza desde Steam, puede comprobar la titularidad del usuario sobre los artículos comprados a través de la tienda de Xsolla Launcher usando métodos API de Xsolla.
  • Si el usuario pulsa en el botón Jugar (Play) en un juego que no sea el juego a través del cual se inició el lanzador, el lanzador se cierra, y el juego seleccionado se inicia en Steam en segundo plano. El lanzador inicia inmediatamente el juego sin mostrar la interfaz de usuario del lanzador. Cuando el usuario cierra el juego, se muestra la interfaz de usuario del lanzador.

• Como aplicación independiente a través del archivo ejecutable del lanzador o de su acceso directo en el escritorio:
  • El lanzador muestra todos los juegos añadidos al proyecto del lanzador, independientemente de si se especifica su AppID de Steam.

• • La tienda de Xsolla Launcher muestra los artículos internos del juego que se han añadido a dicha tienda a través de Cuenta del editor.

• • El lanzador tiene acceso a información sobre juegos instalados de forma local. a través de Steam. Si un juego distribuido mediante Steam está instalado de forma local, el botón Comprar se sustituye por un botón Jugar. Cuando el usuario pulsa en el botón Jugar, el lanzador se reinicia a través de Steam.

Requisitos previos

Para establecer la integración con Steam, necesita:

• un AppID de Steam
• una cuenta y un juego en Steamworks
• una compilación del juego creada para su publicación en Steam
• un lanzador listo para su uso configurado en Cuenta del editor

Puede encontrar su AppID de Steam en el panel de administración de su juego en Steamworks. Vaya a la sección Steamworks > App Admin y lo verá junto al nombre de su proyecto.

Pasos de la integración

Establecer la plataforma Steam y descargar archivos

1. Abra su proyecto en Cuenta del editor.
2. Haz clic en Launcher en el menú lateral.
3. Busque el lanzador en el panel y haga clic en Edit launcher.
4. Vaya a la sección Settings y haga clic en Set up a la derecha del logotipo de la plataforma Steam.
5. Introduzca su clave de la API web de Steam.
6. Introduzca el el ID de su juego en Steam.
7. Haga clic en Download launcher host para descargar el archivo LauncherHost.zip para Windows o macOS.
8. Haga clic en Download config para descargar los archivos de configuración del juego.
9. Vaya a la pestaña Launcher behavior y seleccione lo que debe hacer el lanzador cuando un usuario ejecute el juego desde Steam (opcional):
   • Ejecutar el lanzador (por defecto)
   • Ejecutar un juego

10. Vay a la pestaña User login y seleccione un método de inicio de sesión (opcional):
    • Automáticamente mediante la cuenta de Steam (por defecto).
    • Manualmente a través del widget de inicio de sesión. El widget utiliza el proyecto de inicio de sesión seleccionado durante la creación del lanzador.

Generar y descargar el instalador del lanzador

Preparar la compilación del juego para Steam

1. Desempaquete el archivo LauncherHost.zip (debe descargarse en el paso 1) en cualquier directorio. Este archivo contiene el directorio GameBuild para preparar el juego con un lanzador para subirlo a Steam. Estructura de carpetas para Windows:
   • LauncherHost.exe - un archivo ejecutable para la utilidad LauncherHost
   • Qt5Core.dll, vcruntime140-140_1.dll, msvcp140-140_1.dll - bibliotecas de servicio para la utilidad LauncherHost.exe
   • installer - una carpeta para el instalador del lanzador

1. Estructura de carpetas para MacOS:
   • LauncherHost - un archivo ejecutable para la utilidad LauncherHost
   • Frameworks - una carpeta de sistema para las bibliotecas de la utilidad LauncherHost
   • installer - una carpeta para 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 la sección Game > Build > Executable files y especifique la ruta relativa al archivo ejecutable del juego.

5. Copie y pegue un instalador de lanzador independiente (Windows/macOS) en la carpeta installer.
6. Copie y pegue los archivos de configuración de Steam en la carpeta GameBuild.
7. Si ya tienes su juego en Steam, sustituya el nombre del archivo LauncherHost.exe por el nombre del archivo ejecutable de su juego. Puede encontrar esta información en su panel de administración del juego en el campo Executable de la sección Apps & Packages > All applications > Steamworks admin > Installation > General installation.

8. Habilite el uso de ISteamApps::GetLaunchCommandLine() en su panel de administración del juego.

9. Haga clic en Prepare for Publishing para comprobar si hay algún conflicto entre su trabajo y el de otros usuarios.

Subir los archivos de compilación del juego de Windows a Steam

1. Inicie sesión en Steamworks y descargue el Steamworks SDK.
2. Desempaquete el archivo del SDK.

3. Vaya a la carpeta steamworks_sdk_151\sdk\tools y desesempaquete la utilidad SteamPipeGUI para subir compilaciones del juego a Steam.

4. Ejecute la utilidad SteamPipeGUI.

5. Rellene los siguientes campos en la ventana de configuración:
   1. En el campo App ID, especifica el AppID de Steam de su juego.
   2. En el campo Build description, introduzca una breve descripción de esta compilación para que sea más fácil de identificar en tu panel de administración de Steam.
   3. En el campo Steamworks SDK ContentBuilder Path, especifique la ruta a Steamworks SDK ContentBuilder.
   4. En los campos Steam Login y Steam Password, introduzca su nombre de usuario y contraseña de Steamworks.

5. 5. Haga clic en Add Depot. En el campo Build Path, especifique la ruta a GameBuild con la compilación del juego y el instalador de Launcher.

5. 6. Haga clic en Upload y espere a que finalice la carga.

Subir los archivos de compilación del juego de macOS a Steam

1. Copie y pegue launcher.dmg en la carpeta GameBuild/installer.
2. Copie y pegue hostArgs.json en la carpeta GameBuild.
3. Suba los archivos a Steam:
   1. Abra la carpeta SteamSDK desempaquetada.

5. 2. Vaya a la carpeta tools/scripts.
   3. Cree un script vdf denominado app_build_<steam_id>.vdf, en el cual <steam_id> es el ID de Steam de su proyecto y el siguiente contenido (sustituye xxxxxx en la línea 3 por el ID de Steam, yyyyyy en la línea 11 por el ID de Depot - esto es el ID de Steam + 1:

	"AppID" "xxxxxx" // your AppID
	"Desc" "This is a simple build script 1" // internal description for this build

	"ContentRoot" "../content/" // root content folder, relative to location of this file
	"BuildOutput" "../output/" // build output folder for build logs and build cache files

	"Depots"
	{
		"yyyyyy" // your DepotID
		{
			"FileMapping"
			{
				"LocalPath" "*" // all files from contentroot folder
				"DepotPath" "." // mapped into the root of the depot
				"recursive" "1" // include all subfolders
			}
		}
	}
}

5. 4. Guarde los cambios.
   5. Copie el contenido del directorio GameBuild y péguelo en la carpeta tools/ContentBuilder/Content.
   6. En la consola del terminal, vaya a la carpeta tools/ContentBuilder/builder_osx.
   7. invoque el comando ./steamcmd.sh para comenzar la inicialización y la configuración.
   8. Invoque el siguiente comando para ejecutar el script que carga la compilación en los servidores de Steam:

cmd.sh +login <username> <password> +run_app_build_http ../scripts/app_build_{Steam_id}.vdf

Publicar la compilación del juego en Steamworks

1. Vaya a su panel de administración del juego en Steamworks.
2. Haga clic en Steamworks Admin para abrir la página de administración de la aplicación.

3. Vaya al bloque SteamPipes > Builds.

4. Cree una nueva rama o utilice una rama predeterminada.
5. Busque la compilación cargada por su ID de compilación, fecha de carga o descripción, y coloque la compilación en su rama.
6. Haga clic en Preview change y vea sus cambios.
7. Haga clic en Set Build Live Now.