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.- Obtenha seus IDs.
- Defina as áreas restritas nos seus kits de desenvolvimento.
- 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) da seguinte forma.- Verifique sua área restrita atual. Insira xbconfig sandboxid no prompt de comando.
- Se ela não for a esperada, altere o ID da área restrita. Insira xbconfig sandboxid=<your sandbox id> no prompt de comando.
- Reinicie o console usando Reboot (xbreboot.exe) (tópico sob NDA) no prompt de comando.
- 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 desse binário adicionando um novo nó no nó<Game>, da seguinte forma.
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 e Elemento MicrosoftGame.config - TitleId.
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ó emGame no arquivo MicrosoftGame.config.