Tiendas de Economy v2 - XBOX Game Development Documentation

Economy v2 ya está disponible con carácter general. Para obtener soporte técnico y enviar comentarios, vaya al foro de PlayFab.

Las tiendas son una excelente manera de aprovechar y desarrollar la economía del juego. Las tiendas son un tipo de artículo especial que contiene una lista de artículos y precios, y le permiten invalidar los precios base del catálogo para los artículos. Las tiendas se pueden usar para administrar dónde se pueden comprar artículos en el juego, ofrecer descuentos y promociones en el juego, ¡y mucho más!

Creación de una tienda

Para crear una tienda, primero debe asegurarse de que tiene otros artículos de catálogo, moneda o UGC publicados que quiera que sean accesibles o comprables en el juego. Puede seguir los pasos de la guía de inicio rápido de Economy v2

GameManager

Vaya a Economy > Catalog (V2).
En la pestaña Stores, seleccione New Store.

Rellene los metadatos deseados; una de las cosas clave que hay que establecer son los artículos que quiere que estén disponibles en esta tienda y los precios con los que quiere invalidarlos.

API

Puede usar CreateDraftItem para crear una tienda. Un ejemplo de solicitud CreateDraftItem para crear una tienda:

{
  "Item": {
   "Type": "store",
    "Title": {
      "NEUTRAL": "My First Store",
    },
    "StartDate": "2022-09-07T00:00:00.00000000Z",
    "ItemReferences":[
      {
        "Id":"LaserSword",
        "Amount": 1,
        "PriceOptions": {
          "Prices": [{
            "Amounts": [{
              "ItemId": "Diamond",
              "Amount": 1
            }]
          }]
        }
      },
      {
      "Id":"WeaponBundle",
      "PriceOptions": {
        "Prices": [{
          "Amounts": [{
            "ItemId": "Gold",
            "Amount": 10
            },
            {
            "ItemId": "Silver",
            "Amount": 10
          }]
        }],
      },
    }]
   },
   "Publish": true
}

Lo anterior es una tienda que vende dos artículos, LaserSword y WeaponBundle. Ambos artículos son artículos de catálogo existentes con algún precio base existente tal como se define en el catálogo. Esta tienda invalida sus precios existentes y ahora ofrece LaserSword por 1 Diamond y WeaponBundle por 10 de oro y 10 de plata. Esta solicitud devolvería una respuesta que indica que la tienda se ha creado y publicado:

{
  "code": 202,
  "status": "Accepted",
  "Item": {
    "Type": "store",
    "Id": "{{StoreID}}", 
    "Title": {
      "NEUTRAL": "My First Store",
    },
    ...
}

Observe el Id que ahora está asociado a nuestra tienda publicada.

Para ayudar a simplificar el concepto, los identificadores de artículo se han cambiado de GUID a los nombres de los artículos para ilustrar mejor el ejemplo de uso de tiendas.

Uso de una tienda

Las tiendas se usan cuando los jugadores llaman a la API PurchaseInventoryItems. Cuando se llama a PurchaseInventoryItems, una de las propiedades opcionales es un parámetro StoreId donde podemos pasar la tienda que usamos para aplicarla a esta solicitud de compra. Un ejemplo de solicitud PurchaseInventoryItems mediante una tienda:

{
    "Entity": {
        "Type": "title_player_account",
        "Id": "{{PlayerID}}"
    },
    "Item": {
        "Id": "LaserSword",
    },
    "Amount": 10,
    "PriceAmounts": [
        {
            "ItemId": "Diamond",
            "Amount": 1
        }
    ],
    "StoreId": "{{StoreID}}"
}

Observe el {{StoreId}} pasado en la solicitud de compra y cómo el PriceAmount previsto ahora coincide con el costo de 1 Diamond establecido en nuestra tienda.

Búsqueda en una tienda

Cuando usa la API SearchItems, una de las propiedades que puede pasar es el parámetro Store. Este parámetro le permite buscar dentro del contexto de una tienda. Además de poder comprobar si un artículo existe en una tienda concreta, también se puede usar para mostrar los precios invalidados de los artículos o el contenido de la tienda. También puede usar el AlternateId de la tienda para buscarla.

{
  "Search": "",
  "Filter": "ContentType eq 'weapons'",
  "Store": {
    "Id": "{{StoreID}}"
  },
}

​Creación de una tienda

​GameManager

​API

​Uso de una tienda

​Búsqueda en una tienda

Creación de una tienda

GameManager

API

Uso de una tienda

Búsqueda en una tienda