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

# XR-074 Perte de connectivité aux services XBOX et des partenaires

> XR-074 Perte de connectivité aux services XBOX et des partenaires

Version 2.0, 11/1/2025

Les titres doivent gérer adéquatement les erreurs de connectivité aux services XBOX et des partenaires. Les titres doivent respecter les politiques de nouvelle tentative définies par XBOX lorsqu'ils tentent de relancer une requête au service XBOX après une défaillance. Les titres doivent informer l'utilisateur de façon appropriée lorsque des services ne sont pas disponibles. Si un service d'un partenaire n'est pas disponible, le jeu ne doit pas indiquer qu'il y a un problème avec le réseau XBOX. Les titres ne doivent pas planter ni se bloquer si les services réseau sont ralentis ou disponibles de façon intermittente.

## Plus d'information

Les titres devraient réagir au rendement de leurs propres opérations réseau ou utiliser les API de qualité réseau **Windows.XBOX.Networking** pour déterminer les conditions réseau actuelles. Ils devraient également se dégrader adéquatement en transférant moins de données, en choisissant des rôles d'utilisateur appropriés ou en tirant parti des services infonuagiques.

### Gestion des problèmes avec les services autres que XBOX

Les titres qui rencontrent des problèmes avec les services des partenaires, comme des délais d'expiration non transitoires, des erreurs d'API réseau ou une configuration de service manquante qui ont une incidence sur l'expérience utilisateur, devraient avertir l'utilisateur de la fonctionnalité ou du service précis qui n'est pas disponible. Les titres devraient revenir adéquatement à un état sécuritaire 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 autre que Microsoft* n'est pas disponible actuellement. Veuillez réessayer plus tard. Pour plus d'information, communiquez avec *coordonnées du soutien autre que Microsoft*. »

### Gestion des problèmes avec les services XBOX

Certaines fonctionnalités peuvent devenir indisponibles si la connectivité à un service XBOX est perdue. Dans de tels cas, les titres devraient utiliser des messages clairs et conviviaux pour en informer les utilisateurs.

Si un service n'est pas disponible, les titres peuvent relancer leur requête, mais uniquement dans les limites des paramètres autorisés par XBOX. Pour plus d'information sur la résilience des services pour les titres sur console XBOX, y compris la logique requise de nouvelle tentative HTTP et d'attente exponentielle, ainsi que les conseils d'interaction avec l'utilisateur pour chacun des services, consultez [Résilience aux interruptions de service pour les titres](/fr-CA/services/xbox-services/develop/best-practices/live-best-practices-calling-xbl)

### Exigence de connectivité XBOX

Lors du développement pour les consoles XBOX, les titres qui ont besoin d'une connectivité à Internet (ou à XBOX en particulier) pour la majorité de leurs fonctionnalités pourraient 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 suspend, puis ferme le titre si la connectivité est perdue.

Pour obtenir de l'information sur la mise en réseau à l'aide du GDK, consultez la [section Mise en réseau](/fr-CA/build/console-features/networking/gc-networking-toc).

## Cas de test de certification

### 074-01 Déconnexion WAN des services XBOX

**Étapes du 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 ou un concentrateur Ethernet, débranchez le câble de liaison montante de l'appareil réseau. Si l'appareil est connecté par 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 jonction à celle-ci
   * Tentative de création d'une session en ligne
   * Affichage d'un classement (le cas échéant)
   * Jeu hors ligne

**Résultat attendu**<br />Si la console ne parvient pas à joindre les services XBOX, le titre devrait répondre par un message d'erreur convivial.

**Exemples de réussite**

1. Le titre affiche un message d'erreur indiquant la perte de 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 fermé lorsque la connectivité est perdue.

**Exemples d'échec**

1. L'utilisateur ne parvient pas à terminer une session de jeu XBOX hors ligne.
2. Le titre passe à un état qui ne répond pas ou instable.

### 074-02 Déconnexion directe

**Étapes du 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 jonction à celle-ci.
   * Tentative de création d'une session en ligne.
   * Affichage d'un classement (le cas échéant).
   * Jeu hors ligne.

**Résultat attendu**<br />Si l'appareil perd la connexion aux services XBOX, le titre devrait 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 ligne.
3. Un titre dont le manifeste AppX contient `RequireXboxLive` est suspendu, puis fermé lorsque la connectivité est perdue.

**Exemples d'échec**

1. Un message d'erreur s'affiche en mode de jeu hors ligne.
2. Le titre passe à 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 que le réseau est hors ligne.

### 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 réglé sur Démarrage instantané.
* Lorsque le jeu reste hors focus pendant dix minutes. Par exemple, en lançant une application comme Paramètres et en la gardant au premier plan pendant dix minutes.

Aux fins de ce cas de test, les deux méthodes doivent être vérifiées à l'étape 3.

**Étapes du test**

1. Connectez-vous à un profil XBOX avec le mode d'alimentation de la console réglé sur Démarrage instantané.
2. Lancez le jeu et progressez jusqu'au jeu.
3. À divers moments du jeu, suspendez le jeu.
4. Reprenez le jeu et vérifiez que le jeu gère adéquatement la déconnexion.
5. Répétez les étapes 3 et 4 tout au long du jeu.

**Résultat attendu**<br />Si la console ne parvient pas à joindre les services XBOX après avoir été suspendue, le titre doit reprendre correctement, gérer adéquatement la situation et répondre par un message d'erreur convivial, s'il y a lieu.

**Exemples de réussite**

1. Pendant une session multijoueur XBOX en ligne, le titre affiche un message d'erreur indiquant la perte de 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 hors ligne.
2. Le titre passe à 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 réglé sur Démarrage instantané.
* Lorsque le jeu reste hors focus pendant dix minutes. Par exemple, en lançant une application comme Paramètres et en la gardant au premier plan pendant dix minutes.

Aux fins de ce cas de test, les deux méthodes doivent être vérifiées à l'étape 3.

**Étapes du test**

1. Connectez-vous à un profil XBOX avec le mode d'alimentation de la console réglé sur Démarrage instantané et assurez-vous que la console est à l'Accueil.
2. Sans connexion à XBOX, mais en conservant une connexion réseau locale, lancez le titre.
   * Si vous utilisez un commutateur ou un concentrateur Ethernet, débranchez le câble de liaison montante de l'appareil réseau.
   * Si l'appareil est connecté par Wi-Fi, débranchez le câble de liaison montante du point d'accès sans fil.
3. À divers 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 adéquatement la reconnexion.
6. Répétez les étapes 2 à 5 tout au long du jeu.

**Résultat attendu**<br />Si la console ne parvient pas à joindre les services XBOX après avoir été suspendue, le titre doit reprendre correctement, gérer adéquatement la situation et répondre par un message d'erreur convivial, s'il y a lieu.

**Exemples de réussite**

1. L'utilisateur peut reprendre le titre et terminer une session de jeu XBOX hors ligne 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 hors ligne.
2. Le titre passe à 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 :**

* [Documentation de XBOX Multiplayer Analysis Tool (XMAT)](https://github.com/microsoft/xbox-multiplayer-analysis-tool/blob/main/README.md) et la [plus récente version de XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/releases).

**Configurer XMAT pour bloquer les services des partenaires**

Pour obtenir 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](/fr-CA/tools/tools-services/live-xbox-multiplayer-analysis-tool).

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.
   * Sur Windows, sélectionnez **Start Capture**.
2. Pendant que XMAT effectue la capture, 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 joignez 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 repérer les hôtes de services des partenaires contactés pendant le jeu normal. Confirmez que les hôtes sélectionnés n'appartiennent pas à Microsoft, à XBOX ni à 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 d'un partenaire.
5. Activez le script et vérifiez qu'il se compile correctement. Désactivez ensuite le script afin que les services des partenaires restent disponibles au début du test. Laissez la capture XMAT en cours d'exécution.

**Étapes du 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 confirmez que la fonctionnalité est disponible.
3. Sans fermer le titre, activez le script de blocage XMAT.
4. Continuez dans le titre et testez toutes les zones applicables, notamment :
   * Menus
   * Classements
   * Serveurs (créez-en un et joignez celui de quelqu'un d'autre)
   * Liste d'amis
   * Boutique dans le titre
   * É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**<br />Le titre gère adéquatement les déconnexions des services autres que Microsoft.

**Exemples de réussite**

1. Le titre ne se bloque pas et ne plante pas lors de la perte de connectivité aux services hébergés par des partenaires.

**Exemples d'échec**

1. Le message affiché laisse entendre des problèmes 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 :**

* *xbstress.exe* du GDK/XDK
* [XBOX Multiplayer Analysis Tool (XMAT)](/fr-CA/tools/tools-services/live-xbox-multiplayer-analysis-tool) pour Windows.

**Étapes du test**

1. Sur les consoles, créez un canal réseau défaillant avec *xbstress.exe* pour le trafic autre que Microsoft à l'aide de la commande :

`xbstress set channel=0 network=broken addresses=[semicolon delimited list of addresses]`

2. Démarrez la simulation réseau avec la commande : `xbstress simulate network=channels`.
3. Si vous effectuez le test sur Windows, configurez une capture de proxy Web XMAT et activez un script qui bloque les hôtes de services des partenaires applicables avant de lancer le titre.
4. Connectez-vous à un profil XBOX.
5. Lancez le titre.
6. Accédez à une fonctionnalité en ligne autre que Microsoft.

**Résultat attendu**<br />Les titres devraient afficher un message d'erreur convivial indiquant qu'il y a un problème pour joindre le service autre que Microsoft et devraient offrir la possibilité de réessayer la connexion.

**Exemples de réussite**

1. Le titre ne se bloque pas et ne plante pas lors de la perte de connectivité au service hébergé par un partenaire.

**Exemples d'échec**

1. L'erreur affichée laisse entendre des problèmes 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.


## Related topics

- [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)
- [Contenu complémentaire sur les exigences et politiques XBOX](/fr-CA/publishing/certification/xr/overview.md)
- [Historique des modifications des exigences XBOX et des cas de test](/fr-CA/publishing/certification/xr-change-history.md)
- [XR-045 Réseau XBOX et privilèges de compte](/fr-CA/publishing/certification/xr/xr-045.md)
