Matchmaking multijoueur avec SmartMatch et MPM

Cette rubrique décrit les étapes de base nécessaires pour implémenter le matchmaking SmartMatch à l’aide de Multiplayer Manager. Un joueur peut ne pas avoir suffisamment d’amis en ligne lorsqu’il souhaite jouer, ou simplement vouloir affronter des joueurs aléatoires en ligne. Vous pouvez utiliser le service SmartMatch pour trouver d’autres joueurs XBOX.

Trouver un match

Les étapes suivantes utilisent Multiplayer Manager pour envoyer une invitation à un ami d’un joueur afin que cet ami puisse rejoindre la partie en cours.

Initialiser Multiplayer Manager
Créer la session de salon en ajoutant des utilisateurs locaux
Envoyer des invitations à des amis (facultatif)
Accepter des invitations (facultatif)
Trouver un match

Les étapes 1, 2, 3 et 5 sont effectuées sur l’appareil qui envoie l’invitation. L’étape 4 est généralement déclenchée sur l’appareil de l’invité, après le lancement de l’application par activation de protocole. Pour plus d’informations, consultez Jouer à une partie à l’aide du matchmaking SmartMatch (organigramme).

Initialiser Multiplayer Manager

L’objet de session de salon est créé automatiquement lorsque Multiplayer Manager est initialisé avec un nom de modèle de session valide. Les modèles de session sont définis dans la configuration du service.

L’instance de session de salon n’est créée sur le service qu’une fois qu’un utilisateur a été ajouté.

API C plat

HRESULT hr = XblMultiplayerManagerInitialize(lobbySessionTemplateName, queueUsedByMultiplayerManager);

Pour plus d’informations, consultez XblMultiplayerManagerInitialize. Revenir au début de cette rubrique.

Créer la session de salon en ajoutant des utilisateurs locaux

Ajoutez à la session de salon les utilisateurs des services XBOX connectés localement. Un nouveau salon est hébergé lorsque le premier utilisateur est ajouté. Tous les autres utilisateurs sont ajoutés au salon existant en tant qu’utilisateurs secondaires. Multiplayer Manager publie le salon dans l’interpréteur de commandes pour que des amis puissent le rejoindre. Vous ne pouvez envoyer des invitations, définir des propriétés de salon et accéder aux membres du salon qu’après avoir ajouté l’utilisateur local. Lorsqu’un utilisateur local rejoint le salon, nous vous recommandons de définir son adresse de connexion et ses propriétés personnalisées. Vous devez répéter ce processus pour tous les utilisateurs connectés localement.

Ajouter un seul utilisateur local

API C plat

HRESULT hr = XblMultiplayerManagerLobbySessionAddLocalUser(xblUserHandle);

if (!SUCCEEDED(hr))
{
    // Handle failure.
}

// Set member connection address.
const char* connectionAddress = "1.1.1.1";
hr = XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress(
    xblUserHandle, connectionAddress, context);

if (!SUCCEEDED(hr))
{
    // Handle failure.
}

// Set custom member properties.
const char* propName = "Name";
const char* propValueJson = "{}";
hr = XblMultiplayerManagerLobbySessionSetProperties(propName, propValueJson, context);

if (!SUCCEEDED(hr))
{
    // Handle failure.
}
...

Pour plus d’informations, consultez les rubriques suivantes :

Revenir au début de cette rubrique.

Ajouter plusieurs utilisateurs locaux

API C plat

std::vector<XblUserHandle> xblUsers;
for (XblUserHandle xblUserHandle : xblUsers)
{
    HRESULT hr = XblMultiplayerManagerLobbySessionAddLocalUser(xblUserHandle);

    if (!SUCCEEDED(hr))
    {
        // Handle failure.
    }

    // Set member connection address.
    const char* connectionAddress = "1.1.1.1";
    hr = XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress(
        xblUserHandle, connectionAddress, context);

    if (!SUCCEEDED(hr))
    {
        // Handle failure.
    }

    // Set custom member properties.
    const char* propName = "Name";
    const char* propValueJson = "{}";
    hr = XblMultiplayerManagerLobbySessionSetProperties(propName, propValueJson, context);
    ...
}

Pour plus d’informations, consultez les rubriques suivantes :

Les modifications sont regroupées lors de l’appel suivant à XblMultiplayerManagerDoWork. Multiplayer Manager déclenche un événement XblMultiplayerEventType::UserAdded chaque fois qu’un utilisateur local est ajouté à la session de salon. Nous vous recommandons de vérifier le code d’erreur de l’événement pour savoir si l’utilisateur a bien été ajouté. En cas d’échec, un message d’erreur fournit des détails sur les raisons de l’échec. Multiplayer Manager effectue les opérations suivantes pour créer la session de salon en ajoutant des utilisateurs locaux.

Inscription aux abonnements Real-Time Activity et multijoueurs auprès du service multijoueur des services XBOX.
Création de la session de salon.
Intégration de tous les joueurs locaux en tant que joueurs actifs.
Chargement de l’adresse d’appareil sécurisée (SDA).
Définition des propriétés des membres.
Inscription aux événements de modification de session.
Définition de la session de salon comme session active.

Revenir au début de cette rubrique.

Envoyer des invitations à des amis (facultatif)

Affichez l’interface utilisateur XBOX standard dans laquelle le joueur peut sélectionner des amis ou des joueurs récents à inviter dans la partie. Lorsque le joueur confirme sa sélection, Multiplayer Manager envoie les invitations aux joueurs sélectionnés. Les jeux peuvent également utiliser la méthode XblMultiplayerManagerLobbySessionInviteUsers pour envoyer des invitations à un ensemble de joueurs définis par leur ID d’utilisateur des services XBOX. Cette méthode est utile si vous utilisez votre propre interface utilisateur dans le jeu plutôt que l’interface utilisateur XBOX standard.

API C plat

size_t xuidsCount = 1;
uint64_t xuids[1] = {};
xuids[0] = 1234567891234567;
HRESULT hr = XblMultiplayerManagerLobbySessionInviteUsers(
    xblUserHandle, 
    xuids, 
    xuidsCount, 
    nullptr,    // ContextStringId 
    nullptr     // CustomActivationContext
);

Pour plus d’informations, consultez XblMultiplayerManagerLobbySessionInviteUsers. Multiplayer Manager effectue les opérations suivantes pour envoyer des invitations à des amis.

Affichage de la title-callable UI (TCUI) standard XBOX
Envoi d’une invitation directement aux joueurs sélectionnés

Revenir au début de cette rubrique.

Accepter des invitations (facultatif)

Lorsqu’un joueur invité accepte une invitation de jeu ou rejoint la partie d’un ami via une interface utilisateur de l’interpréteur de commandes, le jeu est lancé sur son appareil au moyen de l’activation de protocole. Une fois le jeu démarré, Multiplayer Manager peut utiliser les arguments de l’événement d’activation de protocole pour rejoindre le salon. Si l’utilisateur invité n’est pas ajouté via XblMultiplayerManagerLobbySessionAddLocalUser, XblMultiplayerManagerJoinLobby échoue et fournit le xuid auquel l’invitation a été envoyée lorsque vous appelez XblMultiplayerEventArgsXuid avec l’événement JoinLobbyCompleted. Après avoir rejoint le salon, nous vous recommandons de définir l’adresse de connexion du membre local ainsi que les propriétés personnalisées du membre. Vous pouvez également définir l’hôte via XblMultiplayerManagerLobbySessionSetSynchronizedHost s’il n’en existe pas. Enfin, Multiplayer Manager intègre automatiquement l’utilisateur à la session de jeu si une partie est déjà en cours et qu’il reste de la place pour l’invité. Le titre en est informé par l’événement JoinGameCompleted, qui fournit un code d’erreur et un message appropriés. Les résultats d’erreur ou de réussite sont gérés via l’événement JoinLobbyCompleted.

API C plat

HRESULT hr = XblMultiplayerManagerJoinLobby(inviteHandleId, xblUserHandle);
if (!SUCCEEDED(hr))
{
    // Handle failure.
}

// Set member connection address.
const char* connectionAddress = "1.1.1.1";
hr = XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress(
    xblUserHandle, connectionAddress, context);

Pour plus d’informations, consultez les rubriques suivantes :

Multiplayer Manager effectue les opérations suivantes pour accepter des invitations.

Inscription aux abonnements Real-Time Activity et multijoueurs.
Accès à la session de salon.
Nettoyage de l’état du salon existant.
Intégration de tous les joueurs locaux en tant que joueurs actifs.
Chargement de la SDA.
Définition des propriétés des membres.
Inscription aux événements de modification de session.
Définition de la session de salon comme session active.
Accès à la session de jeu (si elle existe).
Utilisation d’un handle de transfert.

Trouver un match

Une fois les invitations acceptées et l’hôte prêt à commencer la partie, vous pouvez utiliser SmartMatch pour effectuer l’une des opérations suivantes :

Trouver une partie existante disposant de suffisamment de places libres pour tous les membres de la session de salon, en appelant XblMultiplayerManagerFindMatch.
Créer une session de jeu incluant tous les membres de la session de salon et remplir les places libres avec d’autres joueurs qui recherchent un match du même type de jeu, en appelant XblMultiplayerManagerJoinGameFromLobby puis XblMultiplayerManagerAutoFillMembersDuringMatchmaking.

Avant de pouvoir appeler XblMultiplayerManagerFindMatch, vous devez d’abord configurer des hoppers dans la configuration de votre service. Un hopper définit les règles que SmartMatch utilise pour mettre en relation les joueurs.

API C plat

uint32_t timeoutInSeconds = 30;
HRESULT hr = XblMultiplayerManagerFindMatch(hopperName, attributesJson, timeoutInSeconds);
if (!SUCCEEDED(hr))
{
    // Handle failure.
}

Pour plus d’informations, consultez XblMultiplayerManagerFindMatch. Multiplayer Manager effectue les opérations suivantes pour trouver un match.

Création d’un ticket de match.
Gestion de toutes les étapes de qualité de service (QoS).
Gestion des modifications de la liste des joueurs.
Nouvelle soumission (si nécessaire).
Accès à la session de jeu cible.
Publication de la partie via la session de salon.

Revenir au début de cette rubrique.

XBOX Services

PlayFab

Trouver un match

Initialiser Multiplayer Manager

API C plat

Créer la session de salon en ajoutant des utilisateurs locaux

Ajouter un seul utilisateur local

API C plat

Ajouter plusieurs utilisateurs locaux

API C plat

Envoyer des invitations à des amis (facultatif)

API C plat

Accepter des invitations (facultatif)

API C plat

Trouver un match

API C plat

​Trouver un match

​Initialiser Multiplayer Manager

​API C plat

​Créer la session de salon en ajoutant des utilisateurs locaux

​Ajouter un seul utilisateur local

​API C plat

​Ajouter plusieurs utilisateurs locaux

​API C plat

​Envoyer des invitations à des amis (facultatif)

​API C plat

​Accepter des invitations (facultatif)

​API C plat

​Trouver un match

​API C plat

Trouver un match

Initialiser Multiplayer Manager

API C plat

Créer la session de salon en ajoutant des utilisateurs locaux

Ajouter un seul utilisateur local

API C plat

Ajouter plusieurs utilisateurs locaux

API C plat

Envoyer des invitations à des amis (facultatif)

API C plat

Accepter des invitations (facultatif)

API C plat

Trouver un match

API C plat