Como integrar o inicializador com o Steam

Como funciona

Fluxo multiplataforma

Você pode integrar seu jogo com o inicializador no Steam. Ele permite que você promova seus outros jogos Steam via Xsolla Launcher.

Se o inicializador for integrado no Steam, ele é instalado no computador do usuário como um aplicativo separado quando o Steam é iniciado pela primeira vez. O comportamento subsequente do inicializador depende de como ele é inicializado:

• Via Steam:
  • O inicializador exibe somente os jogos dos quais o Steam App ID é especificado na Conta de Distribuidor.
  • O botão Buy leva à pagina do jogo no aplicativo Steam.
  • O botão Install inicia a instalação do jogo através do Steam SDK no aplicativo Steam.
  • O inicializador redireciona o usuário ao Steam para as compras no jogo.
  • Se você ativou a loja nas configurações de projeto do inicializador para um jogo específico e forneceu seu Steam App ID, o inicializador vai recuperar informações sobre os DLCs disponíveis para o jogo pelo Steam e criará cartões para esses DLCs na loja do Xsolla Launcher. Quando o usuário clicar no botão Buy, ele será redirecionado para a página do item no aplicativo Steam.
  • O Xsolla Login automaticamente cria uma conta de usuário dentro do ecosistema Xsolla usando os dados do usuário vindos do Steam. Isso permite que você veja todos os usuários do inicializador na Conta de Distribuidor no banco de dados Xsolla Login. Os usuários podem usar a mesma conta ao executar o inicializador fora do Steam e fazer compras no jogo através da loja Xsolla Launcher. Portanto, mesmo quando executado no Steam, você pode conferir a propriedade dos itens do usuário comprados pela loja Xsolla Launcher usando os métodos Xsolla API.
  • Se o usuário clicar no botão Play em um jogo diferente do que o jogo pelo qual o inicializador foi iniciado, o inicializador será fechado e o jogo selecionado será iniciado no Steam no plano de fundo. O inicializador imediatamente inicia o jogo sem exibir a interface do inicializador. Após o usuário fechar o jogo, a interface do inicializador é aberta novamente.

• Como um aplicativo independente através do arquivo executável do inicializador ou seu atalho na área de trabalho:
  • O inicializador exibe todos os jogos adicionados ao projeto do inicializador, independentemente do Steam APP ID ser especificado ou não.

• • A loja Xsolla Launcher exibe itens no jogo que foram adicionados pela Conta de Distribuidor.

• • O inicializador tem acesso a informações sobre jogos instalados localmente através do Steam. Se um jogo distribuído pelo Steam for instalado localmente, o botão Buy será substituído com um botão Play. Quando o usuário clicar no botão Play, o inicializador é reiniciado pelo Steam.

Pré-requisitos

Para configurar a integração com o Steam, você precisa:

• um Steam AppID
• , uma conta e um jogo no Steamworks
• uma compilação de jogo para publicação no Steam
• um Launcher de uso pronto configurado na Conta de Distribuidor

Você pode encontrar seu AppID do Steam no seu painel de administração do jogo no Steamworks. Vá para a seção Steamworks > App Admin e você a verá ao lado do nome do seu projeto.

Etapas de integração

Configure a plataforma Steam e baixe arquivos

1. Abra seu projeto na Conta de Distribuidor.
2. Clique em Launcher no menu lateral.
3. Localize o inicializador no painel e clique em Edit launcher.
4. Vá para a seção Settings e clique em Setup à direita do logotipo da plataforma Steam.
5. Insira sua Steam Web API Key.
6. Introduza o Steam App ID do seu jogo.
7. Clique em Download launcher host para baixar o arquivo LauncherHost.zip para Windows ou macOS.
8. Clique em Download config para baixar os arquivos de configuração do jogo.
9. Vá para a aba Launcher behavior e selecione o que o inicializador deve fazer quando um usuário executar o jogo no Steam (opcional):
   • Execute o inicializador (padrão)
   • Execute um jogo

10. Vá para a aba User login e selecione um método de login (opcional):
    • Automaticamente via conta Steam (padrão).
    • Manualmente via widget de login. O widget usa o projeto de login selecionado durante a criação do inicializador.

Gere e baixe o instalador do inicializador

Prepare a compilação do jogo para o Steam

1. Descompacte o arquivo LauncherHost.zip (deve ser baixado na etapa 1) para qualquer diretório. Este arquivo contém o diretório para preparar o diretório GameBuild para preparar o jogo com um inicializador para ser enviado no Steam. Estrutura de pastas para Windows:
   • LauncherHost.exe — um arquivo executável para o utilitário LauncherHost
   • Qt5Core.dll, vcruntime140-140_1.dll, msvcp140-140_1.dll — bibliotecas de serviço para o utilitárioLauncherHost.exe
   • installer — uma pasta para o instalador do inicializador

1. Estrutura de pastas para MacOS:
   • LauncherHost — um arquivo executável para o utilitário LauncherHost
   • Frameworks — uma pasta do sistema para as bibliotecas do utilitárioLauncherHost
   • installer — uma pasta para o instalador do inicializador

2. Crie uma nova pasta na pasta GameBuild.
3. Copie e cole a compilação do jogo nessa pasta.
4. Configure o nome do arquivo executável do jogo (Windows / macOS) na seção Game > Build > Executable files e especifique o caminho relativo para o arquivo executável do jogo.

5. Copie e cole um instalador de inicializador autônomo (Windows / macOS) na pasta do instalador.
6. Copie e cole os arquivos de configuração do Steam na pastaGameBuild.
7. Se você já tiver seu jogo no Steam, substitua o nome do arquivo LauncherHost.exe pelo nome do arquivo executável do jogo. Você pode encontrar essas informações no painel de administração do jogo no campo Executable da seção Apps & Packages > All applications > Steamworks admin > Installation > General installation.

8. Habilite o uso ISteamApps::GetLaunchCommandLine() no painel de administração do seu jogo.

9. Clique em Prepare for Publishing para verificar se há conflitos entre seu trabalho e o de outros usuários.

Envie arquivos de compilação de jogos do macOS ao Steam

1. Faça login no Steamworks e baixe o SDK do Steamworks.
2. Descompacte o arquivo SDK.

3. Vá para a pasta steamworks_sdk_151\sdk\tools e descompacte o utilitário SteamPipeGUI para enviar compilações de jogos ao Steam.

4. Execute o utilitário SteamPipeGUI.

5. Preencha os seguintes campos na janela de configurações:
   1. No campo App ID, especifique o Steam AppID do seu jogo.
   2. No campo Build description, insira uma breve descrição dessa compilação para facilitar a identificação no painel de administração do Steam.
   3. No campo Steamworks SDK ContentBuilder Path, especifique o caminho para o Steamworks SDK ContentBuilder.
   4. Nos campos Steam Login e Steam Password Senha, insira seu login e senha do Steamworks.

5. 5. Clique em Add Depot. No campo Build Path, especifique o caminho para GameBuild com a compilação do jogo e o instalador do Launcher.

5. 6. Clique em Upload e aguarde a conclusão do envio.

Envie arquivos de compilação de jogos do macOS ao Steam

1. Copie e cole launcher.dmg no GameBuild/installer.
2. Copie e cole hostArgs.json na pasta GameBuild.
3. Envie arquivos para o Steam:
   1. Abra a pasta SteamSDK descompactada.

5. 2. Vá para a pasta tools/scripts.
   3. Crie um script vdf chamado app_build_<steam_id>.vdf, onde <steam_id> é o Steam ID do seu projeto e o seguinte conteúdo (substitua xxxxxx na linha 3 pelo Steam ID, yyyyyy na linha 11 pelo ID do Depósito - este é o Steam ID + 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. Salve as alterações.
   5. Copie os conteúdos do diretório GameBuild e cole-os na pasta tools/ContentBuilder/Content.
   6. No console do terminal, vá para a pasta tools/ContentBuilder/builder_osx.
   7. Chame o comando ./steamcmd.sh para começar a inicialização e a configuração.
   8. Chame o seguinte comando para executar o script que carrega a compilação para os servidores Steam:

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

Publique a compilação de jogos no Steamworks

1. Acesse o seu painel de administração do jogo no Steamworks.
2. Clique em Steamworks Admin para abrir a página de administração do aplicativo.

3. Vá para a seção SteamPipes > Builds.

4. Crie uma nova ramificação ou use uma ramificação padrão.
5. Localize a compilação enviada por sua ID de compilação, data de envio ou descrição e coloque a compilação em sua ramificação.
6. Clique em Preview change e veja suas alterações.
7. Clique em Set Build Live Now.