Multiplayer Manager 개요

​

주요 기능

• 간편한 세션 관리 및 XBOX services 매치메이킹
• 상태 기반 및 이벤트 기반 프로그래밍 모델
• XBOX services 모범 사례 준수 및 Multiplayer XR 규정 준수
• 2015 멀티플레이어 흐름도 구현

• 대규모 MPSD 세션(100명 이상의 멤버)은 지원되지 않습니다.
• P2P 호스팅 멀티플레이어 디자인만 대상으로 합니다. 전용 서버가 있는 타이틀은 대신 Multiplayer Activity Service 또는 Multiplayer Service API 및 서비스 간 호출(NDA 항목)을 사용해야 합니다.

​

개요

• 로비 세션: 디바이스에 로컬인 사용자와 함께 플레이하려는 초대된 친구를 관리하는 데 사용되는 영구 세션입니다. 그룹은 여러 라운드, 맵, 레벨과 같은 게임을 플레이할 수 있습니다. 로비 세션은 이 핵심 친구 그룹(디바이스에 로컬인 플레이어 포함)을 추적합니다. 일반적으로 이 그룹은 호스트가 메뉴를 탐색하고 그룹 멤버와 채팅하며 어떤 게임 모드를 플레이할지 결정할 때 형성됩니다.
• 게임 세션: 게임의 특정 인스턴스를 플레이하는 플레이어를 추적합니다. 예를 들어 레이스, 맵 또는 레벨입니다. XblMultiplayerManagerJoinGameFromLobby를 통해 로비 세션의 멤버를 포함하는 새 게임 세션을 만들 수 있습니다. 멤버가 초대를 수락하면 그들은 로비와 (자리가 있으면) 게임 세션에 추가됩니다. 매치메이킹이 활성화된 경우 게임 세션에 추가 플레이어를 추가할 수 있지만 이러한 추가 플레이어는 로비 세션에 추가되지 않습니다. 즉, 게임이 종료되면 로비 세션의 플레이어는 여전히 함께 있지만 매치메이킹에서 온 추가 플레이어는 함께 있지 않습니다.
• XblMultiplayerManagerMember: 로컬 또는 원격 디바이스에 로그인된 개별 사용자를 나타냅니다.
• XblMultiplayerManagerDoWork: 타이틀과 XBOX services 멀티플레이어 서비스 간에 적절한 게임 상태 업데이트가 유지되도록 합니다. 최상의 성능을 보장하려면 XblMultiplayerManagerDoWork를 프레임당 한 번씩과 같이 자주 호출해야 합니다. XblMultiplayerManagerDoWork는 게임이 처리할 XblMultiplayerEvent 콜백 이벤트 배열을 제공합니다.

​

상태 머신

​

스레딩

​

상태 기반 모델 업데이트

​

이벤트 및 알림

​

Flat C API

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

​

시나리오

• Multiplayer Manager를 사용하여 친구와 멀티플레이어 게임 플레이 활성화
• Multiplayer Manager를 사용한 SmartMatch로 멀티플레이어 게임 찾기
• Multiplayer Manager를 사용하여 게임 초대 보내기
• Multiplayer Manager를 사용하여 게임을 시작하기 위한 프로토콜 활성화 처리

​

Multiplayer Manager가 수행하지 않는 작업

• MMO(대규모 다중 사용자 온라인) 게임 또는 대규모 세션(세션당 100명 이상의 플레이어)이 필요한 기타 게임 유형과 같은 지속적인 온라인 서버 게임
• 서버 대 서버 세션 관리
• 세분화된 속도 제한을 준수하기 위한 MPSD 호출 조절
• Multiplayer 서비스 API와 Multiplayer Manager API 혼합

​

리소스