Namespace
O Multiplayer Manager está incluído no namespace a seguir.
Você deve entender as principais classes a seguir.
Classe Multiplayer Manager
O Multiplayer Manager é uma classe singleton que contém um único objeto de sessão de lobby e um único objeto de sessão de jogo. No mínimo, você deve chamar os métodos XblMultiplayerManagerInitialize e XblMultiplayerManagerDoWork dessa classe para que o Multiplayer Manager funcione. A tabela a seguir descreve alguns, mas não todos, dos métodos e propriedades mais usados. Para obter uma lista completa e descritiva dos membros, consulte a documentação de referência.Classe Multiplayer Event
Quando você chama XblMultiplayerManagerDoWork, o Multiplayer Manager retorna uma lista de eventos que representam as alterações nas sessões desde a última chamada a
XblMultiplayerManagerDoWork. Esses eventos incluem alterações como um membro que ingressou em uma sessão, um membro que saiu de uma sessão, propriedades de membros que mudaram ou a mudança do cliente host.
Para obter uma lista de todos os tipos de evento possíveis, consulte a enumeração XblMultiplayerEventType.
Cada XblMultiplayerEvent retornado inclui um EventArgsHandle. Você deve usá-lo para obter os args apropriados para o tipo de evento. Por exemplo, se o XblMultiplayerEventType for MemberJoined, você chamaria XblMultiplayerEventArgsMembersCount e XblMultiplayerEventArgsMembers.
Seu jogo deve tratar cada um dos eventos conforme necessário após chamar XblMultiplayerManagerDoWork.
Classe Multiplayer Member
Essa classe representa um jogador em uma sessão de lobby ou de jogo. Ela contém propriedades sobre o membro, como o ID de usuário do XBOX do jogador, o endereço de conexão de rede do jogador e propriedades personalizadas de cada jogador.
Classe Multiplayer Lobby Session
Essa classe cria uma sessão persistente usada para gerenciar os usuários locais deste dispositivo e os amigos convidados que desejam jogar juntos. Uma sessão de lobby deve conter pelo menos um membro para que o Multiplayer Manager execute qualquer ação multiplayer. Inicialmente, você pode criar uma nova sessão de lobby chamando o método XblMultiplayerManagerLobbySessionAddLocalUser.
A tabela a seguir descreve alguns, mas não todos, dos métodos e propriedades mais usados dessa classe. Para obter uma lista completa e descritiva dos membros da classe, consulte a documentação de referência.
Classe Multiplayer Game Session
A sessão de jogo representa o grupo de membros dos serviços do XBOX que estão participando de uma instância de jogabilidade real. Isso pode incluir jogadores que foram combinados por meio de serviços de matchmaking.
Para iniciar uma nova sessão de jogo que inclua membros da sessão de lobby, chame XblMultiplayerManagerJoinGameFromLobby. Se quiser usar o matchmaking dos serviços do XBOX, chame XblMultiplayerManagerFindMatch. Se estiver usando um serviço de matchmaking de terceiros, chame XblMultiplayerManagerJoinGame.
A tabela a seguir descreve alguns, mas não todos, dos métodos e propriedades mais usados do Multiplayer Manager. Para obter uma lista completa e descritiva dos membros da classe, consulte a referência da API dessa classe.