SDK для Cocos Creator / Виджет авторизации
  На главную

SDK для Cocos Creator

Виджет авторизации

Виджет авторизации позволяет интегрировать в проект готовый интерфейс для аутентификации пользователей и снизить затраты на разработку кода и UI.

Ограничения:

  • Виджет доступен только для сборок под мобильные платформы.
  • Виджет поддерживает только следующие способы аутентификации пользователя:
    • по имени пользователя/email-адресу и паролю;
    • без пароля с помощью одноразового кода или ссылки, отправленных в SMS или электронном письме;
    • через социальные сети с помощью веб-сервисов.

Настройте перенаправление пользователей в приложение после успешной аутентификации с помощью виджета:

  1. Откройте проект в Личном кабинете.
  2. В боковом меню нажмите Login.
  3. Нажмите Настроить в панели нужного варианта авторизации.
  4. Выберите раздел Настройки callback URL.
  5. В поле Callback URL укажите те же пути для перенаправления пользователей, которые вы указали ранее при настройке OAuth 2.0 клиента.
  6. Нажмите Сохранить изменения.

Чтобы добавить аутентификацию через виджет в мобильном приложении:

  1. Подключите к проекту нативный Xsolla SDK для Android или iOS.
  2. Запустите авторизацию и обработку ее результатов. Для этого:

    1. Реализуйте в вашем приложении интерфейс для аутентификации пользователя (например, кнопку Войти).
    2. В соответствии с логикой приложения реализуйте вызов нативного метода authWithXsollaWidget.

Пример запуска аутентификации через виджет:

Copy
Full screen
Small screen
NativeUtil.authWithXsollaWidget();
    1. На стороне Cocos Creator подпишитесь на событие успешной аутентификации. Это событие генерируется на уровне сцены фрагментом TypeScript-кода, который обрабатывает результат аутентификации. В случае успеха вызовите метод-обработчик, который принимает объект с токеном пользователя. Этот объект можно использовать для дальнейшей работы с Xsolla API.
Примечание
Из нативных скриптов методы обратного вызова в Cocos Creator нужно вызывать из игрового потока (game thread).

    1. Подпишитесь на события с ошибкой и отменой аутентификации с вызовом необходимых методов-обработчиков.

Пример подписки:

Copy
Full screen
Small screen
director.getScene().on(Events.XSOLLA_WIDGET_AUTH_SUCCESS, this.handleSuccessfulXsollaWidgetAuth, this );
director.getScene().on(Events.XSOLLA_WIDGET_AUTH_ERROR, this.handleErrorXsollaWidgetAuth, this );
director.getScene().on(Events.XSOLLA_WIDGET_AUTH_CANCELED, this.handleCancelXsollaWidgetAuth, this );

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

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

Вид виджета в демопроекте для нескольких способов авторизации:

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

Полезные ссылки

Последнее обновление: 22 января 2024

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

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