> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 を使用してフレンドとマルチプレイヤー ゲームをプレイできるようにする](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-friends.md) を参照してください。
[XblMultiplayerEventType](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype.md)`::UserAdded` イベントを受け取った後、招待の送信を開始できます。

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

* [XBOX プラットフォームの招待タイトル呼び出し可能 UI (TCUI)](#xbox-platform-invite-tcui)
* [タイトル実装のカスタム UI](#title-implemented-custom-ui)

このプロセスの詳細については、[他のプレイヤーに招待を送信する (フローチャート)](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpm/concepts/flowcharts/live-mpm-send-invites.md) を参照してください。

### XBOX プラットフォームの招待 TCUI 

[XblMultiplayerManagerLobbySessionInviteFriends](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends.md) を呼び出して、プレイヤーがゲームに招待するフレンドまたは最近のプレイヤーを選択できる、標準の 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

タイトルは、オンラインのフレンドを表示して招待するためのカスタム TCUI を実装できます。
ゲームは、[XblMultiplayerManagerLobbySessionInviteUsers](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md) メソッドを使用して、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 のサンプル コード](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpm/how-to/live-mm-howto-nav.md)
- [Multiplayer Manager の概要](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpm/live-multiplayer-manager-overview.md)
- [マルチプレイヤータスク](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [Multiplayer Manager で SmartMatch を使用してマルチプレイヤー ゲームを見つけられるようにする](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-matchmaking.md)
- [Multiplayer Activity のサンプル コード](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)