Escenarios comunes de personalización

Establecer la ubicación de la tienda

Si quiere mostrar el widget de Xsolla Login y la interfaz de pago en el idioma determinado por la región o las preferencias del usuario, utilice el parámetro Locale. Los valores admitidos se indican en la sección Localization.

Ejemplo

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

Autenticar usuarios con tokens

Si ya dispone de tokens de autorización (por ejemplo, obtenidos a través de Login API o métodos SDK), puede transmitirlos directamente y no utilizar el widget de Xsolla Login.

Ejemplo

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

Integrar la tienda en la interfaz

Puede colocar la tienda en un contenedor específico de su interfaz de usuario en lugar de mostrarla en toda la pantalla. Por ejemplo, dentro de un panel, una pestaña o una ventana emergente.

Ejemplo

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

Usar componentes de interfaz personalizados

Puede reemplazar los elementos estándar de la tienda (por ejemplo, fichas de artículos) con sus propios elementos prefabricados. Para ello:

1. Cree un componente de la clase MonoBehaviour que implemente la interfaz ICatalogItemWidget.
2. Cree una clase que implemente la interfaz IPrefabsProvider. Esta clase debería devolver sus prefabricados para los artículos del catálogo.
3. Al llamar al método OpenStore(), transmita una instancia de la clase creada al parámetro prefabsProvider:

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

Precarga de imágenes del catálogo

Puede acelerar la carga del catálogo cuando hay muchos artículos. Para ello, al inicializar la escena, antes de llamar a OpenStore(), precargue las imágenes de los artículos llamando al método XsollaReadyToUseStore.WarmupCatalogImages().