SDK для Unreal Engine / Аутентификация в приложении через установщик
  На главную

SDK для Unreal Engine

Аутентификация в приложении через установщик

Если вы используете для доставки вашего приложения пользователям Xsolla Launcher или Steam, вы можете аутентифицировать пользователя автоматически, используя учетные данные из установщика.

Инструкции

Узнайте о дополнительных настройках из наших инструкций.

Как настроить авторизацию в приложении через Launcher

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

Внимание

Для использования Launcher должен быть настроен продукт Login. Использование другой системы авторизации не поддерживается.

SDK для работы с магазином использует IGS & BB API, Launcher использует собственный API, поэтому SDK не поддерживает работу с магазином Launcher.

Чтобы настроить сквозную аутентификации пользователя:
  1. Реализуйте в вашем приложении логику аутентификации через Launcher.
  2. Создайте сборку приложения и загрузите ее в Launcher.
Примечание
Подробная информация о настройках Launcher и загрузке сборки приложения приведена в руководстве по интеграции.

Реализация логики авторизации через Launcher

Сценарий авторизации в приложении через Launcher:

  1. Пользователь авторизуется в Launcher.
  2. Пользователь устанавливает и запускает приложение.
  3. Launcher запускает приложение с передачей параметров пользователя через командную строку. Токен для авторизации передается в параметре xsolla-login-token.
  4. Приложение обрабатывает параметры командной строки и получает токен.
  5. Приложение валидирует полученный токен.
  6. Приложение автоматически авторизует пользователя, не отображая страницу авторизации.

Пример реализации описанной логики приведен в блупринте W_LoginDemo демопроекта.

Примечание
Полученный токен используется методами SDK для открытия внутриигрового магазина, проведения платежа и других операций.

Создание сборки приложения

  1. Откройте проект Unreal Engine.
  2. Убедитесь, что в настройках SDK указан ID варианта авторизации, который указан в Личном кабинете в настройках Launcher (раздел Launcher > Общие настройки > Настройки аутентификации).
  3. В Content Browser откройте карту авторизации пользователя, в которой выполняется обработка токена.
  4. В главном меню выберите пункт Edit > Project Settings.
  5. Перейдите в раздел Project > Maps & Modes и в поле Game Default Map выберите ранее открытую карту авторизации.

  1. В главном меню выберите пункт File > Package Project > Windows (64 bit) или File > Package Project > Mac, в зависимости от платформы, для которой создается сборка.
  2. Во всплывающем окне укажите путь к директории, в которую будет помещена готовая сборка.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Скрыть

Как подключить нативную аутентификацию через Steam

Нативная авторизация позволяет игрокам войти в ваше приложение через установленный клиент Steam. После подключения нативной авторизации вы также можете добавить в приложение оплату через Steam.

Чтобы настроить нативную авторизацию:

  1. Подключите автоматическую аутентификацию через Steam в Личном кабинете.
  2. Настройте проект Unreal Engine.
  3. Настройте обработку событий.
  4. Проверьте авторизацию через Steam.

Настройка проекта Unreal Engine

  1. Перейдите в каталог Config проекта Unreal Engine.
  2. Добавьте строки ниже в файл DefaultEngine.ini, для параметра SteamDevAppId укажите ID вашего приложения в Steam.
Copy
Full screen
Small screen
    [/Script/Engine.GameEngine]
    +NetDriverDefinitions=(DefName="GameNetDriver",DriverClassName="OnlineSubsystemSteam.SteamNetDriver",DriverClassNameFallback="OnlineSubsystemUtils.IpNetDriver")
    
    [OnlineSubsystem]
    DefaultPlatformService=Steam
    
    [OnlineSubsystemSteam]
    bEnabled=true
    SteamDevAppId=480
    
    [/Script/OnlineSubsystemSteam.SteamNetDriver]
    NetConnectionClassName="OnlineSubsystemSteam.SteamNetConnection"
    
    1. Откройте проект в Unreal Editor.
    2. Перейдите в Settings > Plugins > Online Platform.
    3. В разделе Online Subsystem Steam установите флажок Enabled и нажмите кнопку Restart Now, чтобы сохранить настройки и перезапустить Unreal Editor.

    Настройка обработки событий

    1. Для проекта добавьте ноды, как показано ниже:

      Для авторизации пользователя через Steam необходимо получить session ticket с помощью метода GetSessionTicket. Полученное значение необходимо передать при вызове метода AuthenticateWithSessionTicket. В результате вы получите токен, который можно использовать при вызове API.

    1. Для дополнительной проверки токена добавьте вызов метода ValidateToken (опционально).

    Проверка авторизации через Steam

    1. Создайте сборку проекта Unreal Engine для stand-alone платформы.
    2. Запустите приложение Steam и авторизуйтесь в нем.
    3. Запустите ваше приложение. Если настройка выполнена правильно, откроется всплывающее окно Steam.
    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Скрыть
    Последнее обновление: 10 октября 2023

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

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