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.
Solicitação de exemplo por 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.
        Ao inicializar um jogo de navegador, o inicializador passa os dados recebidos no parâmetro tracking_payload como valor do parâmetro de pesquisa tracking_payload, como exibido no exemplo abaixo.
        Copy
        Full screen
        Small screen
          https://web-game-plum.vercel.app/api?locale=en&tracking_payload=<tracking_payload>
          

          O parâmetro tracking_payload é passado na codificação UTF-8. Para decodificá-lo, implemente a execução da função decodeURIComponent(<tracking_payload>) no lado do jogo.

          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.
          Última atualização: 24 de Setembro 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!