Utilisation côté client des privilèges utilisateur des services XBOX

​

Table des matières

• Prérequis
• Gestion côté client et expérience du joueur pour les privilèges et la vente incitative
• Bonnes pratiques de gestion des privilèges côté application
• Test du contrôle d’accès basé sur les privilèges dans vos jeux
• ID de privilège à vérifier

​

Prérequis

​

Gestion côté client et expérience du joueur pour les privilèges et la vente incitative

1. Le joueur voit une option permettant de démarrer une session multijoueur et tente de lancer une partie en sélectionnant l’option appropriée dans l’interface.
2. Le jeu vérifie l’« indice » à l’aide de l’API XUserCheckPrivilege.
   • S’il est présent, considérez que le joueur dispose du privilège et poursuivez.
   • S’il n’est pas présent, passez à l’étape suivante.

   [!NOTE] Les API des services XBOX renvoient un code d’état 403 (HTTP_E_STATUS_FORBIDDEN) lorsque l’accès à une fonctionnalité est refusé en raison d’un privilège manquant dans le XToken. Tous les points de terminaison des services XBOX appliquent le contrôle d’accès basé sur les privilèges lorsque cela est approprié.

3. En réponse au code d’échec, le jeu appelle alors XUserResolvePrivilegeWithUiAsync avec l’ID de privilège approprié correspondant à celui que vous essayez de résoudre. Cette fonction appelle les services XBOX pour vérifier si le joueur dispose du privilège, puis indique au joueur pourquoi l’action a échoué ou lui affiche l’interface permettant de résoudre le problème. Cet appel d’API peut entraîner les résultats suivants.
   • Afficher l’interface relative à l’état d’application des sanctions du joueur émis par les modérateurs des stratégies et de l’application des règles des services XBOX.
   • Afficher l’interface relative au contrôle parental.
   • Promouvoir un service d’abonnement applicable, comme un abonnement XBOX Game Pass Essential.
   • Renvoyer le résultat au jeu (réussite ou échec, avec une raison).

   [!NOTE] Si les services XBOX ou le réseau sont inaccessibles, XUserResolvePrivilegeWithUiAsync échoue. Cet échec doit être traité comme si le joueur ne disposait pas du privilège.

4. Au retour de XUserResolvePrivilegeWithUiAsync :
   1. Si un échec est renvoyé, le jeu doit permettre au joueur de continuer à sélectionner le bouton, car (par exemple) les bannissements du joueur peuvent expirer ou le contrôle parental peut changer.
   2. Si une réussite est renvoyée, le problème du joueur a été résolu et votre jeu peut tenter à nouveau l’action. Le jeton du joueur contiendra les privilèges nécessaires à l’issue de la résolution effectuée par XUserResolvePrivilegeWithUiAsync.

Pour plus d’informations sur les privilèges applicables à votre titre, consultez la XR-015 dans la rubrique Stratégies et exigences XBOX.

​

Exemple de code

XUserPrivilegeDenyReason reason;
bool hasPrivilege = false;

// check the Multiplayer (254) privilege
HRESULT hr = XUserCheckPrivilege(userHandle, XUserPrivilegeOptions::None, XUserPrivilege::Multiplayer, &hasPrivilege, &reason);

// error with the user such that we can't yet check privileges
if(E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED == hr)
{
      asyncBlock.callback = [](XAsyncBlock *async)
      {
         HRESULT hr = XUserResolveIssueWithUiResult(async);
         // if SUCCEEDED(hr), the issue is resolved, try the privilege check again
         // if FAILED(hr), the issue is not resolved, the title should deny access to the user, and perhaps try again later
      };

      hr = XUserResolveIssueWithUiAsync(userHandle, nullptr, &asyncBlock);
}

// user doesn't have the requested privilege, try to resolve the issue
else if(!hasPrivilege)
{
      asyncBlock.callback = [](XAsyncBlock *async)
      {
         HRESULT hr = XUserResolvePrivilegeWithUiResult(async);
         // if SUCCEEDED(hr), all privilege issues are now resolved, the user has the privilege,
         //    and the title should continue. It is not necessary to call XUserCheckPrivilege again.
         // if FAILED(hr), the user did not resolve all privileges, the title should deny access to the user and perhaps try again later
      };

      hr = XUserResolvePrivilegeWithUiAsync(userHandle, XUserPrivilegeOptions::None, XUserPrivilege::Multiplayer, &asyncBlock);
}
else if(hasPrivilege)
{
      // the user has the privilege, continue!
}

​

Bonnes pratiques de gestion des privilèges côté application

​

Fréquence de résolution des privilèges dans l’application

• Pour les applications de streaming multimédia, comme les lecteurs vidéo, résolvez les vérifications de privilèges à chaque sélection du bouton Lecture (début du flux) ou au début d’une playlist (pour plusieurs flux, comme une playlist musicale).
• Pour les applications de messagerie, vérifiez les privilèges une fois, pour le premier message envoyé.
• Pour les jeux multijoueur qui utilisent des services de matchmaking tiers, résolvez les vérifications de privilèges au début de chaque session (partie).

​

Ne jamais présumer du niveau d’abonnement d’un utilisateur

​

Mode hors ligne

​

Cibler le bon joueur

​

Vérification sans interface ou avec l’interface hors focus

​

Test du contrôle d’accès basé sur les privilèges dans vos jeux

• Droits d’abonnement effectifs du joueur
• Droits de privilège effectifs de l’appareil
• Droits de privilège effectifs de la plateforme cliente
• Droits de privilège effectifs du jeu en cours
  • Il est possible d’empaqueter un jeu avec un ensemble de privilèges afin que tous les joueurs du jeu obtiennent automatiquement ces privilèges pour une utilisation dans le jeu en cours d’exécution. Si votre jeu nécessite cette fonctionnalité, contactez votre gestionnaire de compte Microsoft.
• Contrôle parental permettant aux parents de décider des privilèges à ajouter ou à retirer pour les enfants de leur famille
• Les modérateurs XBOX peuvent supprimer des privilèges pour les joueurs ou les appareils identifiés comme abusant du service

​

Gestion et vérification des privilèges et autorisations des joueurs

• Sur PC : accédez à https://aka.ms/XboxPrivSettings.
• Sur XBOX : accédez à Paramètres -> Général -> Sécurité en ligne et famille -> Confidentialité et sécurité en ligne -> Confidentialité XBOX

​

Privilèges vérifiés avec XUserCheckPrivilege

XUserPrivilege::CrossPlay

• Description : permet à un joueur de participer à une session de jeu avec d’autres joueurs réels qui ne sont pas connectés aux services XBOX, dans des scénarios tels que : gameplay joueur contre joueur synchrone dans la même session, gameplay asynchrone au tour par tour, gameplay en équipe, matchmaking initié par l’utilisateur, envoi ou acceptation d’invitations, sessions avec jonction en cours de partie.
• Exigence : XR-045 - XBOX services and Account Privileges
• ID de privilège : 185
• Paramètre sur PC : Vous pouvez jouer avec des personnes en dehors des services XBOX
• Paramètre sur XBOX : Vous pouvez rejoindre le jeu entre réseaux

XUserPrivilege::Sessions

• Description : permet à un joueur de participer à des expériences solo connectées dans des environnements partagés, ou dans des scénarios où un titre hybride, à la fois free-to-play et multijoueur payant, utilise ce privilège pour contrôler ces expériences sur les consoles XBOX. Les expériences solo ne doivent comporter aucune fonctionnalité couverte par les privilèges 252 ou 254 (respectivement Communications et Multiplayer). L’utilisation de ce privilège est une fonctionnalité de titre qui nécessite l’approbation de la plateforme.
• Exigence : XR-045 - XBOX services and Account Privileges
• ID de privilège : 189
• Paramètre sur PC : Vous pouvez rejoindre des jeux multijoueur
• Paramètre sur XBOX : Vous pouvez rejoindre des jeux multijoueur

XUserPrivilege::Multiplayer

• Description : permet à un joueur de rejoindre des sessions de jeu multijoueur en ligne avec des utilisateurs réels (et non des bots), dans des scénarios tels que : gameplay joueur contre joueur synchrone dans la même session, gameplay asynchrone au tour par tour, gameplay en équipe, matchmaking initié par l’utilisateur, envoi ou acceptation d’invitations, sessions avec jonction en cours de partie. Notez que ce privilège ne concerne pas les jeux multijoueur locaux exécutés sur le même appareil.
• Exigence : XR-045 - XBOX services and Account Privileges
• ID de privilège : 254
• Paramètre sur PC : Vous pouvez rejoindre des jeux multijoueur
• Paramètre sur XBOX : Vous pouvez rejoindre des jeux multijoueur

XUserPrivilege::UserGeneratedContent

• Description : permet à un joueur de voir l’UGC d’autres utilisateurs en ligne, de télécharger l’UGC d’autres utilisateurs ou de partager son propre UGC en ligne. Cela ne restreint pas l’utilisation de l’UGC déjà téléchargé.
• Exigence : XR-045 - XBOX services and Account Privileges
• ID de privilège : 247
• Paramètre sur PC : Vous pouvez voir et charger des créations de la communauté
• Paramètre sur XBOX : Vous pouvez voir et charger des créations de la communauté

XUserPrivilege::SocialNetworkSharing

• Description : consoles XBOX uniquement : permet à un joueur de partager des informations, notamment la progression dans le jeu, le contenu généré par Kinect, les clips de jeu, etc., en dehors du réseau XBOX.
• Exigence : XR-045 - XBOX services and Account Privileges
• ID de privilège : 220
• Paramètre sur XBOX : Vous pouvez partager en dehors de XBOX

XUserPrivilege::Communications

• Description : permet à un joueur de communiquer avec n’importe quel autre utilisateur des services XBOX par la voix ou le texte.
• Exigence : XR-045 - XBOX services and Account Privileges
• ID de privilège : 252
• Paramètre sur PC : Les autres peuvent communiquer par la voix, le texte ou des invitations
• Paramètre sur XBOX : Les autres peuvent communiquer par la voix, le texte ou des invitations

​

Autorisations vérifiées avec XblPrivacyCheckPermissionAsync

XblPermission::CommunicateUsingText

• Description : vérifie si le joueur peut envoyer un message au contenu textuel à l’utilisateur cible. Cette valeur ne change pas si le joueur a ignoré (mute) l’utilisateur cible. Utilisez plutôt CommunicateUsingVoice. Cette valeur est false si, par exemple, vous avez limité vos communications aux amis uniquement et que la cible n’est pas un ami. Cette valeur est false si, par exemple, le joueur cible vous a bloqué. Cette valeur est false si, par exemple, vous avez défini vos paramètres de communication sur Bloqué.
• Exigence : XR-015 - Managing Player Communication
  • Lors de la vérification d’un autre utilisateur des services XBOX
    • Paramètre sur PC : Les autres peuvent communiquer par la voix, le texte ou des invitations
    • Paramètre sur XBOX : Les autres peuvent communiquer par la voix, le texte ou des invitations
  • Lors de la vérification d’un utilisateur anonyme
    • Paramètre sur PC : Vous pouvez communiquer en dehors des services XBOX par la voix et le texte
    • Paramètre sur XBOX : Vous pouvez communiquer en dehors de XBOX par la voix et le texte

XblPermission::CommunicateUsingVoice

• Description : vérifie si le joueur peut communiquer par la voix avec l’utilisateur cible. Cette valeur est false si le joueur a ignoré (mute) l’utilisateur cible.
• Exigence : XR-015 - Managing Player Communication
  • Lors de la vérification d’un autre utilisateur des services XBOX
    • Paramètre sur PC : Les autres peuvent communiquer par la voix, le texte ou des invitations
    • Paramètre sur XBOX : Les autres peuvent communiquer par la voix, le texte ou des invitations
  • Lors de la vérification d’un utilisateur anonyme
    • Paramètre sur PC : Vous pouvez communiquer en dehors des services XBOX par la voix et le texte
    • Paramètre sur XBOX : Vous pouvez communiquer en dehors de XBOX par la voix et le texte

​

Test des privilèges fournis par les abonnements

​

Test des privilèges fournis par le jeu en cours d’exécution

​

Test des privilèges retirés par le contrôle parental

​

ID de privilège à vérifier

​

Logique de calcul des privilèges

​

Droits de privilège liés au type d’appareil

​

Droits de privilège effectifs liés aux abonnements

• Le joueur a acheté le produit d’abonnement.
• Un autre joueur actif sur le même appareil a acheté le produit d’abonnement.
• Le produit d’abonnement est associé à l’appareil que le joueur utilise actuellement.

​

Droits promotionnels

​

Privilèges retirés aux comptes invités parrainés

​

Sécurité en ligne et application des règles par Microsoft

​

Contrôle parental

​

Privilèges des abonnés XBOX Game Pass Essential

​

Abonnements partenaires et privilèges

​

Titres free-to-play et privilèges multijoueur

​

Titres hybrides et privilèges multijoueur

​

Voir aussi