SDK para Unity (PC, web) / Autenticação via inicializador de aplicativos
  Voltar aos Documentos

SDK para Unity (PC, web)

Autenticação via inicializador de aplicativos

Se você usar o Xsolla Launcher ou o Steam para entregar seu aplicativo aos usuários, você pode autenticar automaticamente o usuário usando as credenciais do Inicializador.

Guias

Saiba mais sobre configurações avançadas em nossos guias.

Como configurar a autenticação no aplicativo via o Launcher

Você pode usar o Xsolla Launcher para entregar seu aplicativo aos usuários e atualizá-lo. O Launcher contém uma ferramenta de autorização interna. Para evitar reinserir o nome de usuário e senha, configure a autorização em seu aplicativo por meio do Launcher.

Aviso

Para usar o Launcher, você precisa configurar o Login. Não há suporte para sistemas de autorização diferentes.

O SDK utiliza a IGS API para trabalhar com a loja. O Launcher usa sua própria API, de forma que o SDK não suporta trabalhar com a loja do Launcher.

Para configurar a autenticação ponta a ponta do usuário:
  1. Implemente a lógica de autorização do Launcher em seu aplicativo.
  2. Crie uma compilação do aplicativo e envie-a ao Launcher.
Observação
Você pode encontrar informações detalhadas sobre as configurações do Launcher e o envio da compilação do aplicativo no guia de integração.

Implemente a lógica para a autenticação via o Launcher

Esse é o fluxo para autorização no aplicativo via Launcher:

  1. O usuário está autorizado no Launcher.
  2. O usuário instala e executa o aplicativo.
  3. O Launcher executa o aplicativo e passa os parâmetros do usuário através da linha de comando. O token de autorização é passado no parâmetro xsolla-login-token.
  4. O aplicativo processa os parâmetros da linha de comando e obtém um token.
  5. O aplicativo valida o token recebido.
  6. O aplicativo autoriza automaticamente o usuário sem exibir uma página de autorização.

Para implementar a lógica descrita, use o método SDK AuthViaXsollaLauncher.

Exemplo de um script para autenticação via o Launcher:

Copy
Full screen
Small screen
using UnityEngine;
using Xsolla.Auth;
using Xsolla.Core;

namespace Xsolla.Samples.Authorization
{
	public class AuthorizationViaXsollaLauncher : MonoBehaviour
	{
		private void Start()
		{
			// Start authorization via Xsolla Launcher
			// Pass callback functions for success and error cases
			XsollaAuth.AuthViaXsollaLauncher(OnSuccess, OnError);
		}

		private void OnSuccess()
		{
			Debug.Log("Authorization successful");
			// Add actions taken in case of success
		}

		private void OnError(Error error)
		{
			Debug.LogError($"Authorization failed. Error: {error.errorMessage}");
			// Add actions taken in case of error
		}
	}
}

Crie uma compilação do aplicativo

  1. Vá para seu projeto Unity.
  2. Certifique-se de que as configurações do SDK indicam o ID do projeto Login especificado em sua Conta de Distribuidor nas configurações do Launcher (Launcher > General settings > Authentication).

  1. Execute a cena de autorização do usuário, onde o token é processado.
  2. Clique em File > Build settings no menu principal e então clique em Add Open Scenes. Verifique se a cena de autorização foi adicionada primeiro na lista.
  3. Clique em Build.
  4. Na janela pop-up, especifique o caminho para o diretório onde a compilação concluída será colocada.
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.
Ocultar

Como configurar a autenticação nativa via Steam

A autenticação nativa permite que os jogadores entrem em seu aplicativo através do aplicativo Steam instalado.

Para configurar a autenticação nativa:

  1. Configure a autenticação silenciosa pelo Steam na Conta de Distribuidor.
  2. Configure seu projeto Unity.
  3. Implemente a lógica para a autenticação pelo Steam.
  4. Garanta a autenticação via Steam.

Configure seu projeto Unity

Observação
O SDK usa a biblioteca Steamworks.NET para interagir com o Steam, que vem com o SDK e se encontra no diretório Assets/Xsolla/ThirdParty/Steamworks.NET.
  1. Abra o arquivo steam_appid.txt, que se encontra na pasta raiz do projeto Unity.
  2. Especifique o ID do aplicativo no Steam no arquivo e salve as alterações. O valor padrão no arquivo é 480, que é a ID do projeto de teste do Steam.
  3. Reinicie o Unity Editor para que as alterações entrem em vigor.

Implemente a lógica para a autenticação via Steam

Para iniciar a autenticação, use o método SDK SilentAuth e passe os seguintes parâmetros para ele:

  • providerName — a plataforma de publicação do aplicativo. Passe steam como um valor.
  • appId — seu ID de aplicativo no Steam. O valor deve corresponder ao valor especificado no arquivo steam_appid.txt.
  • sessionTicket — Ticket de sessão do Steam. Para obtê-lo, chame o método SteamUtils.GetSteamSessionTicket().
  • onSuccess — retorno de chamada de autenticação de usuário bem-sucedido.
  • onError — retorno de chamada de erro.

Exemplo de um script para autenticação via Steam:

Copy
Full screen
Small screen
using UnityEngine;
using Xsolla.Auth;
using Xsolla.Core;

namespace Xsolla.Samples.Steam
{
	public class SteamNativeAuthorization : MonoBehaviour
	{
		private void Start()
		{
			// Get the steam session ticket from `SteamUtils` class
			var steamSessionTicket = SteamUtils.GetSteamSessionTicket();

			// Start silent authentication
			// Pass `steam` as `providerName` parameter
			// Pass your `Steam App ID` as `appId` parameter. We use `480` as an example
			// Pass `steamSessionTicket` variable as the `sessionTicket` parameter
			// Pass callback functions for success and error cases
			XsollaAuth.SilentAuth("steam", "480", steamSessionTicket, OnSuccess, OnError);
		}

		private void OnSuccess()
		{
			Debug.Log("Authorization successful");
			// Add actions taken in case of success
		}

		private void OnError(Error error)
		{
			Debug.LogError($"Authorization failed. Error: {error.errorMessage}");
			// Add actions taken in case of error
		}
	}
}

Garanta a autenticação via Steam

  1. Inicie o Steam e faça login. Caso contrário, a função de retorno de chamada será chamada com o erro Requested steam session ticket is null. Please check your Steam settings.
  2. Crie a compilação do seu projeto Unity como plataforma autônoma e execute-a ou inicie uma cena no editor Unity. Se tudo estiver correto, sua conta estará conectada automaticamente ao aplicativo.
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.
Ocultar
Última atualização: 10 de Outubro de 2023

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!