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

# Configurando áreas restritas

> Como obter o ID da área restrita, o TitleID e o SCID no Partner Center e configurar a área restrita do seu kit de desenvolvimento XBOX para habilitar os serviços do XBOX Live no seu título.

## Visão geral

Este tópico descreve como obter os IDs necessários para configurar áreas restritas e configurar seu aplicativo para usar os serviços do XBOX.

Uma área restrita oferece isolamento de conteúdo para um kit de desenvolvimento individual, fornecendo um ambiente limpo para desenvolvimento e testes.

Os serviços do XBOX fornecem recursos online, como eventos, conquistas e funcionalidade multiplayer.

Para habilitar as áreas restritas e usar os serviços do XBOX, você precisará obter vários IDs para configurar seu kit de desenvolvimento e seu título.

Isso pode ser feito com o mesmo processo.

O processo é o seguinte.

1. Obtenha seus IDs.
2. Defina as áreas restritas nos seus kits de desenvolvimento.
3. Associe o TitleID ao seu título, junto com outros identificadores opcionais.

### IDs essenciais

Há três IDs essenciais para o desenvolvimento de títulos e aplicativos para XBOX One (ou posterior): o ID da área restrita, o TitleID e o identificador de configuração de serviço (SCID).

Embora seja necessário ter um ID de área restrita para usar um kit de desenvolvimento, o TitleID e o SCID não são necessários para o desenvolvimento inicial, mas são necessários para qualquer uso dos serviços do XBOX.
Por isso, recomendamos que você obtenha os três ao mesmo tempo.

#### IDs de área restrita

A área restrita oferece isolamento de conteúdo para o seu kit de desenvolvimento durante o desenvolvimento, garantindo que você tenha um ambiente limpo para desenvolver e testar seu título.
O ID da área restrita identifica sua área restrita.
Um console só pode acessar uma área restrita por vez, embora uma área restrita possa ser acessada por vários consoles.

Os IDs de área restrita diferenciam maiúsculas de minúsculas.

#### TitleID

O TitleID identifica de forma exclusiva o seu título para os serviços do XBOX.
O TitleID é usado em todos os serviços para permitir que os usuários acessem itens como o conteúdo do XBOX do seu título, as estatísticas de usuário e as conquistas, e para habilitar a funcionalidade multiplayer do XBOX.

Os Title IDs podem diferenciar maiúsculas de minúsculas, dependendo de como e onde são usados.

#### Identificador de configuração de serviço (SCID)

Como parte do desenvolvimento, você criará eventos, conquistas e vários outros recursos online.
Todos eles fazem parte da sua configuração de serviço e exigem o SCID para acesso.

Diferentemente de uma versão anterior do SO do XBOX, os títulos desenvolvidos para o Microsoft GDK Game OS têm apenas um SCID; portanto, todas as instâncias de um título em uma determinada área restrita compartilham a mesma configuração.

Os SCIDs do Microsoft GDK Game OS são sempre um GUID com o mesmo valor do TitleID, precedido de zeros.
Na grande maioria das interações com os serviços do XBOX a partir de um título do Microsoft Game Development Kit (GDK), o SCID não precisa mais ser especificado explicitamente, mas pode ser necessário se o título interagir diretamente com os pontos de extremidade REST dos serviços do XBOX.

Os SCIDs diferenciam maiúsculas de minúsculas.

## Obtendo seus IDs

Por enquanto, você obterá seus IDs trabalhando com seu gerente de conta de desenvolvedor.

## Configurando uma área restrita

Você não conseguirá iniciar seu kit de desenvolvimento sem definir o ID da área restrita.
Para isso, abra uma janela de comando do GDK e use o comando [Configuration (xbconfig.exe) (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconfig.md) da seguinte forma.

1. Verifique sua área restrita atual. Insira **xbconfig sandboxid** no prompt de comando.
2. Se ela não for a esperada, altere o ID da área restrita. Insira **xbconfig sandboxid=\<*your sandbox id*>** no prompt de comando.
3. Reinicie o console usando [Reboot (xbreboot.exe) (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbreboot.md) no prompt de comando.
4. Verifique se a área restrita foi redefinida corretamente. Insira **xbconfig sandboxid** no prompt de comando.

## Adicionando o TitleID e outros identificadores opcionais ao seu binário

Enquanto a área restrita é configurada no nível da plataforma para cada kit de desenvolvimento, o TitleID fica associado a um binário específico.
Para adicionar um TitleID ao seu binário, modifique o arquivo [MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-toc.md) desse binário adicionando um novo nó no nó `<Game>`, da seguinte forma.

```xml theme={null}
<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    ...
    <TitleId>yourTitleId</TitleId>
    <StoreId>yourStoreId</StoreId>
    <MSAAppId>yourMSAAppId</MSAAppId>
    ...
</Game>  
```

> [!NOTE]
>
> A partir do Microsoft Game Development Kit (GDK) de março de 2022, o MSAAppId e o TitleId são obrigatórios se qualquer um deles for especificado no MicrosoftGame.config. Para obter mais informações, consulte [Elemento MicrosoftGame.config - MSAAppId](https://docs.xbox.com/pt-BR/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-msaappid.md) e [Elemento MicrosoftGame.config - TitleId](https://docs.xbox.com/pt-BR/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md).

## O sinalizador RequiresXboxLive

Se o sinalizador **RequiresXboxLive** estiver definido como true, o título não será iniciado a menos que haja uma conexão ativa com a rede XBOX e o título passe na autenticação dos serviços do XBOX.
Isso garante que o título tenha recebido as atualizações de conteúdo mais recentes.
Se a conectividade for perdida enquanto o título estiver em execução, o título será suspenso e, posteriormente, encerrado.

Somente títulos que "exigem internet" devem marcar **RequiresXboxLive** como true. Observe que marcar seu título dessa forma não garante que os serviços necessários para o título estejam funcionando.
**RequiresXboxLive** também é um nó em `Game` no arquivo [MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-toc.md).


## Related topics

- [Áreas restritas](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/index.md)
- [Visão geral das áreas restritas dos serviços do Xbox](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [Solução de problemas de entrada nos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/identity/auth/live-troubleshooting-sign-in.md)
- [XGameGetXboxTitleId](https://docs.xbox.com/pt-BR/reference/system/xgame/functions/xgamegetxboxtitleid.md)
- [XSystemGetXboxLiveSandboxId](https://docs.xbox.com/pt-BR/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid.md)