Pacotes 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.

Os pacotes permitem agrupar vários itens em um único item. Você pode criar pacotes de itens que costumam ser comprados juntos ou de itens que estão disponíveis apenas por tempo limitado.

Criando um pacote

Para criar um pacote, primeiro você deve garantir que publicou os itens de catálogo, a moeda ou o conteúdo gerado pelo usuário (UGC) que deseja que estejam acessíveis/disponíveis para compra no seu jogo. Você pode seguir as etapas do Início rápido do Economy V2

GameManager

Navegue até Economy > Catalog (V2).
Na guia Bundles, selecione New Bundle.

API

Você pode usar CreateDraftItem para criar um pacote.

{
  "Item": {
    "Type": "bundle",
    "Title": {
      "NEUTRAL": "My First Bundle"
    },
    
    "StartDate": "2023-03-07T00:01:00.0000000Z",
    "ItemReferences":
        [{
            "Id":"{{LaserSwordID}}",
            "Amount": 2
        }, 
        {
            "Id":"{{LaserGunID}}", 
            "Amount": 2
        }],

    "PriceOptions": {
        "Prices": [
        {
              "Amounts": [
                {
                    "ItemId": "{{DiamondID}}",
                    "Amount": 5
                },
                {
                    "ItemId": "{{GoldID}}",
                    "Amount": 10
                }
                ]
        }
         ]
          }
        },
  "Publish": true
}

Resposta:

{
    "code": 200,
    "status": "OK",
    "data": {
        "Item": {
            "Id": "{{BundleID}}",
            "Type": "bundle",
            "AlternateIds": [],
            "Title": {
                "NEUTRAL": "My First Bundle"
            },
    ...
}

Comprando e desempacotando pacotes

Quando um jogador compra um pacote, o pacote é **desempacotado automaticamente: os itens individuais referenciados no pacote são concedidos diretamente ao inventário do jogador. O pacote em si não aparece como um item de inventário. Para obter mais detalhes sobre como os pacotes interagem com o inventário, confira Pacotes no inventário. Os pacotes também são o principal mecanismo para vincular produtos de marketplace com dinheiro real a itens do jogo. Cada pacote pode ser vinculado a um ou mais produtos de marketplace usando AlternateIds. Para obter mais informações, confira Início rápido da prevenção contra fraudes.

Confira também

Última modificação em 6 de outubro de 2026

Tópicos relacionados

Preços em dinheiro real do Economy v2 Visão geral do catálogo Rastreamento de preços em dinheiro real no Economy v2 Perguntas frequentes sobre o Economy versão 2 (V2)Limites do Economy V2

⌘I

​Criando um pacote

​GameManager

​API

​Comprando e desempacotando pacotes

​Confira também

Criando um pacote

GameManager

API

Comprando e desempacotando pacotes

Confira também