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

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

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

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

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

Для партнеров, у которых уже подключены продукты 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.

1curl -X POST "https://launcher.xsolla.com/otp?common_payload=<common_payload>" \
2  -H "accept: application/json" \
3  -H "Content-Type: application/json"

1curl -X POST "https://launcher.xsolla.com/otp?tracking_payload=<tracking_payload>" \
2  -H "accept: application/json" \
3  -H "Content-Type: application/json"

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

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

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

Лаунчер передает данные, полученные в параметре tracking_payload, в значении аргумента командной строки –tracking_payload. Лаунчер также проверяет наличие и срок жизни данных, переданных в параметре common_payload, и передает их в значении аргумента командной строки –xsolla-common-payload как показано в примере ниже.

1game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=

1https://web-game-plum.vercel.app/api?locale=en&tracking_payload=<tracking_payload>

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