Prise en charge multiplateforme de XUser

​

Vue d’ensemble

​

Exigences d’intégration

​

Consoles XBOX et Microsoft Store / Game Pass sur Windows

​

Autres boutiques sur Windows

• Les jeux utilisent les services et l’interface utilisateur intégrés du système d’exploitation.
• Le programme d’installation doit exécuter GamingRepair.exe pour garantir que le service Gaming Runtime est installé.

1. Incluez l’outil dans le package de votre jeu : il est fourni avec le GDK dans [GDK]\bin\GamingRepair.exe.
2. Ajoutez une action personnalisée : exécutez l’outil avant l’installation de votre jeu (par exemple : start /wait “Installing Gaming Services” GamingRepair.exe scenarioExternal). Cela vérifie, télécharge, installe ou répare tous les composants Gaming Runtime manquants.
3. Gérez les erreurs : vérifiez le code de sortie de l’outil. En cas d’échec, informez l’utilisateur et fournissez des instructions d’installation manuelle.

​

Différences entre plateformes et API unifiée

• Sur les plateformes avec prise en charge native (XBOX, Windows) : XUser utilise les services intégrés du système d’exploitation pour l’authentification, l’interface utilisateur et le stockage des informations d’identification. Les jeux appellent les API XUser et le système gère automatiquement les détails.
• Sur les plateformes sans prise en charge native (Steam Deck, etc.) : XUser expose les mêmes API principales, mais les jeux doivent implémenter des gestionnaires d’événements pour fournir l’interface utilisateur nécessaire (comme l’affichage de codes QR pour la connexion) et le stockage des données. Cela donne aux jeux un contrôle total sur l’expérience d’authentification.

​

Nouvelles fonctionnalités multiplateformes

​

Authentification Remote Connect

​

Application de session unique (SPoP)

​

Remote Connect pour la connexion entre appareils

​

Fonctionnement

​

Le flux

1. Inscription du gestionnaire d’événements : le jeu inscrit un gestionnaire d’événements Remote Connect avant de lancer la connexion à l’aide de XUserPlatformRemoteConnectSetEventHandlers(...). Le titre fournit des rappels pour gérer deux événements clés :
   • Événement Show : déclenché lorsque XUser a besoin que le jeu affiche le code à usage unique ou le code QR. Le gestionnaire présente une boîte de dialogue ou une superposition avec le code et des instructions (par exemple : « Scannez ce code QR ou rendez-vous sur xbox.com/play et saisissez le code ABCD pour vous connecter »).
   • Événement Close : déclenché lorsque le processus de connexion à distance se termine ou est annulé, signalant au jeu de masquer ou de fermer la boîte de dialogue du code.
2. Lancement de la connexion de l’utilisateur : lors de l’appel à XUserAddAsync pour ajouter un nouvel utilisateur, si aucun utilisateur local n’est déjà connecté, le système XUser peut utiliser le flux Remote Connect (en particulier sur les plateformes sans affichage ou tierces).
3. Affichage du code : XUser appelle le rappel « show », en fournissant le code ou l’URL d’authentification. Le gestionnaire d’interface du jeu (tel que OnRemoteConnectShow) affiche le code QR ou la chaîne de code à l’utilisateur.
4. Authentification de l’utilisateur : le joueur utilise son téléphone ou son navigateur web pour se connecter avec le code fourni, liant ainsi son compte XBOX à la session en cours.
5. Achèvement : une fois l’authentification terminée côté serveur, XUser appelle le rappel « close », signalant que le code peut être retiré de l’écran. À ce stade, XUser a obtenu le jeton XBOX Live de l’utilisateur et crée le XUserHandle.
6. Réussite : la tâche XUserAddAsync se termine avec succès et l’utilisateur est connecté sans avoir saisi d’informations d’identification directement sur l’appareil.

​

Implémentation

XUserPlatformRemoteConnectEventHandlers remoteConnect = {};
remoteConnect.context = nullptr;
remoteConnect.show = &OnRemoteConnectShow;   // Display QR/code dialog
remoteConnect.close = &OnRemoteConnectClose; // Dismiss dialog

HRESULT hr = XUserPlatformRemoteConnectSetEventHandlers(nullptr, &remoteConnect);

​

Considérations relatives à l’expérience utilisateur

• Instructions claires : expliquez clairement ce que l’utilisateur doit faire lors de l’affichage du code.
• Gestion des erreurs : si l’utilisateur annule côté distant ou si une erreur se produit, XUser fait échouer la tentative de connexion. Gérez ce cas dans le rappel d’achèvement normal de XUserAddAsync.
• Fermeture rapide : masquez le code immédiatement lorsque l’événement de fermeture se produit afin d’éviter toute confusion pour l’utilisateur.
• Conception visuelle : assurez-vous que le code QR et les instructions sont suffisamment grands et clairement visibles sur l’appareil cible.

​

Application de session unique (SPoP)

​

Fonctionnement

​

Le flux

1. Inscription du gestionnaire d’événements : le jeu inscrit un gestionnaire d’événements d’invite SPoP avant de lancer la connexion à l’aide de XUserPlatformSpopPromptSetEventHandlers(...).
2. Détection des conflits : lors de l’appel à XUserAddAsync pour ajouter un utilisateur, si XUser détecte que le même utilisateur est déjà actif ailleurs dans le même titre, il appelle le gestionnaire SPoP.
3. Affichage de l’invite : le gestionnaire du jeu reçoit le gamertag moderne de l’utilisateur et un handle d’opération. Le gestionnaire doit afficher une invite d’interface utilisateur telle que : « [Gamertag] joue déjà sur un autre appareil. Voulez-vous plutôt jouer ici (ce qui vous déconnectera de l’autre appareil) ou passer à un autre compte ? » avec des options comme « Jouer ici » et « Changer de compte ».
4. Choix de l’utilisateur : le jeu attend que l’utilisateur fasse un choix. L’opération reste en attente jusqu’à ce que le jeu appelle l’API d’achèvement.
5. Achèvement de l’opération : en fonction du choix de l’utilisateur, le jeu appelle XUserPlatformSpopPromptComplete avec le résultat approprié :
   • Jouer ici : XUserPlatformSpopOperationResult::SignInHere : connecte l’utilisateur sur cet appareil et met fin à la session distante.
   • Changer de compte : XUserPlatformSpopOperationResult::SwitchAccount : annule la connexion sur cet appareil, ce qui permet à l’utilisateur de choisir un autre compte.
   • Annuler : XUserPlatformSpopOperationResult::Canceled : abandonne la tentative de connexion.
6. Résolution : XUser poursuit en fonction du résultat. Si « Jouer ici » a été choisi, la session distante est terminée (l’autre appareil reçoit un événement de déconnexion) et l’utilisateur devient actif localement. Si « Changer de compte » a été choisi, XUserAddAsync échoue et le jeu peut demander un autre compte.

​

Implémentation

HRESULT hr = XUserPlatformSpopPromptSetEventHandlers(nullptr, &OnSpopPrompt, nullptr);

// If user chose "Play here"
XUserPlatformSpopPromptComplete(operation, XUserPlatformSpopOperationResult::SignInHere);

// If user chose "Switch account"
XUserPlatformSpopPromptComplete(operation, XUserPlatformSpopOperationResult::SwitchAccount);

// If dialog was canceled
XUserPlatformSpopPromptComplete(operation, XUserPlatformSpopOperationResult::Canceled);

​

Considérations relatives à l’expérience utilisateur

• Message clair : affichez le gamertag de l’utilisateur et expliquez clairement que continuer le déconnectera de l’autre appareil.
• Options visibles : rendez les options « Jouer ici » et « Changer de compte » clairement visibles et compréhensibles.
• Prévention des conflits de sauvegarde : soulignez que cela évite les conflits de sauvegardes et les problèmes de jeu simultané.
• Comportement propre à la plateforme : sur XBOX et Windows, le système d’exploitation gère cela automatiquement et le gestionnaire SPoP n’est jamais appelé. Sur les autres plateformes, il incombe à votre jeu de présenter ce choix.

​

Voir aussi