Лаунчер / Инструкции

Как подключить бесшовную авторизацию

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

Если пользователь авторизовался на сайте, распространяющем лаунчер, вход в аккаунт лаунчера выполняется автоматически. Более того, вы можете передавать данные пользователя с сайта в игру через лаунчер.

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

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

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

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

Чтобы реализовать получение одноразового пароля:

  • Если вы используете Авторизацию Иксолла, реализуйте вызов запроса POST на URL-адрес https://launcher.xsolla.com/otp. В теле запроса передайте JSON со следующими параметрами:
    • refresh_token — токен обновления.
    • access_token — токен доступа.
    • tracking_payload — данные пользователя, которые необходимо передать в игру. Максимальная длина строки — 255 символов.

Примечание
Если параметр tracking_payload используется, его значение не может быть пустым.
Внимание
Данная функциональность доступна, только если вы подключили аутентификацию по протоколу OAuth 2.0.

Пример запроса для получения одноразового пароля при использовании Авторизации Иксолла:

Copy
Full screen
Small screen

    curl -X POST "https://launcher.xsolla.com/otp" -H  "accept: application/json" -H  "Content-Type: application/json" -d "{  \"access_token\": \"string\",  \"refresh_token\": \"string\",  \"tracking_payload\": \"string\"}"

    • Если вы не используете Авторизацию Иксолла, отправьте данные пользователя, которые необходимо передать в игру, в query-параметре tracking_payload. Максимальная длина строки — 255 символов.

    Пример запроса для получения одноразового пароля, если Авторизация Иксолла не используется:

    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"

      Примечание
      Если параметр tracking_payload используется, его значение не может быть пустым.

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

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

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

      Лаунчер передает данные, полученные в параметре tracking_payload, в значении аргумента командной строки --tracking_payload, как показано в примере ниже.

      Copy
      Full screen
      Small screen

        game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=

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

        В другой раз

        Спасибо за обратную связь!
        Последнее обновление: 4 февраля 2021

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

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