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

# Gestion de la perte de manette

> Gestion de 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 (par exemple, si la batterie est vide),
l'approche standard pour un jeu solo consiste à le mettre en pause et à afficher une boîte de dialogue
demandant à l'utilisateur d'allumer une manette.

Avec la fonction [XUserFindControllerForUserWithUiAsync](/fr/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 souhaitez utiliser

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

Notez que le joueur peut fermer cette boîte de dialogue sans sélectionner de manette, et le titre doit gérer cette annulation de manière appropriée.  Par exemple, un titre peut appeler [XUserFindControllerForUserWithUiAsync](/fr/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync) à plusieurs reprises pour imposer une sélection, revenir à l'écran titre puisqu'il n'existe plus de mappage utilisateur/manette, ou adopter tout autre comportement pertinent 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 du jeu. Ce comportement est intentionnel.

Chaque fois que l'association entre un utilisateur et une manette change, un
[XUserDeviceAssociationChangedCallback](/fr/reference/system/xuser/functions/xuserdeviceassociationchangedcallback) se produit.
À noter que cet événement se déclenche également lors de l'association réussie d'un utilisateur à une manette
résultant d'un appel à
[XUserFindControllerForUserWithUiAsync](/fr/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync).

## Voir aussi

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