> ## 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 Activity (MPA) 機能の概要

> Multiplayer Activity がアクティビティ、招待、および最近のプレイヤーの XBOX 統合を簡素化し、プレイヤーのソーシャル グラフからの参加を可能にする方法の概要。

このトピックでは、Multiplayer Activity (MPA) 機能が、プレイヤー アクティビティ (参加)、招待、および最近のプレイヤーに関する XBOX services 統合をどのように簡素化するかを説明します。また、MPA は、タイトル自体が実行されていない場合でも、プレイヤーが自分のソーシャル グラフからゲームを起動できるようにします。

## 用語

MPA のコンテキストでは、以下の 4 つの用語が頻繁に使用されます。

* **接続文字列 (Connection string):** タイトルによってのみ作成され理解される文字列で、あるプレイヤーが別のプレイヤーに接続するために必要な情報を含みます。これは多くの場合、サーバーの IP アドレスを含みますが、タイトルに柔軟性を持たせるためにフリーフォーマットにされています。この文字列は MPA からは不透明で、プレイヤー同士が参加できるように、あるプレイヤーから別のプレイヤーへと単に渡されます。

* **アクティビティ (Activity):** プレイヤーがマルチプレイヤー体験中であることを示す広告を表します。これは接続文字列と、体験に参加できる相手を制限する少数のプロパティを含みます。アクティビティにより、シェルはこの情報 (参加可能性を含む) を表示できます。プレイヤーがマルチプレイヤー体験中は、常にアクティビティが存在する必要があります。

* **招待 (Invite):** プレイヤーがマルチプレイヤー体験に参加することを要求するものを表します。これにも接続文字列が含まれます。一般に、プレイヤーは他のプレイヤーに招待を送信する前に、アクティビティを作成しておく必要があります。

* **最近のプレイヤー (Recent player):** プレイヤーと意味のあるやり取りをした人物です。最近のプレイヤーは MPA によってリストに保存されます。プレイヤーは、これらを使用してフレンド関係を築いたり、メッセージや招待を送信したり、ゲーム終了後にフィードバックを報告したりできます。

## MPA の使用

### クライアント フロー

タイトルは、マルチプレイヤー体験を処理するために以下のフローを持つ必要があります。

1. プレイヤー A がマルチプレイヤー体験を開始または参加したとき、タイトルはこれを表すために [アクティビティを設定](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#setting-an-activity) する必要があります。
   * タイトルの他のプレイヤーおよび XBOX services は、[このアクティビティを取得](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#getting-an-activity) できます。プレイヤー A との関係に応じて、受信するアクティビティに接続文字列が含まれる場合があります。これを使用して、進行中のゲームに参加できます。
2. プレイヤー A は、他のプレイヤーに [招待](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#invites) を送信して、積極的にゲームへの参加を要求できます。
3. プレイヤーが参加および離脱すると、タイトルは更新された情報で [再度設定](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#setting-an-activity) することで、アクティビティのプレイヤー数を更新する必要があります。
4. タイトルは、意味のあるやり取りをした任意のプレイヤーで [プレイヤーの最近のプレイヤー リストを更新](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#updating-recent-players) する必要があります。
5. プレイヤー A がマルチプレイヤー体験を終了または離脱したとき、タイトルは [アクティビティを削除](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#deleting-an-activity) する必要があります。

### 外部サーバー フロー

サーバーは、前述の項目のいずれかをクライアントに代わって実行できます。加えて、サーバーは以下も実行できます。

* 最近のプレイヤーの [双方向リスト](/services/xbox-services/multiplayer/mpa/concepts/live-mpa-recent-players#Unidirectional-players-vs-Bidirectional-groups) を記録する。
* プレイヤーに代わって招待を送信する。
* 一度に 1 人ずつではなく、複数のプレイヤーのアクティビティを同時に取得する。

詳細については、[XBOX services RESTful リファレンス](/reference/live/rest/atoc-xboxlivews-reference) を参照してください。

## 関連項目

[アクティビティ](/services/xbox-services/multiplayer/mpa/concepts/live-mpa-activities)

[招待](/services/xbox-services/multiplayer/mpa/concepts/live-mpa-invites)

[最近のプレイヤー](/services/xbox-services/multiplayer/mpa/concepts/live-mpa-recent-players)


## Related topics

- [Multiplayer Activity (MPA) の概念](/ja-jp/services/xbox-services/multiplayer/mpa/concepts/live-mpa-concepts-nav.md)
- [Partner Center 機能の概要](/ja-jp/publishing/game-publishing/concepts/overview.md)
- [MPSD から PlayFab Multiplayer と MPA への移行](/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [ソーシャル機能の概要](/ja-jp/services/xbox-services/community/live-social-overview.md)
- [タイトル マネージド実績の概要](/ja-jp/services/xbox-services/player-data/achievements/title-managed/live-achievements-tm-overview.md)
