Jouer en multijoueur avec des amis à l'aide de Multiplayer Manager

Dans un scénario multijoueur simple, un joueur de votre jeu peut y jouer en ligne avec des amis. Cette rubrique décrit les étapes de base que vous devez implémenter pour prendre en charge ce scénario à l’aide de Multiplayer Manager.

Étapes pour envoyer et accepter une invitation

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

Initialiser Multiplayer Manager
Créer la session de salon en ajoutant des utilisateurs locaux
Envoyer des invitations à des amis
Accepter des invitations
Rejoindre une session de jeu depuis le salon

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 avec des amis (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 via lobby() 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. Revenir au début de cette rubrique.

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

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 personnes définies 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

Lorsqu’un joueur invité accepte une invitation de jeu ou rejoint la partie d’un ami au moyen d’une interface utilisateur de l’interpréteur de commandes, le jeu est lancé sur son appareil. Pour les jeux basés sur le Microsoft Game Development Kit (GDK), une fois le jeu démarré, écoutez les événements d’invitation en appelant XGameActivationRegisterForEvent. Pour les jeux basés sur le XBOX One Software Development Kit et la plateforme Windows universelle (UWP), 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é au moyen de 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 au moyen de 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 au moyen de l’événement JoinLobbyCompleted.

API C plat

void CALLBACK MyXGameInviteEventCallback(
    _In_opt_ void* context,
    _In_ const XGameActivationInfo* activationInfo)
{
    UNREFERENCED_PARAMETER(context);
    if (activationInfo->type == XGameActivationType::AcceptedGameInvite)
    {
        if (activationInfo->inviteUri != nullptr)
        {
            std::string inviteString(activationInfo->inviteUri);
            auto pos = inviteString.find("handle=");
            auto inviteHandleId = inviteString.substr(pos + 7, 36);

            // Now use inviteHandleId when calling XblMultiplayerManagerJoinLobby().  
            // See the example call as follows.
        }
    }
}

XTaskQueueRegistrationToken token = { 0 };
HRESULT hr = XGameActivationRegisterForEvent(
    queue,
    nullptr,
    MyXGameInviteEventCallback,
    &token);

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.

Revenir au début de cette rubrique.

Rejoindre une session de jeu depuis le salon

Une fois les invitations acceptées et l’hôte prêt à commencer la partie, vous pouvez démarrer une nouvelle partie incluant les membres de la session de salon en appelant XblMultiplayerManagerJoinGameFromLobby. Les résultats d’erreur ou de réussite sont gérés au moyen de l’événement JoinGameCompleted.

API C plat

HRESULT hr = XblMultiplayerManagerJoinGameFromLobby(gameSessionTemplateName);
if (!SUCCEEDED(hr))
{
    // Handle error.
}

Pour plus d’informations, consultez XblMultiplayerManagerJoinGameFromLobby. Multiplayer Manager effectue les opérations suivantes pour rejoindre une session de jeu depuis le salon.

Création de la session de jeu.
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.
Publication de la partie au moyen de la session de salon.

Revenir au début de cette rubrique.

XBOX Services

PlayFab

Jouer en multijoueur avec des amis à l'aide de Multiplayer Manager

Étapes pour envoyer et accepter une invitation

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

API C plat

Accepter des invitations

API C plat

Rejoindre une session de jeu depuis le salon

API C plat

​Étapes pour envoyer et accepter une invitation

​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

​API C plat

​Accepter des invitations

​API C plat

​Rejoindre une session de jeu depuis le salon

​API C plat

Étapes pour envoyer et accepter une invitation

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

API C plat

Accepter des invitations

API C plat

Rejoindre une session de jeu depuis le salon

API C plat