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

# 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](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md).

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

* Sempre que um seletor de conta é exibido.
* Chamando [XUserAddAsync](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuseraddasync.md).
* Chamando [XUserFindControllerForUserWithUiAsync](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync.md).
* 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](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuseraddasync.md)

[XUserDeviceAssociationChangedCallback](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md)

[XUserFindControllerForUserWithUiAsync](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync.md)


## Related topics

- [Usuários](https://docs.xbox.com/pt-BR/build/core-features/common/user/user-toc.md)
- [Identidade do usuário e APIs XUser no GDK](https://docs.xbox.com/pt-BR/build/core-features/common/user/index.md)
- [Diretriz de acessibilidade do Xbox 107](https://docs.xbox.com/pt-BR/build/game-principles/accessibility/xag-deep-dives/xag-107-input.md)
- [Usuários e dispositivos de entrada](https://docs.xbox.com/pt-BR/build/core-features/common/user/users-input-devices.md)
- [Conflitos do Game Saves](https://docs.xbox.com/pt-BR/services/playfab/player-progression/game-saves/conflicts.md)