Como transferir os dados do usuário pelo instalador do inicializador

Como funciona

Você pode transferir os dados do usuário no site para o jogo através do instalador do inicializador. Por exemplo:

  • Informação para rastrear promoções ou a fonte de download do instalador do inicializador.
  • Dados com uma validade limitada. Utilizado para a autenticação personalizada no jogo e para transferir informações críticas relacionadas ao jogo.
Para transferir os dados ao inicializador, é utilizada uma funcionalidade estendida de uma senha única (o cenário básico é descrito nas instruções).

Quem pode usar

Parceiros que já integraram o Launcher e o Login e conectaram a autenticação OAuth 2.0.

Como obtê-lo

Para ativar a transferência de dados do usuário, implemente o seguinte:

  1. Recuperação de uma senha única.
  2. Adição de uma senha única no nome do instalador.
  3. Processamento de dados do usuário transmitidos ao jogo (opcional).

Recuperação de uma senha única

Para implementar a obtenção de uma senha única, faça uma solicitação POST ao endereço URL https://launcher.xsolla.com/otp. No corpo da solicitação, passe um JSON com os seguintes parâmetros:
  • tracking_payload — dados do usuário sem validade limitada. O tamanho máximo da cadeia é de 255 caracteres.
  • common_payload — Dados do usuário com validade limitada. Esses dados podem ser sobrescritos. O comprimento máximo da cadeia é de 255 caracteres.
  • expires_in — a validade dos dados passados no parâmetro common_payload no formato Unix time, em milissegundos. Obrigatório se common_payload for transmitido.
Exemplo de solicitação para obter uma senha única:
Copy
Full screen
Small screen
    curl
    -X POST
    "https://launcher.xsolla.com/otp?common_payload=<common_payload>"
    -H
    "accept: application/json"
    -H
    "Content-Type: application/json"
    
    Observação
    Se os parâmetros tracking_payload, common_payload ou expires_in forem utilizados, seus valores não podem estar vazios.
    Você também pode passar o tracking_payload como parâmetro de solicitação.
    Copy
    Full screen
    Small screen
      curl -X POST "https://launcher.xsolla.com/otp?tracking_payload=<tracking_payload>" -H "accept: application/json" -H "Content-Type: application/json"
      

      Adição da senha de uso único ao nome do inicializador

      A senha de uso único recebida é uma cadeia de caracteres de 36 caracteres no formato UUID. Implemente a adição da senha de uso único ao nome do arquivo de instalação ao fazer o download no seguinte formato: LauncherName_<OTP>.exe, onde <OTP> é a senha de uso único.

      Recuperação de dados do usuário pelo jogo

      O inicializado passa os dados recebidos no parâmetro tracking_payload como o valor do argumento –tracking_payload da linha de comando, como demonstrado no exemplo abaixo. Ele também confere a presença e validade dos dados passados no parâmetro common_payload e os passa como o valor do argumento –xsolla-common-payload da linha de comando, como demonstrado no exemplo abaixo.
      Copy
      Full screen
      Small screen
        game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=
        
        Observação
        O inicializador envia os dados do usuário para o jogo toda vez que o jogo é iniciado.
        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.
        Avalie esta página
        Avalie esta página
        Podemos melhorar alguma coisa?

        Não quero responder

        Obrigado pelo seu feedback!
        Última atualização: 9 de Novembro 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!