네임스페이스
Multiplayer Manager는 다음 네임스페이스에 포함되어 있습니다.
다음의 주요 클래스를 이해해야 합니다.
Multiplayer Manager 클래스
Multiplayer Manager는 단일 로비 세션 객체와 단일 게임 세션 객체를 포함하는 싱글톤 클래스입니다. 최소한, Multiplayer Manager가 작동하려면 이 클래스에서 XblMultiplayerManagerInitialize 및 XblMultiplayerManagerDoWork 메서드를 호출해야 합니다. 다음 표에서는 더 일반적으로 사용되는 메서드와 속성 중 일부를 설명합니다(전체 목록은 아님). 멤버의 완전한 설명 목록은 참조 문서를 참조하세요.Multiplayer Event 클래스
XblMultiplayerManagerDoWork를 호출하면 Multiplayer Manager는 마지막으로
XblMultiplayerManagerDoWork를 호출한 이후 세션의 변경 사항을 나타내는 이벤트 목록을 반환합니다. 이러한 이벤트에는 멤버가 세션에 참여함, 멤버가 세션에서 나감, 멤버 속성이 변경됨 또는 호스트 클라이언트가 변경됨과 같은 변경 사항이 포함됩니다.
가능한 모든 이벤트 유형 목록은 XblMultiplayerEventType 열거형을 참조하세요.
반환된 각 XblMultiplayerEvent에는 EventArgsHandle이 포함됩니다. 이를 사용하여 이벤트 유형에 적합한 args를 가져와야 합니다. 예를 들어, XblMultiplayerEventType이 MemberJoined이면 XblMultiplayerEventArgsMembersCount 및 XblMultiplayerEventArgsMembers를 호출합니다.
게임은 XblMultiplayerManagerDoWork를 호출한 후 필요에 따라 각 이벤트를 처리해야 합니다.
Multiplayer Member 클래스
이 클래스는 로비 또는 게임 세션의 플레이어를 나타냅니다. 플레이어의 XBOX 사용자 ID, 플레이어의 네트워크 연결 주소 및 각 플레이어에 대한 사용자 지정 속성과 같은 멤버에 대한 속성을 포함합니다.
Multiplayer Lobby Session 클래스
이 클래스는 이 디바이스에 로컬로 있는 사용자와 함께 플레이하려는 초대된 친구를 관리하는 데 사용되는 영구 세션을 만듭니다. Multiplayer Manager가 멀티플레이어 작업을 수행하려면 로비 세션에 최소한 하나의 멤버가 포함되어야 합니다. 처음에 XblMultiplayerManagerLobbySessionAddLocalUser 메서드를 호출하여 새 로비 세션을 만들 수 있습니다.
다음 표에서는 이 클래스의 더 일반적으로 사용되는 메서드와 속성 중 일부를 설명합니다(전체 목록은 아님). 클래스 멤버의 완전한 설명 목록은 참조 문서를 참조하세요.
Multiplayer Game Session 클래스
게임 세션은 실제 게임 플레이 인스턴스에 참여하는 XBOX services 멤버 그룹을 나타냅니다. 여기에는 매치메이킹 서비스를 통해 매칭된 플레이어가 포함될 수 있습니다.
로비 세션의 멤버를 포함하는 새 게임 세션을 시작하려면 XblMultiplayerManagerJoinGameFromLobby를 호출합니다. XBOX services 매치메이킹을 사용하려면 XblMultiplayerManagerFindMatch를 호출합니다. 타사 매치메이킹 서비스를 사용하는 경우 XblMultiplayerManagerJoinGame을 호출합니다.
다음 표에서는 Multiplayer Manager의 더 일반적으로 사용되는 메서드와 속성 중 일부를 설명합니다(전체 목록은 아님). 클래스 멤버의 완전한 설명 목록은 이 클래스의 API 참조를 참조하세요.