Scénarios courants de personnalisation

Définissez l'emplacement du magasin

Pour afficher le widget Xsolla Login et l’interface de paiement dans la langue souhaitée selon la région ou les préférences utilisateur, utilisez le paramètre Locale. Les valeurs prises en charge sont répertoriées dans la section Localization.

Exemple :

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

Authentifiez l'utilisateur avec des jetons

Si vous disposez déjà de jetons d’autorisation (obtenus, par exemple, via Login API ou des méthodes SDK), vous pouvez les passer directement sans utiliser le widget Xsolla Login.

Exemple :

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

Intégrez le magasin à votre interface utilisateur

Vous pouvez intégrer le magasin dans un conteneur spécifique de votre interface utilisateur, par exemple dans un panneau, un onglet ou une fenêtre contextuelle, au lieu de l’afficher en plein écran.

Exemple :

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

Utilisez des composants d'interface utilisateur personnalisés

Vous pouvez remplacer les éléments standard du magasin (par exemple, les cartes de bien) par vos propres prefabs. Pour ce faire :

1. Créez un composant de la classe MonoBehaviour qui implémente l’interface ICatalogItemWidget.
2. Créez une classe qui implémente l’interface IPrefabsProvider. Cette classe doit retourner votre prefab pour les objets du catalogue.
3. Lors de l’appel à la méthode OpenStore(), passez une instance de la classe créée dans le paramètre prefabsProvider :

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

Préchargez les images du catalogue

Accélérez le chargement du catalogue lorsqu’il contient de nombreux objets. Pour ce faire, lors de l’initialisation de la scène, avant d’appeler la méthode OpenStore(), préchargez les images des objets en appelant la méthode XsollaReadyToUseStore.WarmupCatalogImages().