Cenários de personalização comuns

Configurar a tradução da loja

Se quiser exibir o widget Xsolla Login e a interface de pagamento em um idioma específico dependendo da região ou preferências do usuário, use o parâmetro Locale. Os valores suportados são listados na seção Localization.

Exemplo:

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

Autenticar o usuário com tokens

Se você já tem tokens de autorização (obtidos via Login API ou métodos SDK), você poderá passá-los diretamente e não usar o widget Xsolla Login.

Exemplo:

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

Loja incorporada na sua interface

Você pode posicionar a loja em um contêiner específico da sua interface em vez de exibi-la na tela inteira. Por exemplo, dentro de um painel, aba ou janela pop-up.

Exemplo:

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

Use componentes de interface personalizados

Você pode sobreescrever elementos da loja padrões (como cartões de itens) com seus próprios prefabs. Para fazer isso:

1. Crie um componente da classe MonoBehaviour que implemente a interface ICatalogItemWidget.
2. Crie uma classe que implemente a interface IPrefabsProvider. Essa classe deve retornar seu prefab para itens de catálogo.
3. Ao chamar o método OpenStore(), passe uma instância das classes criadas ao parâmetro prefabsProvider:

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

Pré-carregar imagens de catálogo

Você pode acelerar o carregamento do catálogo quando há muitos itens. Para fazer isso, ao inicializar a cena, antes de chamar OpenStore(), pré-carregue as imagens dos itens chamando o método XsollaReadyToUseStore.WarmupCatalogImages().