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

# Quando ocorrem as associações entre usuário e controle?

> Quando ocorrem as associações entre usuário e controle?

Quando um controle é associado com êxito a um usuário, pressionar o botão
nexus nesse controle mostrará a experiência personalizada desse usuário no
Guia e no Painel. Os usuários precisam sentir que entendem e controlam
quando isso acontece. Sempre que a associação entre um usuário e um controle
mudar, haverá um
[XUserDeviceAssociationChangedCallback](/pt-BR/reference/system/xuser/functions/xuserdeviceassociationchangedcallback).

Novas associações podem ser formadas das seguintes maneiras:

* Sempre que um seletor de conta é exibido.
* Chamando [XUserAddAsync](/pt-BR/reference/system/xuser/functions/xuseraddasync).
* Chamando [XUserFindControllerForUserWithUiAsync](/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync).
* Quando há um único usuário conectado ao console, o primeiro controle
  que receber entrada do usuário será associado a ele.
* Quando um usuário opta por iniciar (ou reiniciar) um jogo usando um controle
  não associado, esse controle será automaticamente associado a esse usuário.
* Usando o aplicativo Acessórios XBOX, um usuário pode associar um determinado controle a
  um usuário. Quando esse controle for ligado, o usuário especificado será conectado
  e esse controle será então associado a esse usuário.
* Recolocar uma bateria em um controle reassociará automaticamente
  esse controle ao proprietário anterior

As associações podem ser perdidas quando:

* O controle é desligado (por exemplo, perda de bateria)
* O usuário se desconecta
* O controle é associado a um novo usuário (o usuário original será informado
  de que a associação foi perdida.)

O exemplo a seguir ilustra como as associações de controle podem mudar no console,
os eventos que são disparados e as ações que um jogo pode executar.

| Etapa | Descrição | Ações do jogo | Estado do usuário A | Estado do usuário B |
| - | - | - | - | - |
| 1 | O usuário A está conectado e inicia o jogo usando o controle 1. | O jogo se registra para *XUserDeviceAssociationChangedCallback* e chama *XUserAddAsync*. | O usuário A é conhecido pelo jogo. Por meio do retorno de chamada, o jogo sabe que o controle 1 está associado ao usuário A | N/A |
| 2 | Durante a jogabilidade, o usuário volta para a página inicial e o jogo continua em execução. | | Nenhuma alteração | N/A |
| 3 | O usuário A conecta o usuário B usando o controle 1. | *XUserDeviceAssociationChangedCallback* é disparado. | O usuário A ainda é conhecido pelo jogo, mas não tem mais um controle associado a ele. | O usuário B está conectado ao console, mas não é visível para o jogo. Ele está associado ao controle 1. |
| 4 | O usuário A retorna ao jogo, ainda usando o controle 1. | Como prática recomendada, o jogo deve chamar *XUserFindControllerForUserWithUiAsync* para garantir que o usuário A esteja corretamente associado a um controle. | O usuário A está associado ao controle que ele selecionou. | Se o usuário A selecionou novamente o controle 1 em vez de um novo controle, o usuário B não está mais associado a um controle. |

## Confira também

[XUserAddAsync](/pt-BR/reference/system/xuser/functions/xuseraddasync)

[XUserDeviceAssociationChangedCallback](/pt-BR/reference/system/xuser/functions/xuserdeviceassociationchangedcallback)

[XUserFindControllerForUserWithUiAsync](/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync)


## Related topics

- [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)
- [XR-115 Adição e remoção de usuários ou controles durante a jogabilidade](/pt-BR/publishing/certification/xr/xr-115.md)
- [Casos de teste com mais falhas](/pt-BR/publishing/certification/xr-top-failing.md)
- [Requisitos XBOX testados na certificação para jogos de console XBOX](/pt-BR/publishing/certification/console-cert-tested-requirements.md)
- [XR115 Adição e remoção de usuários ou controles durante o jogo](/pt-BR/publishing/certification/fma/xr-115.md)