> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration du service multijoueur

> Configurez le service Multijoueur XBOX pour votre titre, notamment les modèles de session, les hoppers SmartMatch et les chaînes d'invitation personnalisées dans la configuration du service.

Cette rubrique explique comment configurer le service Multijoueur, notamment les modèles de session, les hoppers SmartMatch et les chaînes d'invitation personnalisées. Pour que votre titre puisse tirer parti des services XBOX, vous devez d'abord définir la configuration de service du titre. Votre configuration de service réside dans le cloud des services XBOX et définit la façon dont les services XBOX interagissent avec les appareils qui exécutent votre jeu.

Vous pouvez configurer les trois aspects suivants des services Multijoueur.

* Modèles de session
* Hoppers SmartMatch
* Chaînes d'invitation personnalisées

## Modèles de session

Grâce au service Multijoueur XBOX, les joueurs peuvent créer des sessions et les rejoindre, échanger des messages de session avec d'autres joueurs de la même session et publier les résultats de leur partie dans la session. Notez que la publication des résultats nettoie la session et met à jour les classements de tous les joueurs de la session.

Par exemple, une session multijoueur peut être une partie d'échecs entre deux joueurs. Un autre exemple de session multijoueur peut être une session continue d'un titre d'action et d'aventure jouée par un grand nombre de joueurs. Lorsqu'un jeu crée une session multijoueur, il la crée à partir d'un modèle de session prédéfini. Ce modèle est essentiellement un objet JSON qui contient des attributs décrivant la session.

Lorsque vous créez un modèle de session, vous devez définir les valeurs indiquées dans le tableau suivant.

| Champ | Description |
| - | - |
| Nom de la session | Créez un nom qui caractérise le modèle de session multijoueur. Choisissez un nom facile à mémoriser et à reconnaître. Le nom doit être une chaîne de texte de 100 caractères au maximum. |
| Version du contrat | Cette valeur est renseignée automatiquement par le système et indique la version système actuelle du contrat JSON. Ne modifiez pas cette valeur. |
| Modèle de session (texte JSON) | Spécifiez les données JSON qui décrivent les différents attributs associés à une session multijoueur. |

Pour plus d'informations sur les modèles de session multijoueur, notamment plusieurs modèles prédéfinis que vous pouvez utiliser comme base pour le texte JSON, consultez [Modèles de session multijoueur](https://docs.xbox.com/fr/services/xbox-services/multiplayer/mpsd/concepts/live-session-templates.md).

> [!NOTE]
>
> Une fois qu'un titre a réussi la certification finale, vous ne pouvez plus modifier ni supprimer les sessions multijoueurs existantes de ce titre.

## Hoppers SmartMatch

Les hoppers SmartMatch sont un complément facultatif au service Multijoueur XBOX. SmartMatch est le nom du service de matchmaking côté serveur de XBOX. Il permet de regrouper des joueurs en fonction des informations suivantes.

* Fournies par le titre
* Stockées dans les statistiques des joueurs
* Issues des préférences du joueur
* Issues de la qualité de service (QoS)

Le matchmaking est désormais géré côté serveur. Les joueurs peuvent soumettre une demande au service, puis être avertis ultérieurement lorsqu'une partie est trouvée. Les joueurs ne sont donc pas obligés d'attendre dans votre titre pendant le processus de matchmaking. Ils sont libres de jouer à la partie solo de votre titre, voire de jouer à d'autres titres, tout en restant candidats au matchmaking. Cette approche élimine la nécessité d'atteindre une masse critique de joueurs avant de pouvoir trouver des parties.

> [!NOTE]
>
> Vous devez baser votre hopper de matchmaking sur un modèle de session défini au préalable.

Lorsque vous créez un hopper SmartMatch, vous devez définir les valeurs indiquées dans le tableau suivant.

| Champ | Description |
| - | - |
| Nom | Saisissez un nom qui caractérise le hopper de matchmaking. Choisissez un nom facile à mémoriser et à reconnaître. Le nom est une chaîne de texte de 140 caractères au maximum. |
| Taille minimale du groupe | Spécifiez le nombre minimal acceptable de joueurs. La valeur minimale est 1. |
| Taille maximale du groupe | Spécifiez le nombre maximal acceptable de joueurs. La valeur maximale est 256. |
| Cycles d'expansion des règles « should » | La valeur par défaut est 3, et vous ne devez pas la modifier pour des populations de joueurs classiques. |
| Hopper classé | Si un hopper est marqué comme hopper classé, les joueurs de ce hopper peuvent être mis en relation, même s'ils se sont bloqués mutuellement. Cela empêche les joueurs de bloquer d'autres joueurs ayant un niveau de compétence supérieur. |
| Mise à jour automatique à partir de la session | Lorsque ce champ est activé, les modifications apportées à la liste des membres de la session, ou aux propriétés personnalisées des membres, sont automatiquement propagées à un ticket soumis précédemment. |

> [!NOTE]
>
> Une fois qu'un titre a réussi la certification finale, vous ne pouvez plus modifier ni supprimer les hoppers de matchmaking existants de ce titre.

## Chaînes d'invitation personnalisées

Lorsque votre titre envoie à un joueur une invitation à rejoindre une partie multijoueur, vous pouvez choisir d'afficher une chaîne de texte d'invitation personnalisée au lieu de la chaîne d'invitation par défaut. Lorsque vous créez une chaîne d'invitation personnalisée, vous devez définir les valeurs du tableau suivant.

| Champ | Description |
| - | - |
| ID | Identificateur de la chaîne d'invitation personnalisée. `custominvitestrings_` est automatiquement ajouté au début de votre ID. La longueur maximale de cette chaîne est de 100 caractères. |
| Valeur | Texte de la chaîne d'invitation personnalisée qui apparaît dans votre notification d'invitation personnalisée. La longueur maximale de cette chaîne est de 100 caractères. |

## Informations supplémentaires

Pour plus d'informations sur la configuration du service Multijoueur, consultez les rubriques suivantes.

| Nom de la rubrique | Description |
| - | - |
| [Modèles de session multijoueur](https://docs.xbox.com/fr/services/xbox-services/multiplayer/mpsd/concepts/live-session-templates.md) | Présente brièvement les modèles de session multijoueur et fournit plusieurs exemples de modèles que vous pouvez copier et modifier |
| [Constantes des modèles de session](https://docs.xbox.com/fr/services/xbox-services/multiplayer/mpsd/concepts/live-session-template-constants.md) | Décrit les éléments prédéfinis d'un modèle de session multijoueur |
| [Utilisation de grandes sessions pour le Multijoueur](https://docs.xbox.com/fr/services/xbox-services/multiplayer/mpsd/concepts/live-large-sessions.md) | Explique quand et comment utiliser les grandes sessions |


## Related topics

- [Concepts multijoueurs](https://docs.xbox.com/fr/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts-nav.md)
- [Concepts](https://docs.xbox.com/fr/services/xbox-services/multiplayer/concepts/index.md)
- [Présentation de l'appel direct du service multijoueur](https://docs.xbox.com/fr/services/xbox-services/multiplayer/concepts/live-intro-calling-mp-directly.md)
- [Vue d'ensemble du multijoueur des services XBOX](https://docs.xbox.com/fr/services/xbox-services/multiplayer/overviews/live-multiplayer-intro.md)
- [Multijoueur](https://docs.xbox.com/fr/services/xbox-services/multiplayer/index.md)
