​

Tiendas y ventas (Economy heredado)

​

Requisitos

• Familiaridad con el Game Manager de PlayFab.
• Debe haber definido una o varias monedas virtuales. El último ejemplo de este tutorial usa:
  • SP (Silver Pieces)
  • GP (Gold Pieces).
• Debe tener un catálogo principal con uno o varios elementos definidos.
  • El primer ejemplo usa varios elementos o lotes, similares a los descritos en el tutorial de tablas de botín.
  • El segundo ejemplo de este tutorial usa pociones de salud pequeñas, medianas y grandes.

​

Procedimientos recomendados

​

Información general sobre las tiendas y los precios del catálogo

• Precios: los precios definidos en el catálogo deberían definirse como el precio normal de un elemento. Las tiendas le permiten definir un precio de oferta temporal para un elemento, utilizando la táctica minorista habitual. De forma alternativa, las tiendas pueden proporcionar un precio temporal para un elemento que normalmente no está disponible para la venta.
• Costo cero: si el costo de un elemento en una moneda concreta no está establecido (null) o es cero, no se puede comprar con esa moneda, tanto en catálogos como en tiendas. El costo cero le permite hacer que los elementos estén disponibles exclusivamente para monedas gratuitas, o exclusivamente para monedas premium, dejando en blanco las entradas de las demás monedas o restableciéndolas a cero.
• Dinero real: la moneda RM está disponible en todos los catálogos y tiendas. RM es una clave de moneda restringida que indica solo transacciones con dinero real. Solo debería cobrar RM por elementos de valor significativo, o por lotes/contenedores con moneda premium.
• Los precios son excluyentes: si se definen dos precios en un elemento, el elemento se puede comprar por uno u otro. No es posible exigir dos monedas para un único elemento.

​

Definición de una tienda con dinero real

• Vaya a su título.
• Seleccione Economy en el menú de la izquierda.
• En la pestaña Catalogs, seleccione su catálogo principal y seleccione Stores.
• Seleccione el botón New Store.

​

Procedimientos recomendados para tiendas con dinero real

​

Definición de una tienda con moneda virtual

1. Cree tres elementos nuevos: pociones de salud pequeña, mediana y grande con un precio en moneda gratuita y un precio en moneda premium.
2. Cree una tienda nueva con los elementos en venta.

​

Compra de varios elementos en una sola 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);
}

​

Procedimientos recomendados para mostrar tiendas

• Entre su juego y PlayFab, los pasos restantes son varias llamadas de API independientes, pero puede hacer que la secuencia de varias llamadas sea invisible para el jugador.
• Recopile toda la información sobre la compra por adelantado y realice la secuencia completa de llamadas después de recopilar todas las entradas del jugador.

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



}

​

Restricciones

​

Procedimientos recomendados para mostrar los elementos de la tienda

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

​

Procedimientos recomendados para gestionar los resultados de error de la API

​

Conclusión

• Puede configurar una compra de un único elemento con moneda virtual mediante PurchaseItem.
• Puede configurar una compra de varios elementos con dinero real o moneda virtual mediante la secuencia:
  • StartPurchase
  • PayForPurchase
  • ConfirmPurchase