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

SDK для Unity

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

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

Инструкции

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

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

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

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

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

  1. Настройте Лаунчер в Личном кабинете.
Примечание
В файле config.json достаточно изменить значения для следующих объектов:
  • launcher_project_id — укажите ID лаунчера, который можно найти в разделе Лаунчер > Общие настройки > Общая информация Личного кабинета;
  • login_project_id — укажите ID варианта авторизации, который можно найти в разделе Лаунчер > Общие настройки > Настройки аутентификации Личного кабинета.
  1. Кастомизируйте интерфейс лаунчера.
Внимание
При интеграции SDK с серверами Иксоллы используется IGS & BB API, поэтому магазин Лаунчера не поддерживается.
  1. Реализуйте в вашем приложении логику авторизации через Лаунчер.
  2. Сгенерируйте установочный файл лаунчера и архив с его сборкой.
  3. Создайте сборку приложения.
  4. Загрузите сборку приложения на сервер обновлений Иксоллы.

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

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

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

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

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

  1. Откройте ваш проект Unity.
  2. В главном меню выберите пункт Window > Xsolla > Edit Settings. В панели Inspector:
    1. В поле Project ID укажите ID проекта, который можно найти в разделе Настройки проекта > ID проекта Личного кабинета.
    2. В поле Login ID укажите ID варианта авторизации, который можно найти в разделе Лаунчер > Общие настройки > Настройки аутентификации Личного кабинета.
  1. Запустите сцену авторизации пользователя, в которой выполняется обработка токена.
  2. В главном меню выберите пункт File > Build settings и нажмите Add Open Scenes. Убедитесь, что сцена авторизации добавлена первой в списке.
  3. Нажмите Build.
  4. Во всплывающем окне укажите путь к директории, в которую будет помещена готовая сборка.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Скрыть

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

Внимание
Используйте эту инструкцию, если вы включили демопроект в свой проект Unity.

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

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

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

Настройка проекта Unity

  1. Создайте файл steam_appid.txt, впишите в него ID вашего приложения в Steam и поместите его в каталог Assets/Plugins/Steamworks.NET/redist/ вашего проекта.
Примечание
Если вы загрузили SDK из GitHub, в каталоге Assets/Plugins/Steamworks.NET/redist/ уже создан файл steam_appid.txt Steam для демопроекта.
  1. Откройте ваш проект Unity.
  2. В главном меню выберите пункт Window > Xsolla > Demo Settings.
  3. В панели Inspector:
    1. Установите флажок Use Steam authorization.
    2. В поле Steam App ID укажите ID вашего приложения в Steam. Значение должно совпадать со значением, указанным в файле steam_appid.txt.

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

Для аутентификации пользователей через Steam необходимо передать session ticket в метод SilentAuth. В качестве примера см. класс SteamAuth.cs в демопроекте.

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

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

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

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