Skip to main content
Version 2.0, 11/1/2025 Les titres doivent gérer correctement les erreurs de connectivité aux services XBOX et partenaires. Les titres doivent respecter les stratégies de nouvelle tentative définies par XBOX lorsqu’ils tentent de renvoyer une requête au service XBOX après un échec. Les titres doivent informer l’utilisateur de manière appropriée lorsque des services ne sont pas disponibles. Si un service partenaire n’est pas disponible, le jeu ne doit pas indiquer qu’il existe un problème avec le réseau XBOX. Les titres ne doivent pas se bloquer ni planter si les services réseau sont ralentis ou disponibles de façon intermittente.

​
Plus d’informations

Les titres doivent réagir aux performances de leurs propres opérations réseau et/ou utiliser les API de qualité réseau Windows.XBOX.Networking pour déterminer les conditions réseau actuelles. Ils doivent également se dégrader correctement en transférant moins de données, en choisissant des rôles d’utilisateur appropriés ou en tirant parti des services cloud.

​
Gestion des problèmes liés aux services autres que XBOX

Les titres qui rencontrent des problèmes avec des services partenaires, tels que des délais d’expiration non transitoires, des erreurs d’API réseau ou une configuration de service manquante ayant un impact sur l’expérience utilisateur, doivent signaler à l’utilisateur la fonctionnalité ou le service spécifique qui n’est pas disponible. Les titres doivent échouer correctement en revenant à un état sûr pendant que l’utilisateur résout le problème, ou à un état dans lequel l’utilisateur peut réessayer manuellement. Voici un exemple de message convivial :
« Désolé, service non-Microsoft n’est pas disponible actuellement. Veuillez réessayer plus tard. Pour plus d’informations, contactez coordonnées du support non-Microsoft. »

​
Gestion des problèmes liés aux services XBOX

Certaines fonctionnalités peuvent devenir indisponibles en cas de perte de connectivité à un service XBOX. Dans ce cas, les titres doivent utiliser des messages clairs et conviviaux pour en informer les utilisateurs. Si un service n’est pas disponible, les titres sont autorisés à renvoyer leur requête, mais uniquement dans les limites des paramètres autorisés par XBOX. Pour plus d’informations sur la résilience des services pour les titres de console XBOX, notamment la logique obligatoire de nouvelle tentative HTTP et d’interruption progressive (back-off), ainsi que les recommandations relatives à l’interaction utilisateur pour chaque service, consultez Résilience des titres face aux interruptions de service

​
Exiger la connectivité XBOX

Lors du développement pour les consoles XBOX, les titres qui nécessitent une connexion à Internet (ou à XBOX en particulier) pour la majorité de leurs fonctionnalités peuvent inclure l’indicateur booléen RequireXboxLive dans leur manifeste AppX. Cela empêche le titre de démarrer sur la console XBOX lorsque XBOX n’est pas disponible, et le titre est suspendu, puis arrêté, en cas de perte de connectivité. Pour plus d’informations sur la mise en réseau avec le GDK, consultez la section Mise en réseau.

​
Cas de test de certification

​
074-01 Déconnexion WAN des services XBOX

Étapes de test
  1. Connectez-vous à un profil XBOX.
  2. Pendant que vous effectuez les actions suivantes, déconnectez le réseau WAN. Si vous utilisez un commutateur/concentrateur Ethernet, débranchez le câble de liaison montante de l’appareil réseau. Si l’appareil est connecté en Wi-Fi, débranchez le câble de liaison montante de la connexion du point d’accès sans fil :
    • Création d’un nouveau point de sauvegarde
    • Chargement d’un point de sauvegarde
    • Atteinte d’un point de sauvegarde automatique
    • Énumération d’une liste de parties sauvegardées
    • Recherche d’une session en ligne et connexion à celle-ci
    • Tentative de création d’une session en ligne
    • Affichage d’un classement (le cas échéant)
    • Jeu hors connexion
Résultat attendu
Si la console ne parvient pas à atteindre les services XBOX, le titre doit répondre par un message d’erreur convivial. Exemples de réussite
  1. Le titre affiche un message d’erreur indiquant la perte de la connexion réseau aux services XBOX.
  2. Le titre n’affiche pas de message d’erreur pendant une partie dans un mode de jeu local qui ne nécessite pas les services XBOX.
  3. Un titre dont le manifeste AppX contient RequireXboxLive est suspendu, puis arrêté en cas de perte de connectivité.
Exemples d’échec
  1. L’utilisateur ne parvient pas à terminer une session de jeu XBOX non en ligne.
  2. Le titre passe dans un état qui ne répond pas ou instable.

​
074-02 Déconnexion directe

Étapes de test
  1. Lancez le titre et connectez-vous à un profil XBOX.
  2. Pendant que vous effectuez les actions suivantes dans le titre, débranchez le câble réseau de l’appareil, ou éteignez le point d’accès sans fil ou le routeur sans fil :
    • Création d’un nouveau point de sauvegarde.
    • Chargement d’un point de sauvegarde.
    • Atteinte d’un point de sauvegarde automatique.
    • Énumération d’une liste de parties sauvegardées.
    • Recherche d’une session en ligne et connexion à celle-ci.
    • Tentative de création d’une session en ligne.
    • Affichage d’un classement (le cas échéant).
    • Jeu hors connexion.
Résultat attendu
Si l’appareil perd la connexion aux services XBOX, le titre doit répondre par un message d’erreur convivial. Exemples de réussite
  1. Le titre affiche un message convivial en mode de jeu en ligne.
  2. Le titre n’interrompt pas le jeu en mode de jeu hors connexion.
  3. Un titre dont le manifeste AppX contient RequireXboxLive est suspendu, puis arrêté en cas de perte de connectivité.
Exemples d’échec
  1. Un message d’erreur s’affiche en mode de jeu hors connexion.
  2. Le titre passe dans un état qui ne répond pas ou instable.
  3. L’utilisateur peut afficher des menus en ligne ou des médias mis en mémoire tampon après la mise hors connexion du réseau.

​
074-03 Déconnexion des services XBOX pendant la suspension

Sur les consoles commerciales, un jeu est suspendu dans les conditions suivantes :
  • Lorsque la console passe en veille connectée après avoir été éteinte avec le mode d’alimentation défini sur Démarrage instantané.
  • Lorsque le jeu reste hors du focus pendant dix minutes. Par exemple, en lançant une application telle que Paramètres et en la gardant au premier plan pendant dix minutes.
Pour les besoins de ce cas de test, les deux méthodes doivent être vérifiées à l’étape 3. Étapes de test
  1. Connectez-vous à un profil XBOX avec le mode d’alimentation de la console défini sur Démarrage instantané.
  2. Lancez le jeu et progressez dans le gameplay.
  3. À différents moments du jeu, suspendez le jeu.
  4. Reprenez le jeu et vérifiez que le jeu gère correctement la déconnexion.
  5. Répétez les étapes 3 et 4 tout au long du jeu.
Résultat attendu
Si la console ne parvient pas à atteindre les services XBOX après avoir été suspendue, le titre doit reprendre correctement, gérer la situation de manière appropriée et répondre par un message d’erreur convivial le cas échéant. Exemples de réussite
  1. Pendant une session multijoueur XBOX en ligne, le titre affiche un message d’erreur indiquant la perte de la connexion réseau aux services XBOX.
  2. Le titre n’affiche pas de message d’erreur pendant une partie dans un mode de jeu local qui ne nécessite pas les services XBOX.
Exemples d’échec
  1. L’utilisateur ne parvient pas à terminer une session de jeu XBOX non en ligne.
  2. Le titre passe dans un état qui ne répond pas ou instable.
  3. Le titre affiche un message d’erreur trompeur ou incorrect après la reprise.

​
074-04 Reconnexion aux services XBOX pendant la suspension

Sur les consoles commerciales, un jeu est suspendu dans les conditions suivantes :
  • Lorsque la console passe en veille connectée après avoir été éteinte avec le mode d’alimentation défini sur Démarrage instantané.
  • Lorsque le jeu reste hors du focus pendant dix minutes. Par exemple, en lançant une application telle que Paramètres et en la gardant au premier plan pendant dix minutes.
Pour les besoins de ce cas de test, les deux méthodes doivent être vérifiées à l’étape 3. Étapes de test
  1. Connectez-vous à un profil XBOX avec le mode d’alimentation de la console défini sur Démarrage instantané et assurez-vous que la console est sur l’accueil.
  2. Sans connexion à XBOX mais en conservant une connexion au réseau local, lancez le titre.
    • Si vous utilisez un commutateur/concentrateur Ethernet, débranchez le câble de liaison montante de l’appareil réseau.
    • Si l’appareil est connecté en Wi-Fi, débranchez le câble de liaison montante du point d’accès sans fil.
  3. À différents moments du jeu, suspendez le jeu.
  4. Rebranchez le câble de liaison montante et attendez que la console se reconnecte aux services XBOX.
  5. Reprenez le jeu et vérifiez que le jeu gère correctement la reconnexion.
  6. Répétez les étapes 2 à 5 tout au long du jeu.
Résultat attendu
Si la console ne parvient pas à atteindre les services XBOX après avoir été suspendue, le titre doit reprendre correctement, gérer la situation de manière appropriée et répondre par un message d’erreur convivial le cas échéant. Exemples de réussite
  1. L’utilisateur peut reprendre le titre et terminer une session de jeu XBOX hors connexion sans interruption.
  2. Le titre reste stable et ne plante pas.
Exemples d’échec
  1. L’utilisateur ne parvient pas à terminer une session de jeu XBOX non en ligne.
  2. Le titre passe dans un état qui ne répond pas ou instable.
  3. Le titre affiche un message d’erreur trompeur ou incorrect après la reprise.

​
074-07 Perte dynamique de connectivité

Outils nécessaires : Configurer XMAT pour bloquer les services partenaires Pour les instructions d’installation, de configuration de la capture et de création de scripts, consultez Utiliser XBOX Multiplayer Analysis Tool pour inspecter et modifier le trafic réseau.
  1. Démarrez XMAT en tant qu’administrateur et ajoutez une capture Web Proxy pour l’appareil testé.
    • Sur une console de développement XBOX, sélectionnez Enable XBOX Proxy et attendez que la console redémarre.
    • Sous Windows, sélectionnez Start Capture.
  2. Pendant la capture XMAT, lancez le titre et parcourez tous les menus, terminez une session multijoueur, chargez chaque mode de jeu et parcourez toutes les zones du titre, notamment :
    • Les menus.
    • Les classements.
    • Les serveurs (créez-en un et rejoignez celui de quelqu’un d’autre).
    • Les listes d’amis.
    • Les boutiques dans le titre.
    • Les événements à durée limitée.
  3. Utilisez le filtre Host pour identifier les hôtes de services partenaires contactés pendant le jeu normal. Vérifiez que les hôtes sélectionnés n’appartiennent pas à Microsoft, XBOX ou PlayFab avant de les bloquer.
  4. Ouvrez le Script Editor, sélectionnez l’événement SSL Connection Request et créez un script qui définit Params.Continue sur false pour chaque hôte de service partenaire.
  5. Activez le script et vérifiez qu’il se compile correctement. Désactivez ensuite le script afin que les services partenaires restent disponibles au début du test. Laissez la capture XMAT en cours d’exécution.
Étapes de test
  1. Avec le script de blocage XMAT désactivé, connectez-vous à un profil XBOX et lancez le titre.
  2. Accédez à une fonctionnalité du titre qui utilise un service hébergé par un partenaire et vérifiez que la fonctionnalité est disponible.
  3. Sans fermer le titre, activez le script de blocage XMAT.
  4. Continuez à parcourir le titre et testez toutes les zones applicables, notamment :
    • Les menus
    • Les classements
    • Les serveurs (créez-en un et rejoignez celui de quelqu’un d’autre)
    • La liste d’amis
    • La boutique dans le titre
    • Les événements à durée limitée
  5. Vérifiez que le titre n’affiche pas de message d’erreur indiquant un problème avec le réseau XBOX.
Résultat attendu
Le titre gère correctement les déconnexions des services non-Microsoft. Exemples de réussite
  1. Le titre ne se bloque pas et ne plante pas en cas de perte de connectivité aux services hébergés par des partenaires.
Exemples d’échec
  1. Le message affiché laisse entendre un problème avec les services Microsoft.
  2. Un message d’erreur non descriptif s’affiche.
  3. Le titre plante, devient instable ou provoque le redémarrage de la console.

​
074-08 Indisponibilité avant le lancement

Outils nécessaires : Étapes de test
  1. Sur les consoles, créez un canal réseau défaillant avec xbstress.exe pour le trafic non-Microsoft à l’aide de la commande :
xbstress set channel=0 network=broken addresses=[semicolon delimited list of addresses]
  1. Démarrez la simulation réseau avec la commande : xbstress simulate network=channels.
  2. Si vous effectuez le test sous Windows, configurez une capture de proxy web XMAT et activez un script qui bloque les hôtes de services partenaires applicables avant de lancer le titre.
  3. Connectez-vous à un profil XBOX.
  4. Lancez le titre.
  5. Accédez à une fonctionnalité en ligne non-Microsoft.
Résultat attendu
Les titres doivent fournir un message d’erreur convivial indiquant qu’il existe un problème pour atteindre le service non-Microsoft et doivent permettre de retenter la connexion. Exemples de réussite
  1. Le titre ne se bloque pas et ne plante pas en cas de perte de connectivité au service hébergé par un partenaire.
Exemples d’échec
  1. L’erreur affichée laisse entendre un problème avec le service Microsoft.
  2. Un message d’erreur non descriptif s’affiche.
  3. Le titre plante, devient instable ou provoque le redémarrage de la console.
Dernière modification le 8 octobre 2026