​

Magasins et soldes (Economy hérité)

​

Prérequis

• 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 disposer d’un catalogue principal dans lequel un ou plusieurs objets sont définis.
  • Le premier exemple utilise plusieurs objets/lots, similaires à ceux décrits dans le tutoriel Tables de butin.
  • Le second exemple de ce tutoriel utilise des potions de soin petites, moyennes et grandes.

​

Bonnes pratiques

​

Informations générales sur les magasins et la tarification du catalogue

• Tarification : les prix définis dans le catalogue doivent correspondre au prix normal d’un objet. Les magasins vous permettent de définir un prix soldé temporaire pour un objet, selon une tactique courante dans le commerce de détail. Les magasins peuvent également proposer un prix temporaire pour un objet qui n’est normalement pas du tout disponible à la vente.
• Coût nul : si le coût d’un objet dans une monnaie donnée n’est pas défini (null) ou est égal à zéro, il ne peut pas être acheté avec cette monnaie, que ce soit dans les catalogues ou les magasins. Le coût nul vous permet de proposer des objets exclusivement contre des monnaies gratuites, ou exclusivement contre 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 uniquement des transactions en argent réel. Vous ne devez facturer en RM que des objets de valeur significative, ou des lots/conteneurs contenant de la monnaie premium.
• Les prix sont alternatifs : si deux prix sont définis pour un objet, celui-ci peut être acheté avec l’un ou l’autre. Il n’est pas possible d’exiger deux monnaies pour un même objet.

​

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 sélectionnez Stores.
• Sélectionnez le bouton New Store.

​

Bonnes pratiques pour les magasins en argent réel

​

Définition d’un magasin en monnaie virtuelle

1. Créez trois nouveaux objets : 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 objets en solde.

​

Achat de plusieurs objets 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);
}

​

Bonnes pratiques 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 d’appels invisible pour le joueur.
• Recueillez toutes les informations sur l’achat au préalable, et effectuez la séquence complète d’appels une fois que toutes les saisies 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

​

Bonnes pratiques pour l’affichage des objets 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);
}

​

Bonnes pratiques pour la gestion des échecs d’API

​

Conclusion

• Vous pouvez configurer un achat d’un seul objet en VC via PurchaseItem.
• Vous pouvez configurer un achat de plusieurs objets en argent réel ou en VC via la séquence :
  • StartPurchase
  • PayForPurchase
  • ConfirmPurchase