​

Lojas e promoções (Economy Legado)

​

Requisitos

• Familiaridade com o Game Manager do PlayFab.
• Você deve ter definido uma ou mais Moedas virtuais. O último exemplo deste tutorial usa:
  • SP (Peças de prata)
  • GP (Peças de ouro).
• Você deve ter um catálogo principal com um ou mais itens definidos.
  • O primeiro exemplo usa vários itens/pacotes, semelhantes aos descritos no tutorial Tabelas de drop.
  • O segundo exemplo deste tutorial usa poções de vida pequenas, médias e grandes.

​

Práticas recomendadas

​

Informações gerais sobre lojas e preços do catálogo

• Preços: os preços definidos no catálogo devem ser definidos como o preço normal de um item. As lojas permitem definir um preço promocional temporário para um item, utilizando a tática comum do varejo. Como alternativa, as lojas podem oferecer um preço temporário para um item que normalmente não está disponível para venda.
• Custo zero: se o custo de um item em uma determinada moeda não estiver definido (null) ou for zero, ele não poderá ser comprado usando essa moeda, tanto em catálogos quanto em lojas. O custo zero permite disponibilizar itens exclusivamente para moedas gratuitas ou exclusivamente para moedas premium, deixando em branco as entradas das outras moedas ou redefinindo-as como zero.
• Dinheiro real: a moeda RM está disponível em todos os catálogos e lojas. RM é uma chave de moeda restrita que indica somente transações com dinheiro real. Você só deve cobrar RM por itens de valor significativo ou por pacotes/contêineres com moeda premium.
• Os preços são um ou outro: se dois preços forem definidos em um item, o item poderá ser comprado com um ou com o outro. Não é possível exigir duas moedas para um único item.

​

Definindo uma loja com dinheiro real

• Navegue até seu Título.
• Selecione Economy no menu à esquerda.
• Na guia Catálogos, selecione seu catálogo principal e selecione Lojas.
• Selecione o botão Nova loja.

​

Práticas recomendadas para lojas com dinheiro real

​

Definindo uma loja com moeda virtual

1. Crie três novos itens: Poções de vida pequena, média e grande com um preço em Moeda gratuita e um preço em Moeda premium.
2. Crie uma nova loja com os itens em promoção.

​

Comprando vários itens em uma única compra

void GetVcStore()
{
    var primaryCatalogName = "TestCatalog-001"; // In your game, this should just be a constant matching your primary catalog
    var storeId = "Potion Store"; // In your game, this should be a constant for a permanent store, or retrieved from titleData for a time-sensitive store
    var request = new GetStoreItemsRequest
    {
        CatalogVersion = primaryCatalogName,
        StoreId = storeId
    };
    PlayFabClientAPI.GetStoreItems(request, LogSuccess, LogFailure);
}

​

Práticas recomendadas para exibir lojas

• Entre seu jogo e o PlayFab, as etapas restantes são várias chamadas de API separadas, mas você pode tornar a sequência de várias chamadas invisível para o jogador.
• Colete todas as informações sobre a compra antecipadamente e faça a sequência completa de chamadas depois que toda a entrada do jogador for coletada.

void DefinePurchase()
{
    var primaryCatalogName = "TestCatalog-001"; // In your game, this should just be a constant matching your primary catalog.
    var storeId = "Potion Store"; // At this point in the process, it's just maintaining the same storeId used above.
    var request = new StartPurchaseRequest
    {
        CatalogVersion = primaryCatalogName,
        StoreId = storeId,
        Items = new List<ItemPurchaseRequest> {
             // The presence of these lines are based on the results from GetStoreItems, and user selection - Yours will be more generic.
            new ItemPurchaseRequest { ItemId = "Small Health Potion", Quantity = 20,},
            new ItemPurchaseRequest { ItemId = "Medium Health Potion", Quantity = 100,},
            new ItemPurchaseRequest { ItemId = "Large Health Potion", Quantity = 2,},
        }
    };
    PlayFabClientAPI.StartPurchase(request, result => { Debug.Log("Purchase started: " + result.OrderId); }, LogFailure);
}

​

Restrições

​

Práticas recomendadas para exibir itens da loja

void DefinePaymentCurrency(string orderId, string currencyKey, string providerName)
{
    var request =new PayForPurchaseRequest {
        OrderId = orderId, // orderId comes from StartPurchase above.
        Currency = currencyKey, // User defines which currency they wish to use to pay for this purchase (all items must have a defined/non-zero cost in this currency).
        ProviderName = providerName // providerName comes from the PaymentOptions in the result from StartPurchase above.
    };
    PlayFabClientAPI.PayForPurchase(request, LogSuccess, LogFailure);
}

// Unity/C#
void FinishPurchase(string orderId)
{
    var request = new ConfirmPurchaseRequest { OrderId = orderId };
    PlayFabClientAPI.ConfirmPurchase(request, LogSuccess, LogFailure);
}

​

Práticas recomendadas para lidar com resultados de falha da API

​

Conclusão

• Você pode configurar uma compra de um único item com VC via PurchaseItem.
• Você pode configurar uma compra de vários itens com dinheiro real ou VC por meio da sequência:
  • StartPurchase
  • PayForPurchase
  • ConfirmPurchase