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

# Visão geral do Title Storage dos serviços XBOX

> Saiba o que é o Title Storage dos serviços XBOX, seus recursos, tipos de armazenamento e cotas, limites de limitação e formatos de dados com suporte para dados de jogo na nuvem.

Este tópico descreve o que é o Title Storage dos serviços XBOX, quais são seus recursos e demonstra como configurá-los.
O serviço Title Storage dos serviços XBOX fornece armazenamento em nuvem para grandes quantidades de dados por jogador ou por jogo. Você pode usá-lo para armazenar estatísticas e ativos dos jogadores. Jogos executados em todas as plataformas XBOX podem usar o Title Storage.

<a name="ID4EW" />

## Recursos do Title Storage dos serviços XBOX

O Title Storage dos serviços XBOX inclui os seguintes recursos de alto nível.

* Pode ser compartilhado entre jogadores, títulos e várias plataformas

* Dá suporte a arquivos JSON, binários e de configuração

<a name="ID4ETB" />

## Tipos de armazenamento

| Tipo de armazenamento | Cota (Managed Partners) | Cota (Creators Program) | Finalidade | Plataformas | Jogadores |
| - | - | - | - | - | - |
| Trusted Platform | 256 MB por jogador | 64 MB por jogador | Dados por jogador, como jogos salvos ou estado do jogo para jogar/pausar/retomar. Mais seguro, mas com restrições de plataforma. | Qualquer plataforma pode ler, mas somente a família XBOX One (ou posterior), o XBOX 360 ou o Windows Phone podem gravar. | Configurável como público ou somente proprietário. |
| Universal Platform | 64 MB por jogador | 64 MB por jogador | Dados por jogador, como jogos salvos ou estado do jogo para jogar/pausar/retomar. | Qualquer plataforma pode ler ou gravar. | Configurável como público ou somente proprietário. |
| Global | 256 MB | 256 MB | Dados que todos podem ler, como escalações, mapas, desafios ou recursos de arte. | Gravável somente por meio do XBOX Developer Portal ou do Partner Center; qualquer plataforma pode ler. | Todos os jogadores podem ler. |

## Limite de limitação

Não há limites para quantas leituras e gravações um título pode fazer por minuto, mas geralmente ele não pode fazer mais de uma por minuto, em média, por sessão de uma hora. Por exemplo, um título pode fazer 60 leituras ou gravações no início de uma sessão, mas nenhuma outra pelo restante da hora. Os títulos devem estar preparados para não fazer mais chamadas posteriormente, caso os serviços XBOX precisem limitar as solicitações.

<Note>Se o seu título tiver requisitos especiais de particionamento, como leituras ou gravações extras, entre em contato com seu representante da Microsoft.</Note>

<a name="ID4ECF" />

## Tipos de dados

Esta seção descreve os três tipos com suporte.

* [Informações binárias](#ID4ENF)
* [Informações JSON](#ID4EUF)
* [Informações de configuração](#ID4ECAAC)

<a name="ID4ENF" />

#### Informações binárias

As informações binárias incluem itens como imagens, sons e dados personalizados. Como os dados precisam ser transmitidos por HTTP, os dados binários devem ser codificados em caracteres aceitos pelo HTTP. Por exemplo, você pode converter os dados em strings hexadecimais ou usar a codificação base64. O Title Storage não processa dados codificados, portanto seu jogo deve usar o mesmo esquema para codificar e decodificar dados ao ler e gravar no Title Storage.

<a name="ID4EUF" />

#### Informações JSON

As informações JSON incluem dados estruturados (pares chave-valor). Você pode usar objetos JSON em linguagens que dão suporte a eles, como JavaScript. Ao recuperar dados de arquivos JSON, o jogo pode fornecer um parâmetro `selectQuery` para retornar itens específicos dentro da estrutura. Por exemplo, você poderia usar um arquivo JSON que contém as informações a seguir.

```json theme={null}
{
"difficulty" : 1,
"level" :
    [
        { "number" : "1", "quest" : "swords" },
        { "number" : "2", "quest" : "iron" },
        { "number" : "3", "quest" : "gold" },
        { "number" : "4", "quest" : "queen" }
        ],
"weapon" :
    {
            "name" : "poison",
            "timeleft" : "2mins"
    }
}
```

<Note>Por motivos de segurança, o primeiro elemento dos dados JSON não deve ser uma matriz. Dados JSON enviados com uma matriz na raiz são rejeitados pelo serviço.</Note>

Seu jogo pode selecionar partes da estrutura JSON como um `selectQuery` (por exemplo, `weapon.name`) e, em seguida, recebe o seguinte:

```json theme={null}
{
    "name" : "poison"
}
```

<a name="ID4ECAAC" />

#### Informações de configuração

Os blobs de configuração são estruturas de dados armazenadas no Title Storage global. O formato de um blob de configuração é semelhante ao de um objeto JSON. Os blobs de configuração podem incluir nós virtuais que retornam uma configuração a partir de uma lista de possibilidades. Os nós virtuais são úteis para fornecer configurações para situações específicas, como para um título ou uma localidade. O nó virtual inclui várias configurações possíveis, junto com valores e condições para selecionar entre os valores. No exemplo a seguir, a configuração `defaultCardDesign` pode ter um dos valores do nó virtual.

```json theme={null}
{
    "defaultCardDesign":
    {
    "_virtualNode":
    {
        "_selectBy":"titleId",
        "_sourceNodes":
        [
        {"_selector":"123456799", "_data":"RobotUnicornCard.png,binary"},
        {"_selector":"default", "_data":"StandardCard.png,binary"}
        ]
    }
    },
}
```

Quando um jogo lê esse arquivo, o sistema seleciona um dos valores da matriz `\_sourceNodes`. Nesse caso, o item é selecionado com base na ID do título do jogo. Por exemplo, os jogadores que estão jogando o jogo `12456799` veriam o seguinte:

```json theme={null}
{
    "defaultCardDesign":"RobotUnicornCard.png,binary",
    "_sourceNodes":["defaultCardDesign:titleID:1234567899"]
}
```

Os jogadores que não estão jogando o jogo veriam o seguinte:

```json theme={null}
{
    "defaultCardDesign":"StandardCard.png,binary",
    "_sourceNodes":["defaultCardDesign:titleID:default"]
}
```

Os jogos podem definir seletores personalizados que correspondem a um parâmetro na solicitação. Por exemplo, considere o seguinte objeto JSON neste blob de configuração.

```json theme={null}
{
    "defaultCardDesign":
    {
        "_virtualNode":
        {
            "_selectBy":"custom:gameMode",
            "_sourceNodes":
            [
                {"_selector":"silly", "_data":"RobotUnicornCard.png,binary"},
                {"_selector":"serious", "_data":"SeriousCard.png,binary"},
                {"_selector":"default", "_data":"StandardCard.png,binary"}
                ]
        }
    },
    "backgroundColor":"green",
    "dealerHitsOnSoft17":true
}
```

Os jogos passam uma string no parâmetro `customSelector` para selecionar qual item retornar. Por exemplo, para obter a segunda opção, um jogo solicita `gameMode.serious` como `selectQuery`.

<a name="ID4E5EAC" />

## Para começar a usar o Title Storage dos serviços XBOX

1. Determine que tipo de dados você deseja armazenar. Exemplos incluem jogos salvos, estado do jogo, desafios diários, mapas do jogo e recursos de arte.

2. Determine quais títulos e plataformas precisam acessar os dados. O Title Storage dá suporte ao acesso a dados na nuvem a partir de um único título em uma única plataforma e de vários títulos em várias plataformas.


## Related topics

- [Title Storage](/pt-BR/services/xbox-services/storage/title-storage/index.md)
- [Visão geral dos serviços do XBOX](/pt-BR/services/xbox-services/fundamentals/live-xbl-overview.md)
- [Visão geral do multijogador dos serviços XBOX](/pt-BR/services/xbox-services/multiplayer/overviews/live-multiplayer-intro.md)
- [Visão geral dos privilégios de usuário dos serviços do XBOX](/pt-BR/services/xbox-services/fundamentals/identity/privileges/live-user-privileges-overview.md)
- [Visão geral da API dos serviços do XBOX](/pt-BR/services/xbox-services/fundamentals/xbox-services-api/live-introduction-to-xbox-live-apis.md)