XR-112 Estabelecimento de um usuário e um controle durante a ativação inicial e a retomada

Versão 2.0, 11/1/2025 Os títulos devem estabelecer um ou mais usuários ativos para funcionar como o usuário ou os usuários principais no título e lidar com o usuário ou os usuários ao retomar da suspensão, do modo de suspensão ou da hibernação. Os títulos fazem isso no GDK usando o Modelo de Usuário Simplificado ou o Modelo de Usuário Avançado. Títulos com o Modelo de Usuário Simplificado do GDK O Modelo de Usuário Simplificado no GDK lida com a aquisição do usuário padrão em nome do título. O título ainda é responsável por garantir que um controle seja atribuído ao usuário e por usar esse controle para a entrada do jogo. Se nenhum controle for atribuído ao usuário padrão, o título deverá usar XUserFindControllerForUserWithUiAsync para acionar a caixa de diálogo do sistema para selecionar um controle e começar a aceitar a entrada do jogador. Modelo de Usuário Avançado do GDK Na ativação inicial, os jogos podem optar por determinar o usuário inicial com base no design e na preferência do jogo, usando o usuário que iniciou o título ou solicitando explicitamente um usuário. O título deve indicar o(s) usuário(s) ativo(s) antes que a primeira ação relacionada ao perfil (como salvar o progresso ou as configurações) seja executada no perfil desse usuário. Todos os títulos do Microsoft Game Development Kit (GDK) que usam o modelo de usuário avançado devem fornecer um ponto de entrada para o seletor de contas para alterar o usuário ativo. Quando um título é retomado da suspensão, do modo de suspensão ou da hibernação, o título deve validar o emparelhamento de usuário/controle e reagir adequadamente, retomando a sessão do usuário anterior ou adquirindo um ou mais novos usuários.

​

Mais informações

Estabelecimento de usuários durante a ativação inicial Modelo de Usuário Simplificado do GDK O usuário inicial é fornecido ao título chamando XUserAddAsync(silent) e sempre retornará um único resultado para o usuário que iniciou o título. Modelo de Usuário Avançado do GDK e aplicativos ERA e UWP de vários usuários Se o jogo estiver usando o usuário que iniciou o título:

• No GDK, o usuário ativo pode ser determinado chamando XUserAddAsync(silent). Se o sistema retornar que não há um usuário padrão presente, o título deverá solicitar um usuário usando XUserAddAsync sem a opção silent. Isso exibirá um seletor de contas para o usuário.
• No ERA e no UWP, o usuário ativo pode ser encontrado a partir do usuário recomendado do contexto de ativação do aplicativo (CoreApplicationContext.CurrentUser). Se o contexto de ativação do aplicativo não tiver fornecido um usuário recomendado e o título executar ações relacionadas ao perfil, o título deverá iniciar o seletor de contas e definir o usuário ativo com base na seleção de perfil do usuário.

Se estiver solicitando um usuário:

• O título exibe um prompt de engajamento e deve mostrar o seletor de contas. O usuário é definido com base na seleção.
• No GDK, o seletor de contas é invocado usando XUserAddAsync
• No ERA e no UWP, o seletor de contas é invocado usando ShowAccountPickerAsync.

Se o usuário optar por cancelar a entrada, o título deverá notificar os usuários de que o progresso deles não será salvo se continuarem. Depois que um usuário tiver sido escolhido ou identificado a partir da inicialização, o título exibirá o gamertag antes que qualquer ação relacionada ao perfil seja executada. Não há requisitos sobre como ou onde o título mostra quem é o usuário ativo. As práticas recomendadas incluem exibir a imagem do jogador e o nome de exibição do usuário na tela principal do aplicativo ou no menu de título do jogo. Estabelecimento de controles durante a ativação inicial Os jogos precisam respeitar a associação de controle e usuário definida pelo seletor de contas ou pela plataforma quando o jogo é iniciado com um usuário conectado. A plataforma XBOX associará o controle a um jogador sempre que um jogador for selecionado no seletor de contas, durante ou fora da jogabilidade. Se o título estiver usando o usuário que iniciou o título, o título deverá usar o gamepad associado atribuído a esse usuário para conduzir a jogabilidade e a interação. Retomada da suspensão ou do modo restrito Modelo de Usuário Simplificado do GDK A plataforma XBOX garantirá que o usuário que iniciou o jogo inicialmente ainda esteja conectado ativamente. O título pode se registrar para receber notificações de alteração via UDA; se houver uma alteração, o título usará o controle recém-associado para conduzir a jogabilidade. Quaisquer usuários adicionais na jogabilidade precisarão ser tratados adequadamente, de acordo com as diretrizes a seguir do modelo de usuário avançado, ao retomar de um estado suspenso ou restrito. Modelo de Usuário Avançado do GDK e aplicativos ERA e UWP de vários usuários Quando um título é retomado da suspensão ou sai do modo restrito, o título deve validar o emparelhamento de usuário/controle e reagir adequadamente:

• Se não houver alterações no emparelhamento de usuário/controle, o título deverá prosseguir.
• No ERA ou no UWP, se o usuário ativo anterior de um título ainda estiver conectado, mas em um novo objeto User (geralmente causado pelo usuário sair e entrar novamente enquanto o título está suspenso), o título deverá usar o novo objeto User conectado como substituto do objeto User desconectado. O uso deve continuar como se o usuário nunca tivesse saído.
• Se todos os usuários esperados estiverem emparelhados com um controle válido, mas diferente, o título deverá atualizar e usar os novos emparelhamentos de controle do sistema.
• Se o usuário esperado não tiver nenhum controle válido, o título deverá estabelecer um controle ativo para o usuário usando o seletor de contas.
• Se o jogador esperado não estiver conectado, o título deverá remover o jogador do jogo ou restabelecer um usuário e um controle ativo. Os títulos geralmente fazem isso exibindo o seletor de contas. Se um novo usuário for escolhido como parte do restabelecimento de um usuário, os títulos deverão usar o estado desse novo usuário para a jogabilidade se o estado do jogo for salvo por usuário.

​

Recursos adicionais

Para obter informações sobre a identidade do jogador usando o GDK, leia a seção Usuários

​

Casos de teste de certificação

A tabela a seguir mostra quais casos de teste do XR-112 se aplicam ao seu título se ele usar o Modelo de Usuário Simplificado do GDK ou o Modelo de Usuário Avançado do GDK e aplicativos ERA e UWP de vários usuários.

​

112-02 Usuário e controle iniciais

Etapas de teste

1. Entre no Perfil A e inicie o título.
2. Verifique se o usuário ativo pode controlar o título.
3. Repita a etapa [1] sem nenhum perfil conectado e verifique se o título solicita o estabelecimento de um usuário ativo.
4. Estabeleça o usuário ativo e verifique se o usuário pode controlar o título.

Resultado esperado
Os títulos devem definir o usuário ativo como o emparelhamento de controle/usuário que iniciou o título, mostrar um prompt de engajamento para identificar o controle e o usuário ou exibir o seletor de contas para entrar. Exemplos de aprovação

1. O título define o usuário ativo como o emparelhamento de controle/usuário que iniciou o título.
2. O título mostra um prompt de engajamento para identificar o controle e o usuário.
3. O título exibe o seletor de contas para entrar.

Exemplos de falha

1. O título não permite que o usuário controle o título com o primeiro controle usado.
2. O título não solicita que o usuário estabeleça um usuário ativo quando é iniciado sem nenhum usuário conectado.

​

112-03 Nenhum usuário conectado

Etapas de teste

1. Verifique se nenhum usuário está conectado.
2. Inicie o título e entre em todos os modos que dão suporte ao salvamento de dados do usuário.
3. Valide se cada modo oferece ao usuário a oportunidade de entrar antes que ocorra qualquer perda de dados.
4. Cancele a oportunidade de entrar e verifique se o título fornece um aviso indicando que o progresso não será salvo.

Resultado esperado
Os títulos devem oferecer aos usuários a oportunidade de entrar se o título estiver em um modo que normalmente salvaria dados do usuário ou o estado do jogo. Os títulos devem notificar os usuários de que o progresso deles não será salvo se continuarem a jogar sem entrar Exemplos de aprovação

1. Um usuário que não está conectado recebe uma solicitação para entrar ao acessar um modo do título que normalmente salvaria dados do usuário ou o estado do jogo.
2. O usuário é notificado de que o progresso não será salvo se continuar no modo sem entrar.

Exemplos de falha

1. Enquanto estão em um modo que normalmente salva dados do usuário ou o estado do jogo, os usuários não são notificados de que o progresso não será salvo se continuarem nesse modo sem entrar.
2. Os usuários são notificados de que não poderão salvar o progresso depois que a perda de dados já ocorreu.

​

112-04 Indicação do usuário ativo

Etapas de teste

1. Entre em um perfil que nunca tenha visto o título antes e que não tenha dados salvos associados.
2. Inicie o título.
3. Verifique se o título identifica o usuário ativo na interface do usuário antes de executar qualquer ação relacionada ao perfil. Exemplos de “ação relacionada ao perfil” incluem alterar o jogo salvo ou as preferências de um usuário, salvar dados no perfil do usuário, conceder conquistas, gravar estatísticas para um usuário ou qualquer outro uso ou manipulação local ou na nuvem de dados ou do estado do usuário.
4. Crie um salvamento.
5. Inicie o título novamente e verifique se o título identifica o usuário ativo na interface do usuário antes de executar qualquer ação relacionada ao perfil.
6. Desconecte-se do XBOX Live.
7. Inicie o título novamente e verifique se o título identifica o usuário ativo na interface do usuário antes de executar qualquer ação relacionada ao perfil.

Resultado esperado
Os títulos devem indicar o contexto do usuário atual antes da primeira ação relacionada ao perfil. Exemplos de aprovação

1. O título exibe o gamertag e/ou a imagem do jogador do usuário no título antes de executar qualquer ação relacionada ao perfil.
2. Um título que não usa perfis de usuário não indica o usuário ativo.
3. Um título exibe vários usuários ativos para modos de jogo que dão suporte a vários usuários.

Exemplos de falha

1. O título não indica o usuário ativo do título antes de executar ações relacionadas ao perfil.

​

112-05 Acesso ao seletor de contas

Etapas de teste

1. Entre em um perfil e inicie o título.
2. Confirme se o título permite que o usuário ativo acesse o seletor de contas no título e selecione um perfil diferente.

Resultado esperado
Os títulos devem permitir que os usuários acessem o seletor de contas no título para alterar o usuário ativo. Exemplos de aprovação

1. O título permite que o usuário acesse o seletor de contas no título.

Exemplos de falha

1. O título não permite que o usuário acesse o seletor de contas no título.

​

112-06 Tratamento da alteração de perfil

Etapas de teste

1. Entre em um perfil e inicie o título.
2. Acesse o seletor de contas e selecione um perfil diferente.
3. Verifique se o título reage adequadamente e alterna o contexto do usuário ativo para o novo perfil.
4. Repita as etapas 1 a 4 para cada local no título em que haja acesso ao seletor de contas.

Resultado esperado
Os títulos devem permitir que os usuários mudem facilmente para o contexto de outro usuário. Exemplos de aprovação

1. O título notifica o usuário de que alterar o usuário ativo pode resultar em perda de dados e solicita a confirmação do usuário antes de prosseguir para o seletor de contas.
2. O título é atualizado adequadamente para o contexto do novo usuário ativo.

Exemplos de falha

1. O título não é atualizado adequadamente para o contexto do novo usuário ativo.

​

112-07 Alteração de usuário durante o modo restrito

Etapas de teste

1. Entre no perfil A e inicie o título.
2. Em vários locais dentro do título, pressione o Xbox button para colocar o título em estado restrito.
3. Enquanto o título estiver restrito, saia do Perfil A e entre no perfil B.
4. Retome o título.
5. Verifique se o título reage adequadamente ao novo usuário ativo.

Resultado esperado Quando um título é retomado do modo restrito, o título deve verificar se todos os usuários engajados anteriormente ainda estão conectados ao console Exemplos de aprovação

1. Um aplicativo alterna automaticamente o contexto do usuário ativo para o Perfil B ao ser retomado.
2. Um título de jogo remove automaticamente o Perfil A do título ou restabelece um novo usuário e usa o estado desse novo usuário para a jogabilidade.

Exemplos de falha

1. Os títulos não são atualizados para remover o perfil A do contexto como usuário ativo.
2. Um jogo continua usando o estado do Perfil A para a jogabilidade depois que um novo perfil é selecionado.

​

112-08 Alteração de usuário durante a suspensão

Em consoles de varejo, um jogo será suspenso nas seguintes condições:

• Quando o console entra em Espera Conectada ao ser desligado com o modo de energia definido como Inicialização instantânea.
• Quando o jogo permanece fora de foco por dez minutos. Por exemplo, ao iniciar um aplicativo como Configurações e mantê-lo em foco por dez minutos.

Para os fins deste caso de teste, ambos os métodos devem ser verificados na etapa 2. Etapas de teste

1. Entre em um perfil XBOX e inicie o jogo.
2. Em vários locais ao longo do jogo, suspenda o jogo.
3. Enquanto o jogo estiver suspenso, saia do perfil A e entre no perfil B.
4. Retome o jogo e verifique se o jogo reage adequadamente ao novo usuário ativo.
5. Entre na jogabilidade com o novo usuário ativo e verifique se o usuário consegue progredir.

Resultado esperado

1. Quando um jogo é retomado da suspensão, o jogo deve verificar se todos os usuários engajados anteriormente ainda estão conectados ao console.

Exemplos de aprovação

1. O jogo alterna automaticamente o contexto do usuário ativo para o perfil B ao ser retomado.
2. O jogo remove automaticamente o perfil A do jogo ou restabelece um novo usuário e usa o estado desse novo usuário para a jogabilidade.

Exemplos de falha

1. O jogo não é atualizado para remover o perfil A do contexto como usuário ativo.
2. O jogo continua usando o estado do perfil A para a jogabilidade depois que um novo perfil é selecionado.