Lojas do Economy v2 - XBOX Game Development Documentation

O Economy v2 agora está em disponibilidade geral. Para obter suporte e enviar comentários, acesse o Fórum do PlayFab.

As lojas são uma excelente forma de expandir e desenvolver a economia do seu jogo. As lojas são um tipo especial de item que contém uma lista de itens e preços e permitem substituir os preços base do catálogo para os itens. As lojas podem ser usadas para gerenciar onde os itens podem ser comprados no seu jogo, oferecer descontos e promoções no jogo e muito mais!

Criar uma loja

Para criar uma loja, primeiro você deve garantir que tem outros itens do catálogo, moedas ou UGC publicados que deseja tornar acessíveis/compráveis no seu jogo. Você pode seguir as etapas do Início rápido do Economy v2

GameManager

Navegue até Economy > Catalog (V2).
Na guia Stores, selecione New Store.

Preencha os metadados desejados. Um dos pontos principais a definir são os itens que você deseja disponibilizar nessa loja e os preços pelos quais deseja substituí-los.

API

Você pode usar CreateDraftItem para criar uma loja. Um exemplo de solicitação CreateDraftItem para criar uma loja:

{
  "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
}

O exemplo acima é uma loja que vende dois itens, LaserSword e WeaponBundle. Ambos são itens existentes do catálogo com um preço base definido no catálogo. Essa loja substitui os preços existentes e agora oferece LaserSword por 1 Diamond e WeaponBundle por 10 Gold e 10 Silver. Essa solicitação retornaria uma resposta indicando que a loja foi criada e publicada:

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

Observe o Id que agora está associado à nossa loja publicada.

Para ajudar a simplificar o conceito, os IDs dos itens foram trocados de GUIDs para os nomes dos itens para ilustrar melhor o exemplo de uso de lojas.

Usar uma loja

As lojas são usadas quando os jogadores chamam a API PurchaseInventoryItems. Quando você chama PurchaseInventoryItems, uma das propriedades opcionais é o parâmetro StoreId, no qual podemos passar a loja a ser aplicada a essa solicitação de compra. Um exemplo de solicitação PurchaseInventoryItems usando uma loja:

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

Observe o {{StoreId}} passado na solicitação de compra e como o PriceAmount esperado agora corresponde ao custo de 1 Diamond definido na nossa loja.

Pesquisar em uma loja

Ao usar a API SearchItems, uma das propriedades que você pode passar é o parâmetro Store. Esse parâmetro permite pesquisar no contexto de uma loja. Além de permitir verificar se um item existe em uma loja específica, ele também pode ser usado para exibir os preços substituídos dos itens/conteúdos da loja. Você também pode usar o AlternateId da loja para pesquisá-la.

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

​Criar uma loja

​GameManager

​API

​Usar uma loja

​Pesquisar em uma loja

Criar uma loja

GameManager

API

Usar uma loja

Pesquisar em uma loja