Envio da compilação do jogo

Para carregar uma compilação de jogo no servidor de atualização, use o utilitário de linha de comando Build Loader.

Requisitos do sistema do Build Loader:

  • SO Windows 10 de 64 bits ou macOS 12.4.0 e maior
  • CPU de 1,6 GHz
  • 100 MB de RAM livre
  • Espaço livre em disco: 1,5 × o tamanho da compilação do jogo

O Build Loader aceita as seguintes opções:

  • –init — inicialização do utilitário.
  • –update — enviar a compilação do jogo para o servidor.
  • –builds-list — uma lista de compilações de jogos.
  • –descr <build-description> — a descrição da compilação.
  • –api-key <API-key> — uma chave de API.
  • –game-path <path-to-game> — um caminho para a construção do jogo.
  • –chunk-size <chunk-size> — o tamanho dos pedaços — partes em que o arquivo do jogo é dividido. Aceita valores de 10mb a 500mb; o padrão é 500mb.
  • –retry-timeout <timeout> — o tempo limite entre as tentativas de envio de arquivos, em segundos. Aceita valores de 10 a 60, o padrão é de 20.
  • –retry-count <retry-count> — uma quantidade de tentativas de envio de arquivos. Aceita valores de 1 a 10, o padrão é de 3.
  • –set-build-on-test — colocando a compilação do jogo no estágio de Draft. O jogo estará disponível apenas para testes.
  • –set-build-on-master — colocando a construção do jogo para o estágio Published. O jogo estará disponível para os usuários finais. Se –set-build-on-test for especificada, essa opção será ignorada.
  • -no-progressbar — desativando a barra de progresso.

Para carregar uma compilação de jogo:

  1. Vá para Conta de Distribuidor > Build settings.
  2. Copie a chave de API.
  3. Baixe e instale o Build Loader.
  4. Inicialize o utilitário.
  5. Envie a(s) compilação(ões) do jogo no servidor.
  6. Coloque a compilação do jogo no estágio.
  7. Configure os arquivos do jogo.

Baixe e instale o Build Loader

Para baixar e instalar o Build Loader:

  1. na seção Games, clique em Setup à direita do jogo.
  2. Vá para Builds > Game builds.
  3. Baixe o arquivo com o Build Loader clicando no BuildLoader.zip que se adequa ao seu sistema operacional.
  4. Extraia o arquivo.

O local do utilitário relativo à pasta onde você extraiu o arquivo:

  • Para Windows: Win\build_loader.exe
  • Para MacOS: Mac/build_loader

Inicialize o Build Loader

Para inicializar o Build Loader:

  1. na seção Gamjes, clique em Setup à direita do jogo.
  2. Vá para a seção Builds > Game builds.
  3. Copie a chave de API clicando no ícone + na chave de API (ID do inicializador). A chave permite que o Build Loader envie seu jogo para o servidor.
  4. Inicialize o utilitário executando o seguinte comando:

Envie a compilação de jogo para o servidor

Para carregar uma compilação de jogo no servidor, execute o seguinte comando:

Você pode omitir o parâmetro –game-path se já o tiver usado ao inicializar o utilitário ou ao enviar a compilação anterior.

Durante o primeiro upload, o servidor de atualização recebe toda a compilação do jogo. Depois, ele receberá atualizações dos jogos geradas pelo Build Loader.

Observação
É altamente recomendável especificar o parâmetro –descr, para que você possa distinguir entre as compilações carregadas.
Para ver as compilações do jogo:
  1. Abra seu projeto na Conta de Distribuidor.
  2. Clique em Launcher no menu lateral.
  3. Na seção Games, clique em Set up à direita do jogo.
  4. Vá para Builds > Game builds.
  5. Navegue para baixo até a tabela Game builds.
Observação
Se a compilação do jogo contiver arquivos que são alterados durante o jogo, por exemplo, configurações, perfis de usuário ou arquivos salvos, adicione-os à lista de arquivos ignorados. Caso contrário, o inicializador detecta uma violação de integridade de arquivo ao atualizar o jogo e baixa o jogo inteiro novamente.

Coloque a compilação do jogo no estágio

Você pode colocar a compilação do jogo em um estágio da seguinte maneira:

  • Ao enviar a compilação ao servidor, passe a opção apropriada para o Build Loader:--set-build-on-master ou --set-build-on-test.
  • Depois de enviar a compilação para o servidor, faça o seguinte no projeto inicializador:
    1. Em Games, clique em Setup à direita do jogo.
    2. Vá para Builds > Game builds.
    3. Navegue para baixo até a tabela Game builds.
    4. Na tabela Game builds, clique no ícone de caneta à direita da compilação necessária.
    5. Clique em Set as published para colocar a compilação do jogo no estágio published, ou clique em Set as draft para o estágio de rascunho.
    6. Confirme sua escolha.
    7. Clique em Close.
    8. Você verá o nome da ramificação apropriada para sua compilação na coluna Branch da tabela Game builds. Além disso, sua compilação aparecerá na tabela Branches.

Configure os arquivos de jogo

Para permitir que o inicializador envie os arquivos corretos para os usuários, configure e inicialize os arquivos de instalação no seu projeto do inicializador primeiro:

  1. Em Games, clique em Setup à direita do jogo.
  2. Vá para a aba Executable files.
  3. Para cada sistema operacional, digite o nome e a extensão do arquivo que inicia o jogo. Esse arquivo deve estar na raiz da pasta do jogo. Por exemplo: game.exe
  4. Se o jogo tiver arquivos redistribuíveis:
    1. vá para a aba Redistributables e clique em Upload.
    2. Na janela exibida:
      1. Digite o nome do arquivo.
      2. Clique em Upload file e selecione um arquivo executável.
      3. Clique em Upload.

O inicializador encaminha os seguintes parâmetros para o jogo:

  • –xsolla-locale <locale>: idioma da interface;
  • –xsolla-login-token <token>: Xsolla Login JWT (JSON Web Token).
EXEMPLO

Tutoriais

Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.

Continuar lendo

Próximos passos

Gerar instalador
Última atualização: 30 de Agosto de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!