Как передавать данные пользователя через установщик лаунчера
Как это работает
Вы можете передавать данные пользователя с сайта в игру через установщик лаунчера, например:
- Информацию для отслеживания акций или источника скачивания установщика лаунчера.
- Данные с ограниченным сроком жизни. Используются для собственной авторизации в игре, передачи критичной для игры информации.
Для кого подходит
Для партнеров, у которых уже подключены продукты Launcher и Login, подключивших аутентификацию по протоколу OAuth 2.0.
Как настроить
Чтобы авторизация пользователя в лаунчере выполнялась автоматически, реализуйте:
- Получение одноразового пароля на вашем сайте.
- Добавление одноразового пароля в название установщика лаунчера.
- Обработку игрой передаваемых данных о пользователе (опционально).
Получение одноразового пароля
Чтобы реализовать получение одноразового пароля, реализуйте вызов запроса POST на URL-адресhttps://launcher.xsolla.com/otp
. В теле запроса передайте JSON со следующими параметрами: tracking_payload
— данные пользователя, которые имеют неограниченный срок жизни. Максимальная длина строки — 255 символов.common_payload
— данные пользователя, которые имеют ограниченный срок жизни. Эти данные можно перезаписывать. Максимальная длина строки — 255 символов.expires_in
— срок жизни данных, переданных в параметреcommon_payload
, в формате Unix time в миллисекундах. Обязательный, если передаетсяcommon_payload
.
Copy
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
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
game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=
Примечание
Лаунчер отправляет данные пользователя в игру при каждом запуске игры.
tracking_payload
, в значении query-параметра tracking_payload
, как показано в примере ниже.Copy
https://web-game-plum.vercel.app/api?locale=en&tracking_payload=<tracking_payload>
Параметр tracking_payload
передается в кодировке UTF-8, для его декодирования реализуйте запуск функции decodeURIComponent(<tracking_payload>)
на стороне игры.
Была ли статья полезна?
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.