Pular para o conteúdo principal
Com o TurboLoading, você pode carregar todo o seu inventário com uma única solicitação à API GetInventoryItems. Isso melhora a latência de inicialização e o desempenho, pois você não precisa fazer várias chamadas para carregar todos os itens da sua coleção de inventário. Para fins de cobrança, cada 250 itens são tratados como uma única página, portanto seus custos não devem mudar.

Como o TurboLoading funciona?

No momento, o TurboLoading está disponível para todos os títulos que usam a API REST do Economy V2. Os SDKs C# e Unity do PlayFab Services oferecem suporte adicional à compactação, incluindo o tratamento transparente da descompactação para você. Para ativar o TurboLoading, você precisa:
  • Definir o parâmetro Count da API GetInventoryItems com mais de 250 itens. Você pode defini-lo até o tamanho máximo de uma coleção de inventário, que é de 10.000 itens.
  • Incluir o cabeçalho Accept-Encoding: gzip na sua solicitação.
  • Descompactar a resposta usando gzip antes de poder usar os dados do inventário.
Por exemplo, se você quiser carregar todo o seu inventário de 700 itens, pode fazer uma única chamada à API GetInventoryItems com uma contagem de 700 e o cabeçalho Accept-Encoding: gzip. Você obtém uma resposta compactada com todos os itens do seu inventário. Você precisa descompactar a resposta usando gzip antes de poder usar os dados.

Usando o TurboLoading com os SDKs C# e Unity do PlayFab Services

Você pode definir a compactação (e a descompactação automática) de todas as respostas de API usando os SDKs C# e Unity do PlayFab Services, da seguinte forma:
Ou você pode definir a compactação apenas para a sua instância da API de Economy, da seguinte forma:

Usando o TurboLoading com o PlayFabCSDK

Você pode habilitar a compactação para todas as respostas de API usando o PlayFabCSDK multiplataforma com PFHttpSettings da seguinte forma:
Além disso, você pode desabilitar a compactação para todas as respostas de API:

Cobrança

O TurboLoading é cobrado por página retornada, ou seja, o número total de itens retornados dividido por 250 (arredondado para cima). Você paga o mesmo que pagaria se estivesse carregando 250 itens por página. Por exemplo, se você carregar 700 itens com o TurboLoading, será cobrado por 3 solicitações (700 / 250 = 2,8, arredondado para 3).

Benefícios

O TurboLoading oferece vários benefícios, como:
  • Melhor desempenho do jogo e menor latência de inicialização, pois você não precisa fazer várias chamadas para carregar os itens do seu inventário.
  • Menor complexidade e manutenção de código, pois você não precisa lidar com lógica de paginação e loops.

Confira também

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