Espacio de nombres
Multiplayer Manager se incluye en el siguiente espacio de nombres.
Debes comprender las siguientes clases principales.
Clase Multiplayer Manager
Multiplayer Manager es una clase singleton que contiene un único objeto de sesión de sala y un único objeto de sesión de juego. Como mínimo, debes llamar a los métodos XblMultiplayerManagerInitialize y XblMultiplayerManagerDoWork de esta clase para que Multiplayer Manager funcione. La siguiente tabla describe algunos de los métodos y propiedades de uso más común, aunque no todos. Para obtener una lista completa y descriptiva de los miembros, consulta la documentación de referencia.Clase Multiplayer Event
Cuando llamas a XblMultiplayerManagerDoWork, Multiplayer Manager devuelve una lista de eventos que representan los cambios en las sesiones desde la última vez que llamaste a
XblMultiplayerManagerDoWork. Estos eventos incluyen cambios como que un miembro se ha unido a una sesión, que un miembro ha abandonado una sesión, que las propiedades de un miembro han cambiado o que el cliente host ha cambiado.
Para ver una lista de todos los tipos de evento posibles, consulta la enumeración XblMultiplayerEventType.
Cada XblMultiplayerEvent devuelto incluye un EventArgsHandle. Debes usarlo para obtener los args adecuados para el tipo de evento. Por ejemplo, si el XblMultiplayerEventType es MemberJoined, llamarías a XblMultiplayerEventArgsMembersCount y a XblMultiplayerEventArgsMembers.
Tu juego debe controlar cada uno de los eventos según sea necesario después de llamar a XblMultiplayerManagerDoWork.
Clase Multiplayer Member
Esta clase representa a un jugador en una sesión de sala o de juego. Contiene propiedades sobre el miembro, como el identificador de usuario de XBOX del jugador, la dirección de conexión de red del jugador y propiedades personalizadas de cada jugador.
Clase Multiplayer Lobby Session
Esta clase crea una sesión persistente que se usa para administrar a los usuarios locales de este dispositivo y a los amigos invitados que quieren jugar juntos. Una sesión de sala debe contener al menos un miembro para que Multiplayer Manager realice cualquier acción multijugador. Puedes crear inicialmente una nueva sesión de sala llamando al método XblMultiplayerManagerLobbySessionAddLocalUser.
La siguiente tabla describe algunos de los métodos y propiedades de uso más común de esta clase, aunque no todos. Para obtener una lista completa y descriptiva de los miembros de la clase, consulta la documentación de referencia.
Clase Multiplayer Game Session
La sesión de juego representa el grupo de miembros de los servicios XBOX que participan en una instancia de juego real. Esto puede incluir a jugadores que se han emparejado mediante servicios de emparejamiento.
Para iniciar una nueva sesión de juego que incluya miembros de la sesión de sala, llama a XblMultiplayerManagerJoinGameFromLobby. Si quieres usar el emparejamiento de los servicios XBOX, llama a XblMultiplayerManagerFindMatch. Si usas un servicio de emparejamiento de terceros, llama a XblMultiplayerManagerJoinGame.
La siguiente tabla describe algunos de los métodos y propiedades de uso más común de Multiplayer Manager, aunque no todos. Para obtener una lista completa y descriptiva de los miembros de la clase, consulta la referencia de API de esta clase.