> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TurboLoading do Economy V2

> Use o TurboLoading do PlayFab Economy v2 com GetInventoryItems para buscar o inventário completo de um jogador em uma única solicitação, reduzindo a latência de inicialização e as chamadas de API.

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:

```csharp theme={null}
PlayFabSettings.staticSettings.CompressResponses = true;
```

Ou você pode definir a compactação apenas para a sua instância da API de Economy, da seguinte forma:

```csharp theme={null}
var economyApi = new PlayFabEconomyInstanceAPI(new PlayFabApiSettings { CompressResponses = true }, authContext);
```

### 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:

```C++ theme={null}
// Initialize PFHttpSettings struct
PFHttpSettings* httpSettings = new PFHttpSettings;

// Enable Response Compression (and automatic decompression)
httpSettings->requestResponseCompression = true;

// Set PFHttpSettings
HRESULT hr = PFSetHttpSettings(httpSettings); // Add your own error handling FAILED(hr) == true
```

Além disso, você pode desabilitar a compactação para todas as respostas de API:

```C++ theme={null}
// Disable Response Compression
httpSettings->requestResponseCompression = false;

// Update PFHttpSettings
hr = PFSetHttpSettings(httpSettings); // Add your own error handling
```

## 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

* [Visão geral do Economy V2](/pt-BR/services/playfab/economy-monetization/economy-v2/overview)
* [GetInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-inventory-items)
* [Limites](/pt-BR/services/playfab/economy-monetization/economy-v2/limits)


## Related topics

- [Visão geral do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/overview.md)
- [Visão geral de itens e inventário](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview.md)
- [Pacotes do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/bundles.md)
- [Localização do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/localization.md)
- [Lojas do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/stores.md)