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.
Para transferir datos al lanzador, se utiliza la funcionalidad ampliada de una contraseña de un solo uso (el escenario básico se describe en las instrucciones).

¿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:

  1. Recuperación de una contraseña de un solo uso.
  2. Añadir la contraseña de un solo uso al nombre del instalador.
  3. 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 URL https://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ámetro common_payload en el formato tiempo Unix, en milisegundos. Obligatorio si se está transmitiendo common_payload.
Ejemplo de solicitud para obtener una contraseña de un solo uso:
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"
    
    Nota
    Si se utilizan los parámetros tracking_payload, common_payload o expires_in, sus valores no pueden quedar vacíos.
    Tambien puede transmitir el tracking_payload como un parámetro de consulta.
    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"
      

      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ámetro tracking_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
      Full screen
      Small screen
        game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=
        
        Nota
        El lanzador envía datos del usuario al juego cada vez que se inicia el juego.
        Al lanzar un juego de navegador, el lanzador transmite los datos recibidos en el parámetro tracking_payload como valor del parámetro de consulta tracking_payload, tal y como se muestra en el siguiente ejemplo.
        Copy
        Full screen
        Small screen
          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!
          ¿Hay algo en lo que podamos mejorar? Mensaje
          Lo sentimos
          Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
          ¡Gracias por tu mensaje!
          Nos ayudará a mejorar tu experiencia.
          Última actualización: 24 de Septiembre de 2024

          ¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

          Informar de un problema
          Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
          Déjanos tu correo electrónico para que te podamos responder
          ¡Gracias por tu mensaje!