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.
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:
- Recuperação de uma senha única.
- Adição de uma senha única no nome do instalador.
- 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 URLhttps://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âmetrocommon_payload
no formato Unix time, em milissegundos. Obrigatório secommon_payload
for transmitido.
Copy
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.tracking_payload
como parâmetro de solicitação.Copy
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âmetrotracking_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
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.
tracking_payload
como valor do parâmetro de pesquisa tracking_payload
, como exibido no exemplo abaixo.Copy
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 pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.