Espace de noms
Multiplayer Manager est inclus dans l’espace de noms suivant.
Vous devez comprendre les principales classes suivantes.
Classe Multiplayer Manager
Multiplayer Manager est une classe singleton qui contient un seul objet de session de salon et un seul objet de session de jeu. Vous devez au minimum appeler les méthodes XblMultiplayerManagerInitialize et XblMultiplayerManagerDoWork de cette classe pour que Multiplayer Manager fonctionne. Le tableau suivant décrit certaines des méthodes et propriétés les plus couramment utilisées, mais pas toutes. Pour obtenir la liste complète et détaillée des membres, consultez la documentation de référence.Classe Multiplayer Event
Lorsque vous appelez XblMultiplayerManagerDoWork, Multiplayer Manager retourne une liste d’événements qui représentent les modifications apportées aux sessions depuis votre dernier appel à
XblMultiplayerManagerDoWork. Ces événements comprennent des modifications telles que l’arrivée d’un membre dans une session, le départ d’un membre d’une session, la modification des propriétés d’un membre ou le changement du client hôte.
Pour obtenir la liste de tous les types d’événements possibles, consultez l’énumération XblMultiplayerEventType.
Chaque XblMultiplayerEvent retourné inclut un EventArgsHandle. Vous devez l’utiliser pour obtenir les args appropriés au type d’événement. Par exemple, si le XblMultiplayerEventType est MemberJoined, vous appelez XblMultiplayerEventArgsMembersCount et XblMultiplayerEventArgsMembers.
Votre jeu doit gérer chacun des événements selon les besoins après avoir appelé XblMultiplayerManagerDoWork.
Classe Multiplayer Member
Cette classe représente un joueur dans une session de salon ou de jeu. Elle contient des propriétés relatives au membre, comme l’ID d’utilisateur XBOX du joueur, l’adresse de connexion réseau du joueur et des propriétés personnalisées pour chaque joueur.
Classe Multiplayer Lobby Session
Cette classe crée une session persistante utilisée pour gérer les utilisateurs locaux de cet appareil et les amis invités qui souhaitent jouer ensemble. Une session de salon doit contenir au moins un membre pour que Multiplayer Manager puisse effectuer des actions multijoueurs. Vous pouvez créer initialement une session de salon en appelant la méthode XblMultiplayerManagerLobbySessionAddLocalUser.
Le tableau suivant décrit certaines des méthodes et propriétés les plus couramment utilisées de cette classe, mais pas toutes. Pour obtenir la liste complète et détaillée des membres de la classe, consultez la documentation de référence.
Classe Multiplayer Game Session
La session de jeu représente le groupe de membres des services XBOX qui participent à une instance de jeu proprement dite. Elle peut inclure des joueurs mis en relation au moyen de services de matchmaking.
Pour démarrer une session de jeu qui inclut des membres de la session de salon, appelez XblMultiplayerManagerJoinGameFromLobby. Si vous souhaitez utiliser le matchmaking des services XBOX, appelez XblMultiplayerManagerFindMatch. Si vous utilisez un service de matchmaking tiers, appelez XblMultiplayerManagerJoinGame.
Le tableau suivant décrit certaines des méthodes et propriétés les plus couramment utilisées de Multiplayer Manager, mais pas toutes. Pour obtenir la liste complète et détaillée des membres de la classe, consultez la référence de l’API de cette classe.