Launcher / Как передавать данные пользователя через установщик лаунчера
  На главную

Launcher

Как передавать данные пользователя через установщик лаунчера

Как это работает

Вы можете передавать данные пользователя с сайта в игру через установщик лаунчера, например:

  • Информацию для отслеживания акций или источника скачивания установщика лаунчера.
  • Данные с ограниченным сроком жизни. Используются для собственной авторизации в игре, передачи критичной для игры информации.
Для передачи данных в лаунчер используется расширенная функциональность одноразового пароля (базовый сценарий описан в инструкции).

Для кого подходит

Для партнеров, у которых уже подключены продукты Launcher и Login, подключивших аутентификацию по протоколу OAuth 2.0.

Как настроить

Чтобы авторизация пользователя в лаунчере выполнялась автоматически, реализуйте:

  1. Получение одноразового пароля на вашем сайте.
  2. Добавление одноразового пароля в название установщика лаунчера.
  3. Обработку игрой передаваемых данных о пользователе (опционально).

Получение одноразового пароля

Чтобы реализовать получение одноразового пароля, реализуйте вызов запроса POST на URL-адрес https://launcher.xsolla.com/otp. В теле запроса передайте JSON со следующими параметрами: 
  • tracking_payload — данные пользователя, которые имеют неограниченный срок жизни. Максимальная длина строки — 255 символов.
  • common_payload — данные пользователя, которые имеют ограниченный срок жизни. Эти данные можно перезаписывать. Максимальная длина строки — 255 символов.
  • expires_in — срок жизни данных, переданных в параметре common_payload, в формате Unix time в миллисекундах. Обязательный, если передается common_payload.
Пример запроса для получения одноразового пароля:
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"
    
    Примечание
    Если параметры tracking_payload, common_payload или expires_in используются, их значения не могут быть пустыми.
    Также tracking_payload можно передать в виде query-параметра:
    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"
      

      Добавление одноразового пароля в название установщика лаунчера

      Полученный одноразовый пароль представляет собой строку из 36 символов в формате UUID. Реализуйте добавление одноразового пароля в название установочного файла при скачивании в следующем формате: LauncherName_<OTP>.exe, где <OTP> — одноразовый пароль пользователя.

      Получение данных игрой

      Лаунчер передает данные, полученные в параметре tracking_payload, в значении аргумента командной строки –tracking_payload. Лаунчер также проверяет наличие и срок жизни данных, переданных в параметре common_payload, и передает их в значении аргумента командной строки –xsolla-common-payload как показано в примере ниже.
      Copy
      Full screen
      Small screen
        game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=
        
        Примечание
        Лаунчер отправляет данные пользователя в игру при каждом запуске игры.
        При запуске браузерной игры лаунчер передает данные, полученные в параметре tracking_payload, в значении query-параметра tracking_payload, как показано в примере ниже.
        Copy
        Full screen
        Small screen
          https://web-game-plum.vercel.app/api?locale=en&tracking_payload=<tracking_payload>
          

          Параметр tracking_payload передается в кодировке UTF-8, для его декодирования реализуйте запуск функции decodeURIComponent(<tracking_payload>) на стороне игры.

          Была ли статья полезна?
          Спасибо!
          Что может сделать страницу еще лучше? Сообщение
          Жаль, что так произошло
          Расскажите, почему статья не была полезна. Сообщение
          Спасибо за обратную связь!
          Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
          Последнее обновление: 24 сентября 2024

          Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

          Сообщите о проблеме
          Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
          Укажите email-адрес, чтобы мы могли связаться с вами
          Спасибо за обратную связь!