Частые сценарии кастомизации

Установка языка интерфейса

Если вы хотите отображать виджет Xsolla Login и платежный интерфейс на нужном языке в зависимости от региона или предпочтений пользователя, используйте параметр Locale. Доступные значения приведены в разделе Локализация.

Пример:

1var config = new ReadyToUseStoreConfig
2{
3    Locale = "ja" //  Japanese
4};
5XsollaReadyToUseStore.OpenStore(config);

Авторизация с использованием токенов

Если у вас уже есть авторизационные токены (например, полученные с помощью Login API или методов SDK), вы можете передать их напрямую и не использовать виджет Xsolla Login.

Пример:

 1var tokenData = new TokenData
 2{
 3    accessToken = "...",
 4    refreshToken = "...",
 5    expirationTime = ...
 6};
 7var config = new ReadyToUseStoreConfig
 8{
 9    TokenData = tokenData
10};
11XsollaReadyToUseStore.OpenStore(config);

Встраивание UI магазина в собственный интерфейс

Вы можете разместить магазин в определенном контейнере вашего UI вместо отображения на весь экран. Например, внутри панели, вкладки или всплывающего окна.

Пример:

1{
2    CatalogParent = yourTransform
3};
4XsollaReadyToUseStore.OpenStore(config);

Использование собственных UI-компонентов

Вы можете полностью заменить внешний вид стандартных элементов магазина (например, карточек товаров) своими префабами. Для этого:

1. Создайте компонент класса MonoBehaviour, который реализует интерфейс ICatalogItemWidget.
2. Создайте класс, который реализует интерфейс IPrefabsProvider. Этот класс должен возвращать ваш префаб для элементов каталога.
3. При вызове метода OpenStore() передайте в параметр prefabsProvider экземпляр созданного класса:

1public class MyPrefabsProvider : IPrefabsProvider
2{
3    public GameObject GetCatalogItemWidget() => myCustomItemPrefab;
4}
5
6XsollaReadyToUseStore.OpenStore(config, new MyPrefabsProvider());

Предзагрузка изображений каталога

Вы можете ускорить загрузку каталога при большом количестве товаров. Для этого при инициализации сцены, до вызова OpenStore(), выполните предзагрузку изображений товаров с помощью вызова метода XsollaReadyToUseStore.WarmupCatalogImages().