다음을 통해 공유


멀티 플레이어 관리자를 사용하여 게임 초대 보내기

간단한 멀티 플레이어 시나리오에서 게임의 플레이어는 친구들과 온라인으로 플레이할 수 있습니다. 이 토픽에서는 게임에 참가하기 위해 다른 플레이어에게 초대를 보내는 단계를 설명합니다.

멀티 플레이어 관리자를 초기화하고 로컬 사용자를 추가하여 로비 세션을 만듭니다. 더 자세한 내용은 멀티 플레이어 관리자를 사용하여 친구와 멀티 플레이 게임 하기 허용을 참조하세요. XblMultiplayerEventType::UserAdded 이벤트를 수신하면 초대 보내기를 시작 할 수 있습니다.

초대는 두 가지 방법으로 보낼 수 있습니다.

더 자세한 내용은 다른 플레이어에게 초대 보내기(순서도)에서 프로세스를 확인하세요.

Xbox 플랫폼 초대 TCUI

XblMultiplayerManagerLobbySessionInviteFriends를 호출하여 플레이어가 게임에 초대할 친구 또는 최근 플레이어를 선택할 수 있는 표준 Xbox UI를 표시합니다. 플레이어가 선택 확인을 누르면 멀티 플레이어 관리자가 선택된 플레이어에게 초대를 보냅니다.

플랫 C API

std::string customActivationContext = "{ \"customGameData\": 1 }"; // This string can be anything your game sends across to the invited player's game.

HRESULT hr = XblMultiplayerManagerLobbySessionInviteFriends(xuserHandle, nullptr, customActivationContext.c_str());

멀티 플레이어 관리자는 Xbox 플랫폼 초대 TCUI를 사용하여 플레이어를 초대하기 위해 다음 기능을 수행합니다.

  • Xbox 표준 TCUI를 표시합니다.
  • 선택한 플레이어에게 직접 초대를 보냅니다.

타이틀에서 실행되는 사용자 지정 UI

타이틀은 사용자 지정 TCUI를 구현해 온라인 친구를 보고 초대할 수 있습니다. 또한 게임에서 XblMultiplayerManagerLobbySessionInviteUsers 메서드를 사용하여 Xbox Live 사용자 ID로 정의한 사용자 집합에 초대를 보낼 수도 있습니다. 이 방법은 표준 Xbox UI 대신 자체 게임 내 UI 사용할 때 유용합니다.

플랫 C API

size_t xuidsCount = 1;
uint64_t xuids[1] = {};
xuids[0] = 1234567891234567;
HRESULT hr = XblMultiplayerManagerLobbySessionInviteUsers(
    xblUserHandle, 
    xuids, 
    xuidsCount, 
    nullptr,    // ContextStringId 
    nullptr     // CustomActivationContext
);

타이틀 구현 사용자 지정 UI를 사용하는 경우 멀티 플레이어 관리자는 선택한 플레이어에게 직접 초대를 보냅니다.