Multiplayer Session Directory 개요

• MPSD 세션
• MPSD 변경 알림 처리 및 연결 해제 감지
• 세션에 대한 MPSD 핸들
• 세션 업데이트의 동기화
• MPSD 호출
• Multiplayer Session Explorer

​

MPSD 세션

• 타이틀에 의해 생성되고 관리됩니다.
• 고유한 URI를 가집니다. 자세한 내용은 Session Directory URIs를 참조하세요.
• 세션 구성원이라고 하는 사용자 간의 연결을 가능하게 합니다.
• 구성원별 특성, 게임 설정, 부트스트래핑 정보 및 게임 서버 정보와 같은 게임 플레이를 지원하는 데이터를 저장합니다.

​

MPSD 변경 알림 처리 및 연결 해제 감지

• 타이틀이 시작한 이벤트 구독을 기반으로 세션 변경이 발생할 때 간단한 알림(숄더 탭)을 전송합니다.
• 사용자 연결 해제를 감지합니다.
• 연결 해제 감지에 따라 사용자를 비활성으로 설정한 후 세션에서 제거합니다.

​

사용자 연결 만들기

1. 타이틀은 XblMultiplayerSetSubscriptionsEnabled를 호출합니다. 이 메서드는 클라이언트가 멀티플레이어 목적으로 RTA 연결을 사용할 것임을 XSAPI에 알립니다.
2. 타이틀이 현재 사용자를 활성 상태로 설정한 채 XblMultiplayerWriteSessionAsync 또는 XblMultiplayerWriteSessionByHandleAsync에 대한 첫 번째 호출을 수행하면 연결이 생성되어 MPSD에 연결됩니다.

​

세션 변경 구독

​

숄더 탭 처리

​

연결 상태 변경 알림 처리

• XblMultiplayerSessionSubscriptionLostHandler 핸들러 - RTA 서비스를 사용하는 MPSD에 대한 타이틀 연결이 손실될 때 발생합니다. 이 이벤트가 발생하면 타이틀은 멀티플레이어를 종료해야 합니다.
• XblRealTimeActivityConnectionStateChangeHandler 핸들러 - RTA 서비스에 대한 타이틀 연결 상태의 일시적 변경 시 발생합니다. 타이틀은 이 이벤트를 수신할 때 어떠한 조치를 취할 필요는 없지만, 이 이벤트는 진단 목적에 유용할 수 있습니다.

​

클라이언트 연결 해제

​

연결 해제 감지

​

RTA 재연결 처리

void* context{ nullptr };
XblFunctionContext connectionIdChangedFunctionContext = XblMultiplayerAddConnectionIdChangedHandler(
    xblContextHandle,
    [](void* context) {
        XblMultiplayerSessionHandle sessionHandle; // Retrieve the MPSD session to update
        XblMultiplayerSessionCurrentUserSetStatus(sessionHandle, XblMultiplayerSessionMemberStatus::Active);

        auto asyncBlock = std::make_unique<XAsyncBlock>();
        asyncBlock->queue = queue;
        asyncBlock->context = nullptr;
        asyncBlock->callback = [](XAsyncBlock* asyncBlock)
        {
            std::unique_ptr<XAsyncBlock> asyncBlockPtr{ asyncBlock };

            XblMultiplayerSessionHandle sessionHandle;
            HRESULT hr = XblMultiplayerWriteSessionResult(asyncBlock, &sessionHandle);
            if (SUCCEEDED(hr))
            {
                // If the write call succeeds, the connection ID has been updated and no further action is needed.
            }
            else
            {
                // If the write call fails, it's likely that the user has been removed from the session.
            }
        };

        auto hr = XblMultiplayerWriteSessionAsync(xblContextHandle, sessionHandle, XblMultiplayerSessionWriteMode::UpdateExisting, asyncBlock.get());
        if (SUCCEEDED(hr))
        {
            asyncBlock.release();
        }
    }, 
    context);

​

세션에 대한 MPSD 핸들

​

핸들 유형

​

초대 핸들

​

초대 핸들 만들기

​

활동 핸들 만들기

​

핸들 사용

1. 타이틀 활성화 매개 변수에서 핸들 ID를 가져옵니다.
2. 로컬 MPSD 세션 개체를 만든 다음, 활성 상태로 참가합니다.
3. 적절한 핸들을 전달하여 세션을 씁니다.

​

세션 업데이트의 동기화

• 중재자가 세션의 공유 부분을 업데이트합니다. 구현에 단일 중재자가 포함된 경우 대부분의 쓰기 작업에 대해 동기화된 업데이트 사용을 피할 수 있습니다. 타이틀은 다음과 같은 경우에 동기화를 피할 수 있습니다.
  • 중재자의 신원 전달과 관련이 없는 한, 중재자가 세션의 공유 부분에 대해 수행하는 모든 업데이트
  • 타이틀이 세션 내 구성원 영역에 대해 수행하는 모든 업데이트

  [!NOTE] 앞서 언급한 업데이트 유형은 동기화가 필요하지 않지만, XblMultiplayerSessionProperties::HostDeviceToken 속성에 대한 업데이트는 여전히 동기화하는 것이 중요합니다. 이 속성은 예를 들어 중재자 마이그레이션의 일환으로 중재자의 신원을 전달하는 데 사용됩니다.

• 모든 클라이언트가 세션의 공유 부분을 업데이트합니다. 이 경우 세션의 공유 부분에 대한 모든 업데이트는 동기화되어야 합니다. 그러나 타이틀은 여전히 동기화 없이 자체 구성원 영역에 쓸 수 있습니다.

​

Multiplayer API를 사용한 세션 동기화 업데이트

• XblMultiplayerWriteSessionAsync
• XblMultiplayerWriteSessionByHandleAsync

​

Multiplayer REST API를 사용한 세션 동기화 업데이트

​

MPSD 호출

• RESTful 기능에 대한 래퍼 역할을 하는 클래스가 포함된 멀티플레이어 API 사용을 권장합니다. 자세한 내용은 XblMultiplayer 접두사 함수를 참조하세요. SmartMatch 매치메이킹에는 XblMatchmaking 접두사 함수로 표시되는 매치메이킹 API를 사용하세요.
• XBOX services RESTful reference에 포함된 멀티플레이어 및 매치메이킹 REST API에 대한 직접적인 표준 HTTP 호출을 사용합니다. 해당 URI는 Session Directory URIs(멀티플레이어) 및 Matchmaking URIs(매치메이킹) 섹션에 설명되어 있습니다. 관련된 JSON 객체는 JavaScript Object Notation(JSON) Object Reference 섹션에 설명되어 있습니다.

​

Multiplayer API를 사용하여 MPSD 호출

​

Multiplayer REST API를 사용하여 MPSD와 상호 작용

​

세션 및 세션 템플릿에 대한 쿼리(REST)

​

기본 세션 정보에 대한 쿼리

​

세션 템플릿에 대한 쿼리

• /serviceconfigs//sessiontemplates
• /serviceconfigs//sessiontemplates/

​

세션 상태에 대한 쿼리

• /serviceconfigs//sessions
• /serviceconfigs//sessiontemplates//sessions

​

Multiplayer Session Explorer

​

Multiplayer Session Explorer 액세스

​

기본 페이지 열기

1. 도구의 기본 페이지를 엽니다. 보안 컨텍스트(로그인한 사용자 및 샌드박스)와 샌드박스의 SCID 목록이 표시됩니다.
2. URI를 다시 입력할 필요가 없도록 이 페이지를 홈에 고정하려면 메뉴 버튼을 누릅니다.

​

사용 가능한 세션 및 템플릿 표시

1. 도구에서 SCID를 선택하여 로그인한 사용자를 구성원으로 포함하는 해당 SCID의 세션 목록을 표시합니다.
2. 같은 페이지에서 SCID를 선택하여 해당 SCID의 서비스 구성에 있는 세션 템플릿 및 지역화 문자열을 표시할 수 있습니다. 이러한 항목은 Partner Center를 통해 수집됩니다.

​

세션의 전체 내용 표시

• GET 호출은 X-Xbl-Contract-Version 헤더에서 이전 계약 버전을 사용할 수 있습니다. Multiplayer Session Explorer는 항상 최신 계약 버전을 사용하여 세션을 표시합니다.
• GET을 통해 세션이 정상적으로 요청되는 경우, 만료된 시간 초과와 같은 변환 및 부수 효과가 트리거될 수 있습니다. Multiplayer Session Explorer는 어떠한 로직, 변환 또는 부수 효과를 실행하지 않고 저장된 상태 그대로 세션의 스냅샷을 표시합니다.
• nextTimer JSON 객체 필드는 부수 효과와 같은 시점에 계산되기 때문에 MPSD 세션에 존재하지 않습니다.

​

참고 항목

• Multiplayer Session advanced topics 항목의 세션 개요 섹션
• Multiplayer 세션 상태 코드
• Multiplayer tasks 항목의 MPSD 세션 업데이트 섹션
• Multiplayer tasks 항목의 타이틀 활성화에서 MPSD 세션에 참가하기 섹션
• Multiplayer tasks 항목의 MPSD 세션 변경 알림 구독 섹션
• Matchmaking 개요