Perguntas Frequentes

Questões gerais

Por que usar Xsolla Launcher quando eu posso criar meu próprio inicializador?

Xsolla Launcher economiza tempo e recursos durante a fase final de desenvolvimento ou após a conclusão do desenvolvimento do jogo. Xsolla Launcher é gratuito para parceiros, excluindo taxas de pagamento. Xsolla Launcher lança regularmente novos recursos para os usuários e funciona com outros produtos Xsolla, incluindo loja do jogo, construtor de sites e login. Xsolla acompanha as tendências do mercado.

Quanto vai me custar o Xsolla Launcher?

O preço do Xsolla Launcher já está incluso na taxa da Xsolla. Custos adicionais podem ser aplicados na entrega de jogos. Entretanto, usar um sistema de balanceamento P2P reduz os custos de envio em 80%, em média.

Como faço para entregar atualizações de jogos no Steam se estiver usando o Xsolla Launcher?

Se você usar o inicializador do Steam, baixe a versão e o inicializador do jogo diretamente no Steam. Neste caso, Steam entrega e atualiza o jogo. Se você deseja entregar conteúdo usando o Xsolla Launcher e seu CDN no Steam, entre em contato com seu gerente de projeto ou envie um e-mail para csm@xsolla.com.

Preciso manter duas versões separadas, uma para Steam e outra independente? Ou é a mesma versão que é enviada ao Steam?

O número de versões depende do método de integração com Steam. No entanto, muitas vezes uma é o suficiente. O inicializador permite coletar dados de usuário em um único banco de dados se você oferecer suporte de distribuição de jogos em múltiplas plataformas. O inicializador também suporta registro ponta a ponta: se um usuário iniciar o jogo pelo Steam pela primeira vez, ele não precisará inserir os dados.

Neste caso, o usuário pode visitar seu site fora do sistema Steam, autenticando-se com o Steam OpenID e virando membro da sua comunidade oficial. Depois disso, o usuário pode escrever em fóruns, ler notícias, encontrar novos jogos, etc.

Estou usando as ferramentas do Steam, incluindo o inicializador, e não tenho custos de CDN. O que vai mudar se eu começar a usar o Xsolla Launcher?

Adicionar Xsolla Launcher ao Steam com o jogo não altera a lógica de distribuição: Steam ainda é responsável pela distribuição e atualização dos jogos. O inicializador CDN não é usado neste caso.

Se deseja distribuir o jogo por conta própria e usar o inicializador independentemente da plataforma, Xsolla Launcher distribui versões e atualizações de jogos usando seu CDN (G-core por padrão) ou qualquer outro que você solicitar. O pagamento pelo tráfego não está incluído na comissão de pagamento padrão e é pago separadamente, mês a mês.

A Xsolla tem um preço empresarial especial para G-core que se aplica a todos os clientes.

Vocês têm uma lista de CDNs pré-integrados ao Xsolla Launcher? Preciso entrar em contato com as empresas que fornecem CDNs para maior integração? Posso usar um CDN que não esteja na sua lista?

Se você quiser usar outro provedor de CDN, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.

Quais jogos são exibidos na lista de jogos do Xsolla Launcher? Todos os jogos adicionados ou apenas aqueles que foram adquiridos pelo usuário?

A lista contém todos os jogos adicionados ao Xsolla Launcher. Os jogos adquiridos por um usuário possuem o botão Play, ao passo que os demais jogos possuem o botão Buy ou botões diferentes dependendo do tipo de distribuição do jogo.

Usuários específicos podem obter chaves de jogo gratuitas? Como eles podem usá-las?

Sim, você pode baixar chaves de jogo da Conta de Distribuidor e enviá-las gratuitamente aos usuários como desejar. Os usuários poderão ativar as chaves pelo Xsolla Launcher.

Os usuários podem ser autenticados em jogos automaticamente após serem autenticados no Xsolla Launcher?

Sim, é possível. Para transferir dados de usuário do Xsolla Launcher para o jogo, use o parâmetro –xsolla-login-token. Para obter dados de usuário, você precisa decodificar o valor do parâmetro.

O que posso fazer se o ícone do Xsolla Launcher na bandeja não mudou depois que eu alterei e reconstruí o Xsolla Launcher?

Reinstale Xsolla Launcher.

Onde posso encontrar os logs do inicializador?

Para encontrar os logs do inicializador:

1. Abra seu inicializador.
2. Vá para as configurações do inicializador.
3. Clique em Browse logs na seção General.

Como o jogo se integra com o Xsolla Launcher?

Para integrar o jogo ao Launcher, crie um projeto em sua Conta de Distribuidor e baixe a montagem do jogo. Depois disso, você pode adicionar imagens ao seu jogo e definir configurações adicionais na interface.

Existe algum tipo de solução de IPC no SDK?

Não há IPC no momento, pois o Xsolla Launcher não possui recursos que exijam comunicação IPC. Mas planejamos adicionar recursos como transmissão ao vivo e uma loja de jogos na interface. Esses recursos exigirão IPC (via SDK), que será devidamente adicionado.

Xsolla Launcher é compatível com dispositivos móveis ou Mac?

Xsolla Launcher é compatível com Windows e MacOS OS.

Como o conteúdo é preenchido na página de um jogo no Xsolla Launcher?

Você pode preencher informações sobre o conteúdo nas configurações de cada jogo, na seção Game Info. Você também pode preencher o conteúdo da página do jogo na seção Game Titles do Xsolla Launcher. Para saber mais, leia as instruções.

Build Loader

Ao enviar uma atualização de jogo pelo Build Loader, eu me deparo com o seguinte erro: "Atenção! O diretório do arquivo é maior do que 260 caracteres." Como posso corrigir isso?

No Windows, há um limite no comprimento máximo de um diretório completo, então recomendamos mover o diretório de jogo para um ponto anterior no trajeto. como C:/Patch. Após isso, passe o caminho atualizado à compilação do jogo usando o comando –game-path <path-to-game>. Para saber mais, leia as instruções.

Não consigo inicializar o Build Loader. Como posso corrigir isso?

O Build Loader é um utilitário de linha de comandos. Abra o interpretador de linha de comandos, tal como cmd.exe, no diretório com o arquivo build_loader.exe e execute o arquivo usando o seguinte comando: ./build_loader.exe Para saber mais, leia as instruções.

Problema desconhecido com o Build Loader. Como posso corrigir isso?

Contate a equipe de integração da Xsolla pelo chat no canto inferior direito da tela da Conta de Distribuidor e forneça o arquivo log.txt localizado no mesmo diretório que o arquivo build_loader.exe.

Conta de Distribuidor

Ao acessar a Conta de Distribuidor, ela indica que ainda estou usando uma versão antiga do Inicializador e precisa criar um novo inicializador. Mas, ao clicar no botão Try New Launcher, nossos inicializadores são exibidos. Como posso corrigir isso?

No momento, a Conta de Distribuidor permite trabalhar com as versões v2.x.x e v3.x.x do Inicializador, mas criar um inicializador v2.x.x não é mais possível. Ao trocar para a nova versão do inicializador, as configurações são salvas no seu dispositivo. Porém, se você acessar sua conta em um novo dispositivo, as configurações aplicadas serão efetivadas para os usuários na versão antiga do Inicializador.

Se os inicializadores criados não forem exibidos na seção Launcherda Conta de Distribuidor. Como posso corrigir isso?

Exclua os dados e arquivos cookie do site da Conta de Distribuidor nas suas configurações de navegador.

Não consigo alterar as configurações da Conta de Distribuidor. Como posso corrigir isso?

Confira se você possui uma função de proprietário ou desenvolvedor. Os usuários de outras funções possuem permissões apenas de leitura.

Mudei a função da Conta de Distribuidor, mas ainda não tenho as permissões para alterar as configurações do inicializador. Como posso corrigir isso?

Para atualizar nossas configurações de permissão, acessa a Conta de Distribuidor novamente.

A geração do inicializador está congelada. Como posso corrigir isso?

Contate a equipe de integração Xsolla pelo chat no canto inferior direito da Conta de Distribuidor.

Como posso ver rapidamente as alterações que fiz no Xsolla Launcher?

Você pode gerar um rascunho do Xsolla Launcher. Todas as configurações e alterações de personalização salvas em sua Conta de Distribuidor são aplicadas automaticamente no rascunho.

Como posso distribuir meu jogo free-to-play com microtransações pelo Xsolla Launcher? ​

Para distribuir um jogo grátis:

1. Acesse seu projeto na Conta de Distribuidor.
2. No menu lateral, clique em Launcher.
3. No cartão do projeto, clique em Edit Launcher.
4. Na seção Games, clique em Set up.
5. Clique em Distribution e selecione Free-to-play.
6. No menu superior, clique em Store e marque a opção Show store in Launcher como On.

Depois de concluir essas etapas, a janela Store deve ser exibida no inicializador. Para saber mais, leia as instruções.

Personalização

O plugin de tokens Figma não está funcionando corretamente. Como posso corrigir isso?

Abra as configurações dos tokens Figma e altere o armazenamento de tokens para o documento local.

O que posso alterar no Figma?

O Figma permite configurar:

• O arredondamento e cores de botões
• Cores de fontes
• Arredondamento e cores de janelas
• Arredondamento e cores de artigos
• Arredondamento e cores de botões
• Cores de painéis

Imagens são apenas para a pré-visualização; você deve enviá-las na Conta de Distribuidor. Outras configurações, como a posição de elementos e tamanho da imagem não são personalizáveis.

Há alguma maneira de baixar o código fonte do inicializador fornecido pela Xsolla e modificá-lo diretamente, em vez de das opções limitadas no site?

No momento, não fornecemos o código fonte do inicializador. O inicializador é personalizado apenas por uma Conta de Distribuidor e o Figma após você assinar um contrato.

Eu gostaria de desativar a funcionalidade de login no inicializador. Como posso fazer isso?

Essa funcionalidade ficará disponível na Conta de Distribuidor.

Não consigo alterar o nome do inicializador. Como posso corrigir isso?

Podemos fazer alterações manualmente do nosso lado, mas a atualização automática do inicializador será afetada. Os usuários deverão instalar o inicializador a partir do instalador. Não recomendamos alterar o nome de inicializadores ativos online.

Como posso alterar a ordem dos jogos no inicializador?

No momento, não há maneira de alterar a ordem dos jogos.

Posso mover o botão Download de lugar?

Os elementos não podem ser movidos, mas você pode personalizar o arredondamento e cores via Figma e enviar as configurações na Conta de Distribuidor.

Instalador

Devo adicionar um link de download do inicializador ao meu site? Posso implementar o cadastro de usuários via inicializador em vez do site?

Sim, é o canal principal de distribuição do inicializador para todos os nossos parceiros. Mas eles não precisam se lembrar de atualizar esse link junto de cada nova geração do inicializador. Além disso, o inicializador tem um recurso de cadastro.

Posso adicionar um link de download do inicializador ao e-mail de confirmação de cadastro?

Não há uma maneira de fazer isso no momento porque o link para download do inicializador é alterado toda vez que uma nova versão é gerada.

Como posso alterar o nome do arquivo de instalação?

Para alterar a instalação do nome do arquivo, consulte a instrução.

Posso receber informações sobre se o inicializador está instalado no dispositivo de um usuário?

Infelizmente, não, e no momento não temos tal funcionalidade.

A instalação do inicializador falha quando o instalador da web está executando um instalador independente. Como posso corrigir isso?

Algumas das soluções mais populares desse recurso são:

• Tente alterar o diretório de instalação.
• Se alterar o diretório no drive atual não funcionar, tente instalar o inicializador em um drive diferente.
• Desative seu antivírus, reinicie seu computador e então tente instalar o inicializador.
• Tente instalar o inicializador através de um instalador offline.

Como posso obter um instalador offline?

1. Vá para a página Launcher build na Conta de Distribuidor.
2. Selecione uma compilação rascunho ou publicada.
3. Selecione um sistema operacional e clique em Get a link to a stand-alone installer.

Estou me deparando com o erro "Sua conexão com a internet não parece ser permitida ou foi interrompida". Como posso corrigir isso?

Tente desativar seu antivírus e firewall, reinicie seu computador e tente novamente.

Inicialização de jogos

O jogo exige que o Xsolla Launcher esteja funcionando para funcionar?

Xsolla Launcher está sempre em execução. Quando é usado para iniciar o jogo, ele fica oculto na bandeja do sistema para não consumir recursos. Um jogador pode encerrar o processo do Xsolla Launcher sem interromper o jogo, pois não há conexão durante a sessão de jogo.

Existe uma solução para conectar PCs na mesma LAN via conexão P2P, de modo que os dados só seriam transferidos dentro desta LAN?

Não, não há essa solução por enquanto.

Quando um usuário inicia um jogo no inicializador, existe alguma maneira de passar a informação de login ao jogo?

Sim. O inicializador passa o JWT como argumento da linha de comando.

Eu quero configurar uma versão de produção do inicializador e ter múltiplos ramos de teste para o meu jogo. Quantos ambientes você suporta?

No momento, cada jogo só pode ter uma compilação do inicializador. Você pode usar outra compilação de jogo para a versão de rascunho do inicializador, mas ela não pode ser compartilhada com outros usuários finais.

O antivírus mostra uma janela de aviso ou bloqueia o download quando um usuário baixa o jogo. Como posso corrigir isso?

Essa é uma reação falso-positivo do antivírus ao download via P2P (peer-to-peer). O inicializador utiliza conexões P2P para baixar os arquivos do jogo, então ele se conecta a outros usuários através de um endereço IP público compartilhado que é usado por múltiplos usuários ou sites.
Se você estiver usando um software Malwarebytes, consulte o comentário oficial deles a respeito desse assunto.
Para corrigir esse erro, o usuário deve acessar as configurações do inicializador e desativar a opção de rede Usar P2P (peer-to-peer).

Você suporta a execução de jogos de navegador no inicializador?

Sim, para configurar a inicialização de jogos de navegadores consulte a instrução.

É possível adicionar argumentos adicionais para o arquivo executável do jogo usar?

No momento, o nosso sistema não suporta essa funcionalidade. Você pode fazer um script que inicializará um jogo com os argumentos necessários e especificar o script como arquivo executável na Conta de Distribuidor.

Eu me deparo com o erro "Arquivos de jogo em falta ou danificados" ao executar o jogo no inicializador. Como posso corrigir isso?

1. Confira se o arquivo executável está definido na Conta de Distribuidor.
2. Confira se o nome e o trajeto relativo ao arquivo executável estão configurados corretamente.
3. Certifique-se de usar a compilação de inicializador de rascunho para ver alterações em tempo real. Se você estiver usando a compilação do inicializador publicada, certifique-se de que uma nova versão tenha sido gerada e publicada.

Posso fornecer chaves grátis aos jogadores que já possuem o jogo em outras plataformas (ex.: Steam, Epic Games) para transferi-los à plataforma Xsolla?

Você pode selecionar qualquer quantidade de chaves de jogo da seção Store da Conta de Distribuidor e enviá-las manualmente por e-mail aos usuários. Os usuários poderão resgatar essas chaves no inicializador.

Posso atualizar um arquivo SFX como arquivo redistribuível?

É possível se o arquivo SFX estiver preparado como arquivo EXE.

Quando que um arquivo redistribuível é instalado?

Redistribuíveis são instalados apenas durante a instalação do jogo. Quando o jogo é atualizado ou reparado, os redistribuíveis não são reinstalados.

Existe a possibilidade de adicionar conquistas ao inicializador?

O inicializador não possui o recurso de conquistas no momento.

A loja do jogo no inicializador suporta cupons?

Nós suportamos códigos promocionais apenas no carrinho de compras da loja.

Posso vender assinaturas pelo inicializador?

No momento, o inicializador não suporta assinaturas. Avise-nos caso deseje essa funcionalidade.

O Inicializador suporta modificações de jogos?

No momento, o Inicializador não suporta modificações de jogos. Avise-nos caso deseje essa funcionalidade.

A migração do Inicializador v 2.x para o Inicializador v 3.x

Posso criar uma solicitação de recurso no Inicializador 2.x?

Apenas aceitamos solicitações de recursos para o Inicializador 3.x. agora.

Posso baixar o Inicializador do GitHub e configurá-lo via arquivos de configuração?

O GitHub foi usado apenas no Inicializador versão 2.x. Para o Inicializador v3.x, todas as configurações estão disponíveis na Conta de Distribuidor.

As notícias do Inicializador 2.x são automaticamente transferidas aos títulos de conteúdo no Inicializador 3.x?

No momento, o Inicializador não possui tal funcionalidade. Esses são 2 sistemas de notícias separados.

Abas

Os usuários recebem o erro "Tente novamente" ao abrir uma aba no inicializador. Como posso corrigir isso?

Possíveis motivos: seu site retorna o x-frame-options: SAMEORIGIN que bloqueia a exibição do site no inicializador. Remova o cabeçalho x-frame-options e adicione o cabeçalho Content-Security-Policy: frame-ancestors file://*.

Propriedade e chaves

Como os usuários do Xsolla Launcher podem acessar os jogos? Os jogos podem ser distribuídos por meio de assinaturas, cupons ou códigos promocionais?

No momento, o acesso aos jogos está disponível apenas com chaves de jogos. Planejamos adicionar assinaturas ao Xsolla Launcher em 2024.

Os usuários do Xsolla Launcher podem baixar atualizações de jogos se não tiverem nenhuma chave de jogo comprada?

Não. Jogos e atualizações não estão disponíveis sem a compra de chaves de jogo. Caso você tenha jogos free-to-play, pode ser possível.

O que acontece com o acesso do usuário ao jogo se o usuário fizer um reembolso?

O usuário perde o acesso ao jogo, mas poderá o jogo novamente pelo Xsolla Launcher usando o botão Buy.Última atualização: 21 de Fevereiro de 2024