​

Visão geral de itens e inventário do PlayFab

​

Conceitos principais

• Catálogo - Um catálogo é uma coleção de todos os itens disponíveis no seu jogo. Os catálogos oferecem uma maneira fácil de gerenciar os itens virtuais do seu jogo. Para obter mais informações, consulte a Visão geral do catálogo.
• Itens do catálogo – Itens individuais definidos no seu catálogo. Eles podem representar qualquer tipo de bem virtual, como armas, roupas, power-ups, caixas de recompensa etc. Você pode personalizar propriedades e comportamentos para se adequar ao design do seu jogo.
• Lojas do catálogo - As lojas permitem que você crie várias listagens de itens para diferentes finalidades, como eventos sazonais, promoções ou testes. Consulte Lojas.
• Pacotes - Pacotes são itens do catálogo que contêm referências a outros itens. Quando um jogador compra um pacote, os itens referenciados são desempacotados e adicionados ao inventário dele.
• Assinaturas - As assinaturas concedem acesso baseado em tempo a bens duráveis. Os itens de uma assinatura ficam disponíveis no inventário do jogador durante a vigência da assinatura. Consulte Assinaturas.
• Coleções de inventário do jogador - O inventário é um registro dos itens que um jogador possui no seu jogo. Ele contém informações sobre quantidades de itens, saldos de moeda virtual e propriedades personalizadas. Todas as contas de jogador podem ter um ou mais inventários chamados Coleções.
• Pilhas - As pilhas permitem que várias instâncias distintas do mesmo item existam em um único inventário, cada uma com sua própria quantidade e propriedades personalizadas. Consulte Pilhas.
• Moeda virtual - A moeda virtual é um tipo de item usado como meio de troca no seu jogo. Você pode usar a moeda virtual para comprar itens do catálogo ou de uma loja, implementar moeda comum a partir de compras no aplicativo ou conduzir mecânicas de jogo.

​

APIs principais

​

Gerenciamento de inventário

• GetInventoryItems - Recupera o inventário atual de uma entidade. Oferece suporte à paginação com ContinuationToken e ao carregamento em massa via TurboLoading.
• AddInventoryItems - Adiciona itens diretamente ao inventário de um jogador.
• SubtractInventoryItems - Reduz as quantidades de itens no inventário de um jogador.
• UpdateInventoryItems - Define quantidades de itens ou modifica as Propriedades de exibição em itens do inventário.
• DeleteInventoryItems - Remove pilhas inteiras de itens do inventário de um jogador.

​

Compras e trocas

• PurchaseInventoryItems - Compra itens ou pacotes do catálogo usando moeda virtual. Deduz a moeda do inventário do jogador e concede o item comprado.
• TransferInventoryItems - Transfere itens entre jogadores, entre as coleções de inventário de um jogador ou entre pilhas no mesmo inventário.

​

Operações em lote

• ExecuteInventoryOperations - Agrupa até 10 operações de inventário (Add, Subtract, Update, Purchase, Transfer, Delete) em uma única solicitação atômica. Se alguma operação falhar, todo o lote será revertido.

​

Histórico e diagnóstico

• GetTransactionHistory - Recupera eventos de transação do inventário de um jogador. Oferece suporte à filtragem por carimbo de data/hora e à paginação para revisar o histórico completo de operações. Consulte Histórico de transações.

​

Confiabilidade

• Idempotência - Todas as APIs de inventário oferecem suporte a um parâmetro IdempotencyId para repetir solicitações com segurança, sem efeitos colaterais duplicados. As IDs são aplicadas por 14 dias. Consulte Idempotência.