Cómo transferir datos de usuario a través del instalador del lanzador
Cómo funciona
Puede transferir datos de usuario del sitio web al juego a través del instalador del lanzador, por ejemplo:
- Información para hacer seguimiento de promociones o el origen de la descarga del instalador del lanzador.
- Datos con una vida útil limitada. Utilizados para la autenticación personalizada en el juego y la transferencia de información crítica relativa al juego.
¿Quién puede utilizarlo?
Socios que ya han integrado Launcher y Login, y han conectado la autenticación OAuth 2.0.
Cómo conseguirlo
Para posibilitar la transferencia de datos de usuario, implemente los siguientes pasos:
- Recuperación de una contraseña de un solo uso.
- Añadir la contraseña de un solo uso al nombre del instalador.
- Procesamiento de los datos de usuario transmitidos al juego (opcional).
Recuperación de una contraseña de un solo uso
Para implementar la obtención de una contraseña de un solo uso, haga una solicitud POST a la dirección URLhttps://launcher.xsolla.com/otp
. En el cuerpo de la solicitud, transmita un JSON con los siguientes parámetros:tracking_payload
- datos de usuario con una vida útil ilimitada. La longitud máxima de la cadena (string) es de 255 caracteres.common_payload
- datos de usuario con una vida útil limitada. Estos datos pueden sobrescribirse. La longitud máxima de la cadena es de 255 caracteres.expires_in
- la vida útil de los datos transmitidos en el parámetrocommon_payload
en el formato tiempo Unix, en milisegundos. Obligatorio si se está transmitiendocommon_payload
.
Copy
curl
-X POST
"https://launcher.xsolla.com/otp?common_payload=<common_payload>"
-H
"accept: application/json"
-H
"Content-Type: application/json"
Nota
Si se utilizan los parámetros
tracking_payload
, common_payload
o expires_in
, sus valores no pueden quedar vacíos.tracking_payload
como un parámetro de consulta.Copy
curl -X POST "https://launcher.xsolla.com/otp?tracking_payload=<tracking_payload>" -H "accept: application/json" -H "Content-Type: application/json"
Agregar la contraseña de un solo uso al nombre del instalador
La contraseña de un solo uso recibida es un string de 36 caracteres en formato UUID. Añada la contraseña de un solo uso al nombre del archivo de instalación cuando realice la descarga con el siguiente formato:LauncherName_<OTP>.exe
, en el cual <OTP>
es la contraseña de un solo uso.Recuperación de los datos de usuario realizada por el juego
El lanzador transmite los datos recibidos en el parámetrotracking_payload
como valor del argumento de línea de comandos –tracking_payload
, como se muestra en el siguiente ejemplo. También comprueba la presencia y vida útil de los datos transmitidos en el parámetro common_payload
y los transmite como el valor del argumento de línea de comandos –xsolla-common-payload
, como se muestra en el siguiente ejemplo.Copy
game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=
Nota
El lanzador envía datos del usuario al juego cada vez que se inicia el juego.
tracking_payload
como valor del parámetro de consulta tracking_payload
, tal y como se muestra en el siguiente ejemplo.Copy
https://web-game-plum.vercel.app/api?locale=en&tracking_payload=<tracking_payload>
El parámetro tracking_payload
se transmite en codificación UTF-8. Para descodificarlo, ejecute la función decodeURIComponent(<tracking_payload>)
en el lado del juego.
¿Te ha resultado útil este artículo?
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.