Guide de dépannage des invitations et des activités MPA

Le guide suivant constitue un point de départ pour aider les titres à résoudre les problèmes liés aux fonctionnalités d’invitation et d’activité utilisant le service MPA. Les développeurs de titres doivent d’abord s’assurer qu’aucune erreur d’appel d’API MPA ni aucune erreur HTTP ne se produit. En l’absence d’erreurs, la désactivation de l’interface utilisateur permettant de rejoindre une invitation ou une activité est le plus souvent due à une configuration incorrecte du titre ou du service. La meilleure approche de dépannage consiste ensuite à suivre ces étapes :

Vérifiez que l’activité actuelle n’a pas de JoinRestriction limitante; les valeurs Followed ou InviteOnly limitent la possibilité de rejoindre la partie.
Vérifiez que la propriété platform de l’activité ou l’indicateur d’invitation allowCrossPlatformJoin ne restreint pas le jeu multiplateforme. La définition d’une valeur platform spécifique (par exemple, XboxOne) limite à cette plateforme l’accès aux parties au moyen de l’interface utilisateur de la plateforme et les invitations. La définition de l’indicateur d’invitation allowCrossPlatformJoin sur false renseigne automatiquement le champ de plateforme avec la plateforme actuelle. L’invitation n’est alors reçue que par les joueurs de cette plateforme.
Vérifiez le sandbox et le titleID de toutes les instances du titre utilisées dans le test. Toutes les instances du titre doivent se trouver dans des sandbox identiques et utiliser le même titleID (et le même SCID), et le modèle de session MPSD doit être configuré dans ce sandbox.
Vérifiez que tous les ID du fichier MicrosoftGame.config sont correctement définis. Le fichier MicrosoftGame.config doit inclure le titleID et le SCID corrects, et les informations d’identité doivent correspondre à la configuration de Partner Center de votre titre (visible dans ‘Game Setup’).
Vérifiez la disponibilité de votre titre selon les appareils dans Partner Center. Les paramètres ‘Game Setup’/‘Device family availability’ de Partner Center peuvent restreindre les fonctionnalités et la disponibilité de votre titre. Assurez-vous que toutes les plateformes concernées sont activées. Par défaut, les appareils XBOX One prennent en charge le jeu multiplateforme si la famille d’appareils XBOX Series X|S n’est pas définie.
Vérifiez que votre titre n’est pas limité à des groupes d’audience privée. Le fait de restreindre la visibilité du titre à des audiences privées (‘Pricing and availability’/‘Visibility’ dans Partner Center) peut restreindre l’accès au titre et les fonctionnalités des services. Par exemple, si l’utilisateur connecté ne fait pas partie de l’audience privée, les informations renvoyées sur les joueurs récents n’incluront pas de nom de titre correct. Si cette option est activée, assurez-vous que les deux consoles/utilisateurs font partie du groupe d’audience privée.
Vérifiez que le paramètre MultiplayerProtocol est présent dans le fichier MicrosoftGame.config pour les titres PC. Le paramètre MultiplayerProtocol doit être défini sur true pour que les titres Windows bénéficient d’une intégration correcte à l’interface utilisateur de la XBOX Game Bar. Pour plus de détails, consultez Vue d’ensemble de MicrosoftGame.config.
Vérifiez que vous ne mélangez pas accidentellement des appels aux services MPA et MPSD. Les services MPSD et MPA ne peuvent pas être utilisés simultanément. Cela entraînerait un comportement inattendu des activités, de l’accès aux parties et des invitations. Les titres doivent choisir un seul service.
L’interface utilisateur de la plateforme ne désactive pas les activités complètes (currentPlayers égal à maxPlayers). Cela vise principalement à éviter les conditions de concurrence, mais aussi parce que currentPlayers est un champ facultatif. Si vous souhaitez limiter la possibilité de rejoindre une partie complète, vous devez supprimer l’activité ou gérer le cas d’erreur lorsqu’un joueur rejoint une partie complète. Un message d’erreur est recommandé, car ce cas doit déjà être géré par le jeu.

XBOX Services

PlayFab

Guide de dépannage des invitations et des activités MPA