Pular para o conteúdo principal
A API de cliente do PlayFab permite que os jogadores troquem itens entre si. Esses métodos de API são habilitados por padrão, portanto, para a segurança do seu título, talvez seja necessário usar nossa API de políticas para desabilitá-los.
A funcionalidade de troca de inventário está em fase de versão prévia. Os métodos funcionam, mas não têm alguns elementos úteis que a tornariam um recurso completo. Atualmente, você só pode trocar itens virtuais. Não é possível solicitar ou trocar moeda virtual, e o PlayFab não fornece uma lista das trocas disponíveis para você feitas por outros jogadores. Os métodos de troca estão disponíveis apenas na API de cliente e não estão disponíveis na API de servidor.

Conceitos principais

Catálogo - Os catálogos oferecem uma maneira fácil de gerenciar os itens virtuais do seu jogo. Eles são listas de todos os itens disponíveis no seu jogo. Itens de catálogo – Os itens do PlayFab podem representar praticamente qualquer tipo de bem virtual que você possa usar, desde duráveis até pacotes e contêineres bloqueados. Inventário - Todas as contas (contas de jogador e contas de personagem) têm um inventário. O inventário contém todas as instâncias de itens possuídas, bem como o histórico de itens. Moeda virtual - O PlayFab oferece até 10 moedas virtuais por título. As moedas podem ser usadas para comprar itens de um catálogo ou loja, podem representar moeda comum convertida de compras no aplicativo ou podem ser usadas como uma mecânica para impulsionar a jogabilidade.

Pré-requisitos

As trocas exigem familiaridade com itens de catálogo e de inventário. Os jogadores devem possuir os itens de inventário que desejam trocar.

APIs

O fluxo de troca é tratado por algumas APIs: OpenTrade
Abre uma nova troca pendente. Ela pode ser entre dois jogadores específicos (PlayfabIDs) ou com um jogador abrindo uma troca disponível para qualquer pessoa. Observe que qualquer instância de item específica só pode estar em uma troca aberta por vez.
GetTradeStatus
Permite que um cliente avalie uma determinada troca obtendo seu status atual.
AcceptTrade
Aceita uma troca aberta. Se a chamada for bem-sucedida, os itens oferecidos e aceitos serão permutados entre os inventários dos dois jogadores.
CancelTrade
Cancela uma troca aberta. Observe que somente o jogador que criou a troca pode cancelá-la por meio desta chamada de API, para evitar abusos.
GetPlayerTrades
GetPlayerTrades retornará todas as trocas que um jogador abriu ou aceitou, opcionalmente filtradas pelo status da troca.
Última modificação em 6 de outubro de 2026