通常のカスタマイズシナリオ

ストアのローカライズを設定する

地域やユーザーの好みに応じてエクソーラログインウィジェットと決済UIを希望の言語で表示したい場合は、Localeパラメータを使用します。サポートされている値はローカライズセクションに記載されています。

例：

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

トークンでユーザーを認証する

すでに認証トークン（例：Login APIまたはSDKメソッドを介して取得）をお持ちの場合、それらを直接渡し、エクソーラログインウィジェットを使用しないことができます。

例：

 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. ICatalogItemWidgetインターフェースを実装するMonoBehaviourクラスのコンポーネントを作成します。
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()メソッドを呼び出してアイテム画像をプリロードします。