> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Multiplayer Manager를 사용하여 게임 초대 보내기

> 플랫폼 타이틀 호출 가능 UI(TCUI) 또는 타이틀에서 구현한 사용자 지정 초대 UI를 사용하여 Multiplayer Manager로 XBOX Live 게임 초대를 보내는 방법입니다.

간단한 멀티플레이어 시나리오에서 게임의 플레이어는 친구와 온라인으로 게임을 플레이할 수 있습니다. 이 항목에서는 다른 플레이어에게 게임에 참여하도록 초대를 보내는 단계를 설명합니다.

Multiplayer Manager를 초기화하고 로컬 사용자를 추가하여 로비 세션을 만듭니다. 자세한 내용은 [Multiplayer Manager를 사용하여 친구와 멀티플레이어 게임 플레이 활성화](/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-friends)를 참조하세요.
[XblMultiplayerEventType](/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype)`::UserAdded` 이벤트를 받은 후 초대를 보내기 시작할 수 있습니다.

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

* [XBOX 플랫폼 초대 타이틀 호출 가능 UI(TCUI)](#xbox-platform-invite-tcui)
* [타이틀에서 구현한 사용자 지정 UI](#title-implemented-custom-ui)

프로세스에 대한 자세한 내용은 [다른 플레이어에게 초대 보내기(순서도)](/services/xbox-services/multiplayer/mpm/concepts/flowcharts/live-mpm-send-invites)를 참조하세요.

### XBOX 플랫폼 초대 TCUI <a id="xbox-platform-invite-tcui" />

[XblMultiplayerManagerLobbySessionInviteFriends](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends)를 호출하여 플레이어가 게임에 초대할 친구 또는 최근 플레이어를 선택할 수 있는 표준 XBOX UI를 표시합니다.
플레이어가 선택을 확인하면 Multiplayer Manager는 선택된 플레이어에게 초대를 보냅니다.

#### Flat C API

```cpp theme={null}
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());
```

Multiplayer Manager는 XBOX 플랫폼 초대 TCUI를 사용하여 플레이어를 초대하기 위해 다음 기능을 수행합니다.

* XBOX 표준 TCUI를 표시합니다.
* 선택된 플레이어에게 직접 초대를 보냅니다.

### 타이틀에서 구현한 사용자 지정 UI<a id="title-implemented-custom-ui" />

타이틀은 온라인 친구를 보고 초대하기 위한 사용자 지정 TCUI를 구현할 수 있습니다.
게임은 [XblMultiplayerManagerLobbySessionInviteUsers](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers) 메서드를 사용하여 XBOX Live 사용자 ID로 정의된 사람들의 집합에 초대를 보낼 수 있습니다.
이는 표준 XBOX UI 대신 자체 게임 내 UI를 사용하는 경우 유용합니다.

#### Flat C API

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

타이틀에서 구현한 사용자 지정 UI를 사용할 때 Multiplayer Manager는 선택된 플레이어에게 직접 초대를 보냅니다.


## Related topics

- [초대 보내기](/ko/services/xbox-services/multiplayer/invites/how-to/live-invites-send.md)
- [초대 개요](/ko/services/xbox-services/multiplayer/invites/live-multiplayer-invites-overview.md)
- [게임 세션에 플레이어 초대](/ko/services/xbox-services/multiplayer/invites/live-invites-nav.md)
- [Multiplayer Manager 예제 코드](/ko/services/xbox-services/multiplayer/mpm/how-to/live-mm-howto-nav.md)
- [Multiplayer Manager 개요](/ko/services/xbox-services/multiplayer/mpm/live-multiplayer-manager-overview.md)