> ## 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.

# 使用多人遊戲管理員傳送遊戲邀請

> 如何使用平台的遊戲可呼叫 UI (TCUI) 或遊戲實作的自訂邀請 UI，透過多人遊戲管理員傳送 XBOX Live 遊戲邀請。

在簡單的多人遊戲案例中，您遊戲的玩家可以與好友一起線上遊玩。本主題說明傳送邀請給其他玩家以加入您遊戲的步驟。

初始化多人遊戲管理員，並藉由新增本機使用者來建立大廳工作階段。如需詳細資訊，請參閱[使用多人遊戲管理員啟用與好友一起玩多人遊戲](/zh-TW/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-friends)。
收到 [XblMultiplayerEventType](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype)`::UserAdded` 事件之後，您就可以開始傳送邀請。

邀請可以透過兩種方式傳送。

* [XBOX 平台邀請遊戲可呼叫 UI (TCUI)](#xbox-platform-invite-tcui)
* [遊戲實作的自訂 UI](#title-implemented-custom-ui)

如需此程序的詳細資訊，請參閱[傳送邀請給其他玩家 (流程圖)](/zh-TW/services/xbox-services/multiplayer/mpm/concepts/flowcharts/live-mpm-send-invites)。

### XBOX 平台邀請 TCUI <a id="xbox-platform-invite-tcui" />

呼叫 [XblMultiplayerManagerLobbySessionInviteFriends](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends) 以顯示標準 XBOX UI，玩家可在其中選取要邀請加入遊戲的好友或最近的玩家。
當玩家確認其選取項目後，多人遊戲管理員會將邀請傳送給選取的玩家。

#### 平面 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());
```

多人遊戲管理員會執行下列功能，以使用 XBOX 平台邀請 TCUI 邀請玩家。

* 顯示 XBOX 標準 TCUI。
* 直接將邀請傳送給選取的玩家。

### 遊戲實作的自訂 UI<a id="title-implemented-custom-ui" />

您的遊戲可以實作自訂 TCUI，用於檢視線上好友並邀請他們。
遊戲可以使用 [XblMultiplayerManagerLobbySessionInviteUsers](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers) 方法，將邀請傳送給由其 XBOX Live 使用者識別碼定義的一組人員。
如果您使用自己的遊戲內 UI 而非標準 XBOX UI，這會很有用。

#### 平面 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 時，多人遊戲管理員會直接將邀請傳送給選取的玩家。


## Related topics

- [多人遊戲管理員範例程式碼](/zh-TW/services/xbox-services/multiplayer/mpm/how-to/live-mm-howto-nav.md)
- [傳送邀請](/zh-TW/services/xbox-services/multiplayer/invites/how-to/live-invites-send.md)
- [邀請玩家加入遊戲工作階段](/zh-TW/services/xbox-services/multiplayer/invites/live-invites-nav.md)
- [多人遊戲管理員概觀](/zh-TW/services/xbox-services/multiplayer/mpm/live-multiplayer-manager-overview.md)
- [邀請概觀](/zh-TW/services/xbox-services/multiplayer/invites/live-multiplayer-invites-overview.md)