> ## 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 服务的玩家活动（加入）、邀请和最近玩家的集成。MPA 还使玩家可以从他们的社交图启动到您的游戏中，即使游戏本身没有运行。

## 术语

MPA 上下文中经常使用以下四个术语。

* **连接字符串：** 仅由游戏创建和理解的字符串，其中包含一位玩家连接到另一位玩家所需的信息。这通常包含服务器 IP 地址，但保留为自由形式以便游戏可以灵活使用。此字符串对 MPA 是不透明的 - 它只是将此字符串从一位玩家传递到另一位玩家，以便玩家可以互相加入。

* **活动：** 表示玩家处于多人游戏体验中的宣告。它包含连接字符串和一小组用于限制谁可以加入体验的属性。活动使 shell 能够显示此信息，包括其可加入性。当玩家处于多人游戏体验中时，应始终存在活动。

* **邀请：** 表示请求玩家加入多人游戏体验。它也包含连接字符串。一般来说，玩家应该在向其他玩家发送邀请之前创建活动。

* **最近玩家：** 与某位玩家有过有意义互动的人。最近玩家由 MPA 存储在列表中。玩家可以使用他们来建立好友关系、发送消息和邀请，或在游戏结束后报告反馈。

## 使用 MPA

### 客户端流程

游戏应具有以下用于处理多人游戏体验的流程。

1. 当玩家 A 开始或加入多人游戏体验时，游戏应[设置活动](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#setting-an-activity)以表示这一点。
   * 游戏中的其他玩家和 XBOX 服务可以[检索此活动](/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)。
* 代表玩家发送邀请。
* 同时检索多位玩家的活动，而不是一次一位。

有关更多信息，请参阅 [XBOX 服务 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)](/zh-CN/services/xbox-services/multiplayer/mpa/live-mpa-nav.md)
- [MPA](/zh-CN/services/xbox-services/multiplayer/mpa/index.md)
- [社交功能概述](/zh-CN/services/xbox-services/community/live-social-overview.md)
- [XBOX services 多人游戏概述](/zh-CN/services/xbox-services/multiplayer/overviews/live-multiplayer-intro.md)
- [Multiplayer Activity (MPA) 概念](/zh-CN/services/xbox-services/multiplayer/mpa/concepts/live-mpa-concepts-nav.md)