> ## 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 向其他 XBOX 玩家宣传可加入的多人游戏体验，包括活动字段、加入限制和玩家数量。

本主题介绍如何向其他玩家宣传可加入的多人游戏体验。他们随后可以加入这些体验。

## 使用活动

当玩家开始或加入多人游戏体验时，游戏应通过创建活动在 Multiplayer Activity (MPA) 中进行宣传。与基于会话的模型不同，活动是针对每位玩家的。每位玩家都应创建自己的活动，即使他们一起游戏。

游戏应在玩家进入多人游戏体验后立即创建此活动。在体验过程中，如果玩家数量增加或减少，游戏应修改活动。当玩家结束或离开多人游戏体验时，游戏应删除该活动。如果游戏崩溃或以其他方式未能删除活动，MPA 会在检测到玩家已停止游戏时尝试删除活动。如果活动在 24 小时内没有更新，它将被自动删除。

## 活动内容

活动包含下表所示的信息。

| 字段                 | 用途                                                      | 说明                                      |
| ------------------ | ------------------------------------------------------- | --------------------------------------- |
| `xuid`             | 创建活动的用户的 `XboxUserId`。                                  | 仅在查询活动时使用。玩家只能为自己设置活动。                  |
| `connectionString` | 由游戏定义的字符串，对 MPA 是不透明的。包含游戏可用于连接到另一位玩家的信息。               | 必须少于 512 个字符。                           |
| `joinRestriction`  | 表示谁可以在此活动中看到连接字符串。有关更多详细信息，请参阅本主题后面的"隐私"部分。             | 必须为 `Public`、`Followed` 或 `InviteOnly`。 |
| `maxPlayers`       | 此活动允许的最大玩家数。                                            | 可选。如果指定，其值必须大于 1 且小于等于 100。             |
| `currentPlayers`   | 此活动中的当前玩家数。                                             | 可选。如果指定，其值必须大于 0 且小于等于 100。             |
| `groupId`          | 由游戏定义的 ID。在 MPA 中，具有相同 `groupId` 的玩家被识别为一起游戏。           | 必须少于 128 个字符，且仅用于组身份标识。                 |
| `platform`         | 当设置为特定平台时，将通过邀请和加入的跨平台游玩限制为仅该平台。未设置时，将启用与所有已定义平台的跨平台游玩。 | 有关更多信息，请参阅本主题后面的"支持跨平台活动"部分。            |

## 隐私

游戏可能只希望允许其社交图中的一部分玩家加入。`joinRestriction` 字段决定其他玩家在查看此活动时是否会收到连接字符串。下表显示了这些值及其含义。

| 值            | 含义                        |
| ------------ | ------------------------- |
| `Public`     | 所有玩家都可以加入此活动。             |
| `Followed`   | 如果活动创建者关注了另一位玩家，则该玩家可以加入。 |
| `InviteOnly` | 除非玩家响应邀请，否则任何玩家都不能加入此活动。  |

## 支持跨平台活动

在 Microsoft Game Development Kit (GDK) 中创建活动时，游戏可以指定 `allowCrossplay` 标志。如果为 `false`，Microsoft Game Development Kit (GDK) 会自动将邀请的平台字段填充为当前平台。如果为 `true`，Microsoft Game Development Kit (GDK) 会将平台字段保留为 `null`，表示邀请是跨平台的。允许通过跨平台游玩的平台列表由游戏配置定义。在此场景中，主机世代被视为跨平台。

## 检索活动

在检索其他玩家的活动时，有时连接字符串会被隐藏。这表明该玩家不允许加入此活动。例如，连接字符串可能因活动的 `joinRestriction` 而被隐藏，或者活动已满。


## Related topics

- [与 PlayFab Lobby 和 Match 集成](/zh-CN/services/xbox-services/multiplayer/mpa/concepts/live-mpa-playfab-integration.md)
- [实时活动 (RTA) 服务](/zh-CN/services/xbox-services/fundamentals/rta/live-rta-nav.md)
- [Game Saves 活动设备变更](/zh-CN/services/playfab/player-progression/game-saves/activedevicechanges.md)
- [实时活动 (RTA) 服务概念](/zh-CN/services/xbox-services/fundamentals/rta/concepts/live-rta-concepts-nav.md)
- [实时活动服务概述](/zh-CN/services/xbox-services/fundamentals/rta/live-real-time-activity-service-overview.md)