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

# XR-115 Adição e remoção de usuários ou controles durante a jogabilidade

> Os títulos que dão suporte a vários usuários devem responder à adição e à remoção de usuários ou a cenários em que um jogador ativo não tem um controle atribuído ou perde o controle durante a jogabilidade.

Versão 1.1, 5/1/2021

Os títulos que dão suporte a vários usuários devem responder à adição e à remoção de usuários ou a cenários em que um jogador ativo não tem um controle atribuído ou perde o controle durante a jogabilidade, da seguinte forma:

**Adição de controle:** depois que os títulos tiverem selecionado ou recebido o usuário e o controle iniciais, eles poderão, opcionalmente, aceitar entradas de outros controles. Os títulos que dão suporte a experiências multijogador devem considerar como um jogador ou controle adicional é adicionado à jogabilidade e associado a um usuário com XUserAddAsync. Por exemplo, "Pressione A para entrar" ou a ilustração da silhueta de um controle em uma tela de seleção de jogador.

**Remoção de controle:** se o controle do jogador que está conduzindo a jogabilidade for removido durante a jogabilidade, os títulos deverão permitir o restabelecimento de um novo controle ativo (por exemplo, "Pressione A para continuar" ou o recebimento de um evento ControllerPairingChanged no ERA ou XUserDeviceAssociationChangedCallback no GDK para o usuário ativo com um controle válido). Os títulos também podem invocar a UX do sistema usando XUserFindControllerForUserWithUiAsync para solicitar que o usuário emparelhe um controle ao seu usuário e retorne à jogabilidade.

**Adição de usuário:** ao usar o GDK (com o Modelo de Usuário Simplificado ou o Avançado), os usuários só são adicionados quando o título chama XUserAddAsync.

**Remoção do usuário principal:** para títulos que usam o modelo de usuário avançado do GDK, se o usuário principal sair (pelo guia, pelo SPOP ou por outros meios), o título deverá remover o jogador do jogo ou restabelecer um usuário e um controle ativo.

Para títulos que usam o Modelo de Usuário Simplificado do GDK, a remoção do jogador principal resultará na suspensão do título no nível do sistema.

Em todos os cenários, os títulos lidam com a remoção/o fechamento colocando o jogo em um estado adequado. Isso inclui gravar no armazenamento conectado, notificar todas as sessões relevantes do MPSD de que o usuário saiu e levar o usuário a um local apropriado para entrar, caso um novo usuário também não tenha sido adicionado.

**Remoção de usuário adicional/secundário:** os títulos podem lidar com esse evento a seu critério, geralmente removendo o jogador da jogabilidade imediatamente ou solicitando que o jogador entre novamente no contexto da experiência multijogador que está sendo usada.

## Diretrizes de implementação e práticas recomendadas

Uma prática recomendada é pausar a jogabilidade quando o controle de um jogador ativo for removido.

Quando os usuários ativos saem, é uma prática recomendada salvar o máximo possível do progresso do usuário para que, quando os usuários retornarem à experiência, eles estejam quase de volta ao ponto em que pararam.

Se um título der suporte a vários usuários conectados, quando um usuário ativo sair e outros usuários ativos ainda estiverem conectados, a prática recomendada é permitir que os outros usuários ativos continuem a experiência atual o máximo possível. Em jogos, o usuário que saiu pode ser removido completamente da jogabilidade ou substituído por um jogador controlado pelo computador.

## Recursos adicionais

## Casos de teste de certificação

A tabela a seguir mostra quais casos de teste do XR-115 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.

| Casos de teste | Aplicável ao Modelo de Usuário Simplificado do GDK | Aplicável ao Modelo de Usuário Avançado do GDK e MUA do ERA e UWP |
| - | - | - |
| 115-01 Adição de usuários | Não | Sim \* |
| 115-02 Remoção de controles | Sim | Sim |
| 115-03 Remoção de usuários | Não | Sim |

\* **115-01 Adição de usuários** se aplica somente a aplicativos ERA e UWP de vários usuários. Com o GDK, os títulos só conseguem ver os usuários que adicionaram intencionalmente. Os usuários adicionados pelo shell são desconhecidos para o título do GDK.

<br />

**115-01 Adição de usuários**

> **Etapas de teste**
>
> 1. Entre no Perfil A e verifique se nenhum outro perfil está conectado.
> 2. Inicie o título e avance para a jogabilidade.
> 3. Em vários pontos durante o uso do título, conecte um segundo controle e entre no Perfil B.
> 4. O Perfil B tenta fornecer entrada de controle ao título.
>
> **Resultado esperado**<br />Os títulos MUA do ERA ou do UWP não devem interromper automaticamente a experiência do usuário ativo.
>
> **Exemplos de aprovação**
>
> 1. Os títulos não alternam automaticamente o usuário ativo para o novo usuário nem interrompem a experiência do usuário ativo.
> 2. Os títulos de jogos podem optar por permitir que o Perfil B controle o título, dependendo do contexto atual.
>
> **Exemplos de falha**
>
> 1. O título alterna imediatamente o contexto para o Perfil B como usuário ativo.

<br />

**115-02 Remoção de controles**

> **Etapas de teste**
>
> 1. Entre em um perfil e inicie o título.
> 2. Em vários pontos durante o uso do título, remova as pilhas do controle.
> 3. Recoloque as pilhas no controle e verifique se o usuário pode continuar usando o título.
> 4. Repita as etapas \[1] - \[3], mas conecte um segundo controle em vez de recolocar as pilhas.
>
> **Resultado esperado**<br />Os títulos devem responder corretamente à remoção e à adição de controles.
>
> **Exemplos de aprovação**
>
> 1. O usuário ativo deve conseguir continuar usando o título após a remoção ou a adição de um controle.
> 2. O usuário recebe uma solicitação para restabelecer um novo controle ativo (por exemplo, "Pressione A para continuar" ou por meio da invocação da UX do sistema).
>
> **Exemplos de falha**
>
> 1. Os usuários não conseguem continuar usando um título após a remoção de um controle.

<br />

**115-03 Remoção de usuários**

> **Etapas de teste**
>
> 1. Entre no Perfil A e verifique se nenhum outro perfil está conectado.
>
> 2. Inicie o título e avance para a jogabilidade.
>
> 3. Em vários pontos durante o uso do título, saia do Perfil A.
>
> 4. Verifique se o título invoca o seletor de contas ou retorna o usuário à tela inicial do título.
>
> 5. Sempre que possível, interaja com o título das seguintes maneiras:
>
> * Entre no Perfil A e verifique se o título não interrompe ainda mais a experiência do usuário.
> * Entre no Perfil B e verifique se o título é atualizado para o contexto do novo usuário.
>
> **Resultado esperado**<br />O título deve remover o jogador do jogo ou restabelecer um usuário e um controle ativo. Se o jogador for removido do jogo, o título deverá ser deixado em um estado adequado. Isso inclui gravar no armazenamento conectado, notificar todas as sessões relevantes do MPSD de que o usuário saiu e levar o usuário a um local apropriado para entrar, caso um novo usuário também não tenha sido adicionado.
>
> **Exemplos de aprovação**
>
> 1. O título remove o jogador do jogo e retorna à tela inicial do título.
> 2. O título permite que o usuário restabeleça um novo usuário e é atualizado corretamente para o contexto de usuário relevante.
>
> **Exemplos de falha**
>
> 1. O título não reage à alteração no estado do usuário.
> 2. O título continua usando o estado de usuário do Perfil A depois que um novo perfil é selecionado.


## Related topics

- [Requisitos XBOX testados na certificação para jogos de console XBOX](/pt-BR/publishing/certification/console-cert-tested-requirements.md)
- [Requisitos do XBOX para jogos do XBOX](/pt-BR/publishing/certification/xbox-requirements.md)
- [XR115 Adição e remoção de usuários ou controles durante o jogo](/pt-BR/publishing/certification/fma/xr-115.md)
- [Conteúdo de suporte aos requisitos e políticas do XBOX](/pt-BR/publishing/certification/xr/overview.md)
- [XR-112 Estabelecimento de um usuário e um controle durante a ativação inicial e a retomada](/pt-BR/publishing/certification/xr/xr-112.md)
