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

Настройка совместной работы SDK и Лаунчера

1. Настройте Лаунчер в Личном кабинете.

2. Кастомизируйте интерфейс лаунчера.

3. Реализуйте в вашем приложении логику авторизации через Лаунчер.
4. Сгенерируйте установочный файл лаунчера и архив с его сборкой.
5. Создайте сборку приложения.
6. Загрузите сборку приложения на сервер обновлений Иксоллы.

Реализация логики авторизации через Лаунчер

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

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

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

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

1. Откройте ваш проект Unreal Engine.
2. В Content Browser откройте карту авторизации пользователя, в которой выполняется обработка токена.
3. В главном меню выберите пункт Edit > Project Settings.
4. Перейдите в раздел Project > Maps & Modes и в поле Game Default Map выберите ранее открытую карту авторизации.

5. Перейдите в раздел Plugins > Xsolla Settings.
6. В поле Project ID укажите ID проекта, который можно найти в разделе Настройки проекта > ID проекта Личного кабинета.
7. В поле Login ID укажите ID варианта авторизации, который можно найти в разделе Лаунчер > Общие настройки > Настройки аутентификации Личного кабинета.
8. В главном меню выберите пункт File > Package Project > Windows (64 bit) или File > Package Project > Mac, в зависимости от платформы, для которой создается сборка.
9. Во всплывающем окне укажите путь к директории, в которую будет помещена готовая сборка.

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

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

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

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

1. Перейдите в каталог Config вашего проекта Unreal Engine.
2. Добавьте строки ниже в файл DefaultEngine.ini, для параметра SteamDevAppId укажите ID вашего приложения в Steam.

[/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"

3. Откройте проект в Unreal Editor.
4. Перейдите в Settings > Plugins > Online Platform.
5. В разделе Online Subsystem Steam установите флажок Enabled и нажмите кнопку Restart Now, чтобы сохранить настройки и перезапустить Unreal Editor.

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

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

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

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

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

1. Создайте сборку вашего проекта Unreal Engine для stand-alone платформы.
2. Запустите приложение Steam и авторизуйтесь в нем.
3. Запустите ваше приложение. Если настройка выполнена правильно, откроется всплывающее окно Steam.