​

Magasins et soldes (Economy Legacy)

​

Exigences

• Connaître le Game Manager de PlayFab.
• Vous devez avoir défini une ou plusieurs monnaies virtuelles. Le dernier exemple de ce tutoriel utilise :
  • SP (Silver Pieces, pièces d’argent)
  • GP (Gold Pieces, pièces d’or).
• Vous devez avoir un catalogue principal dans lequel un ou plusieurs articles sont définis.
  • Le premier exemple utilise plusieurs articles/lots, semblables à ceux décrits dans le tutoriel Tables de butin.
  • Le deuxième exemple de ce tutoriel utilise de petites, moyennes et grandes potions de santé.

​

Pratiques exemplaires

​

Renseignements généraux sur les magasins et les prix du catalogue

• Prix : les prix définis dans le catalogue doivent correspondre au prix régulier d’un article. Les magasins vous permettent de définir un prix de solde temporaire pour un article, selon une tactique courante dans le commerce de détail. Les magasins peuvent également offrir un prix temporaire pour un article qui n’est normalement pas du tout en vente.
• Coût nul : si le coût d’un article dans une monnaie donnée n’est pas défini (null) ou est zéro, il ne peut pas être acheté avec cette monnaie, tant dans les catalogues que dans les magasins. Le coût nul vous permet de rendre des articles disponibles exclusivement avec des monnaies gratuites, ou exclusivement avec des monnaies premium, en laissant vides les entrées des autres monnaies ou en les remettant à zéro.
• Argent réel : la monnaie RM est disponible dans tous les catalogues et magasins. RM est une clé de monnaie réservée qui indique des transactions en argent réel uniquement. Vous ne devriez facturer en RM que des articles de valeur importante, ou des lots/conteneurs de monnaie premium.
• Les prix sont exclusifs : si deux prix sont définis pour un article, l’article peut être acheté avec l’une ou l’autre monnaie. Il n’est pas possible d’exiger deux monnaies pour un seul article.

​

Définition d’un magasin en argent réel

• Accédez à votre titre.
• Sélectionnez Economy dans le menu de gauche.
• Dans l’onglet Catalogs, sélectionnez votre catalogue principal, puis Stores.
• Sélectionnez le bouton New Store.

​

Pratiques exemplaires pour les magasins en argent réel

​

Définition d’un magasin en monnaie virtuelle

1. Créez trois nouveaux articles : Small, Medium et Large Health Potions avec un prix en monnaie gratuite et un prix en monnaie premium.
2. Créez un nouveau magasin avec les articles en solde.

​

Achat de plusieurs articles en un seul achat

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);
}

​

Pratiques exemplaires pour l’affichage des magasins

• Entre votre jeu et PlayFab, les étapes restantes consistent en plusieurs appels d’API distincts, mais vous pouvez rendre la séquence de plusieurs appels invisible pour le joueur.
• Recueillez d’emblée toute l’information sur l’achat, puis effectuez la séquence complète d’appels une fois que toutes les entrées du joueur ont été recueillies.

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);



}

​

Restrictions

​

Pratiques exemplaires pour l’affichage des articles en magasin

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);
}

​

Pratiques exemplaires pour la gestion des résultats d’échec d’API

​

Conclusion

• Vous pouvez configurer l’achat d’un seul article en VC au moyen de PurchaseItem.
• Vous pouvez configurer l’achat de plusieurs articles en argent réel ou en VC au moyen de la séquence suivante :
  • StartPurchase
  • PayForPurchase
  • ConfirmPurchase