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

# Gérer la perte de manette

> Gérer la perte de manette

L'association d'une manette à un utilisateur est essentielle pour la plupart des jeux. Lorsque le
jeu perd toutes les manettes de ce type pour un utilisateur (p. ex., la pile est à plat), l'approche
standard pour un jeu à un seul joueur consiste à mettre le jeu en pause et à afficher une boîte de dialogue
demandant à l'utilisateur d'allumer une manette.

À l'aide de la fonction [XUserFindControllerForUserWithUiAsync](/fr-CA/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync),
les jeux peuvent améliorer cette expérience. Cette fonction prend un XUserHandle
en entrée et affiche une boîte de dialogue :

\<\<Gamer>>, vous avez besoin d'une manette pour ce jeu.
Maintenez le bouton A enfoncé pour confirmer la manette que vous voulez utiliser

Une fois que l'utilisateur a confirmé sa manette, le jeu peut appeler
[XUserFindControllerForUserWithUiResult](/fr-CA/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult)
pour obtenir l'APP\_LOCAL\_DEVICE\_ID de la manette choisie. Plus important encore, cette
manette est maintenant associée à cet utilisateur. Si cet utilisateur appuie ensuite sur le bouton nexus,
le guide XBOX affiche les informations de cet utilisateur.

Notez que le joueur peut annuler cette boîte de dialogue sans sélectionner de manette, et le titre doit gérer cette annulation de façon appropriée.  Par exemple, un titre pourrait appeler [XUserFindControllerForUserWithUiAsync](/fr-CA/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync) à répétition pour forcer une sélection, ou revenir à l'écran titre puisqu'il n'y a plus de correspondance utilisateur/manette, ou adopter tout autre comportement qui a du sens pour le titre.

Notez également qu'avec ce processus, les utilisateurs peuvent être associés à des manettes qui étaient auparavant associées à d'autres utilisateurs dans le jeu. Ce comportement est voulu.

Chaque fois que l'association entre un utilisateur et une manette change, un
[XUserDeviceAssociationChangedCallback](/fr-CA/reference/system/xuser/functions/xuserdeviceassociationchangedcallback) est déclenché.
À noter : cet événement est aussi déclenché lors du jumelage réussi d'un utilisateur à une manette
résultant de l'appel de
[XUserFindControllerForUserWithUiAsync](/fr-CA/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync).

## Voir aussi

[XUserFindControllerForUserWithUiAsync](/fr-CA/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync)


## Related topics

- [XR-112 Établissement d'un utilisateur et d'une manette lors de l'activation initiale et de la reprise](/fr/publishing/certification/xr/xr-112.md)
- [Exigences XBOX pour les jeux XBOX](/fr-CA/publishing/certification/xbox-requirements.md)
- [Exigences XBOX testées lors de la certification pour les jeux sur console XBOX](/fr-CA/publishing/certification/console-cert-tested-requirements.md)
- [XBOX Requirements pour les jeux XBOX](/fr/publishing/certification/xbox-requirements.md)
- [XR115 Ajout et retrait d'utilisateurs ou de manettes pendant la partie](/fr/publishing/certification/fma/xr-115.md)