Vue d'ensemble de Multiplayer Manager

​

Fonctionnalités clés

• Gestion simplifiée des sessions et du matchmaking des services XBOX
• Modèle de programmation basé sur les états et sur les événements
• Respect des pratiques exemplaires des services XBOX et conformité aux XR multijoueurs
• Implémentation des organigrammes du Multijoueur 2015

• Les grandes sessions MPSD (plus de 100 membres) ne sont pas prises en charge.
• Elle cible uniquement les conceptions multijoueurs hébergées par un pair. Les titres disposant de serveurs dédiés doivent plutôt utiliser le service Multiplayer Activity ou les API du service Multijoueur et les appels de service à service (rubrique sous NDA).

​

Vue d’ensemble

• Session de salon : session persistante utilisée pour gérer les utilisateurs locaux de l’appareil et les amis invités qui souhaitent jouer ensemble. Le groupe peut jouer au jeu; par exemple, sur plusieurs manches, cartes et niveaux. La session de salon suit ce groupe d’amis principal (y compris les joueurs locaux de l’appareil). En général, ce groupe se forme pendant que l’hôte parcourt les menus et discute avec les membres du groupe pour choisir le mode de jeu auquel ils souhaitent jouer.
• Session de jeu : suit les joueurs qui jouent à une instance spécifique du jeu. Par exemple, une course, une carte ou un niveau. Vous pouvez créer une session de jeu au moyen de XblMultiplayerManagerJoinGameFromLobby, qui inclut les membres de la session de salon. Lorsqu’un membre accepte une invitation, il est ajouté au salon et à la session de jeu (s’il reste de la place). D’autres joueurs peuvent être ajoutés à la session de jeu si le matchmaking est activé, mais ces joueurs supplémentaires ne sont pas ajoutés à la session de salon. Cela signifie qu’à la fin de la partie, les joueurs de la session de salon restent ensemble, contrairement aux joueurs supplémentaires issus du matchmaking.
• XblMultiplayerManagerMember : représente un utilisateur individuel connecté sur un appareil local ou distant.
• XblMultiplayerManagerDoWork : garantit le maintien de mises à jour correctes de l’état du jeu entre le titre et le service Multijoueur des services XBOX. Pour garantir des performances optimales, XblMultiplayerManagerDoWork doit être appelée fréquemment, par exemple une fois par trame. XblMultiplayerManagerDoWork vous fournit un tableau d’événements de rappel XblMultiplayerEvent que le jeu doit gérer.

​

Machine à états

​

Threads

​

Mise à jour du modèle basé sur les états

​

Événements et notifications

​

API C plat

size_t eventCount{ 0 };
const XblMultiplayerEvent* events{ nullptr };
HRESULT hr = XblMultiplayerManagerDoWork(&events, &eventCount);
if (FAILED(hr))
{
    // Handle failure.
}

for (auto i = 0u; i < eventCount; ++i)
{
    switch (events[i].EventType)
    {
        case XblMultiplayerEventType::MemberJoined:
        {
            // Handle MemberJoined.
            size_t memberCount = 0;
            hr = XblMultiplayerEventArgsMembersCount(events[i].EventArgsHandle, &memberCount);
            assert(SUCCEEDED(hr));

            std::vector<XblMultiplayerManagerMember> members(memberCount);
            hr = XblMultiplayerEventArgsMembers(events[i].EventArgsHandle, memberCount, members.data());
            assert(SUCCEEDED(hr));
            ...

            break;
        }

        case XblMultiplayerEventType::SessionPropertyChanged:
        {
            // Handle SessionPropertyChanged.
            const char* changedProperty{ nullptr };
            hr = XblMultiplayerEventArgsPropertiesJson(events[i].EventArgsHandle, &changedProperty);
            assert(SUCCEEDED(hr));
            ...

            break;
        }
        ...
    }
}

• XblMultiplayerEvent
• XblMultiplayerEventArgsMembers
• XblMultiplayerEventArgsMembersCount
• XblMultiplayerEventArgsPropertiesJson
• XblMultiplayerEventType
• XblMultiplayerManagerDoWork
• XblMultiplayerManagerMember

​

Scénarios

• Permettre de jouer à une partie multijoueur avec des amis à l’aide de Multiplayer Manager
• Trouver une partie multijoueur avec SmartMatch à l’aide de Multiplayer Manager
• Envoi d’invitations de jeu à l’aide de Multiplayer Manager
• Gestion de l’activation de protocole pour démarrer une partie à l’aide de Multiplayer Manager

​

Ce que Multiplayer Manager ne fait pas

• Les jeux sur serveur en ligne persistants, comme les jeux en ligne massivement multijoueurs (MMO) ou d’autres types de jeux nécessitant de grandes sessions (plus de 100 joueurs dans une session)
• La gestion des sessions de serveur à serveur
• La limitation des appels au MPSD afin de respecter la limitation du débit granulaire
• Le mélange des API du service Multijoueur et des API Multiplayer Manager

​

Ressources