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
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.
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.
- Implemente a lógica de autorização do Launcher em seu aplicativo.
- Crie uma compilação do aplicativo e envie-a ao Launcher.
Implemente a lógica para a autenticação via o Launcher
Esse é o fluxo para autorização no aplicativo via Launcher:
- O usuário está autorizado no Launcher.
- O usuário instala e executa o aplicativo.
- 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
. - O aplicativo processa os parâmetros da linha de comando e obtém um token.
- O aplicativo valida o token recebido.
- 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:
- C#
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
- Vá para seu projeto Unity.
- 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).
- Execute a cena de autorização do usuário, onde o token é processado.
- Clique em
File > Build settings no menu principal e então clique emAdd Open Scenes . Verifique se a cena de autorização foi adicionada primeiro na lista. - Clique em
Build . - Na janela pop-up, especifique o caminho para o diretório onde a compilação concluída será colocada.
A autenticação nativa permite que os jogadores entrem em seu aplicativo através do aplicativo Steam instalado.
Para configurar a autenticação nativa:
- Configure a autenticação silenciosa pelo Steam na Conta de Distribuidor.
- Configure seu projeto Unity.
- Implemente a lógica para a autenticação pelo Steam.
- Garanta a autenticação via Steam.
Configure seu projeto Unity
Assets/Xsolla/ThirdParty/Steamworks.NET
.- Abra o arquivo
steam_appid.txt
, que se encontra na pasta raiz do projeto Unity. - 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. - 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. Passesteam
como um valor.appId
— seu ID de aplicativo no Steam. O valor deve corresponder ao valor especificado no arquivosteam_appid.txt
.sessionTicket
— Ticket de sessão do Steam. Para obtê-lo, chame o métodoSteamUtils.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:
- C#
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
- 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
. - 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.
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.