> ## 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` イベントを受け取った後、招待の送信を開始できます。

招待は 2 つの方法で送信できます。

* [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 は選択されたプレイヤーに招待を送信します。

#### フラット 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 を使用する場合に便利です。

#### フラット 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

- [Multiplayer Manager のサンプル コード](/ja-jp/services/xbox-services/multiplayer/mpm/how-to/live-mm-howto-nav.md)
- [Multiplayer Manager の概要](/ja-jp/services/xbox-services/multiplayer/mpm/live-multiplayer-manager-overview.md)
- [マルチプレイヤータスク](/ja-jp/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [Multiplayer Activity のサンプル コード](/ja-jp/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)
- [他のプレイヤーに招待を送信する (フローチャート)](/ja-jp/services/xbox-services/multiplayer/mpm/concepts/flowcharts/live-mpm-send-invites.md)