> ## 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 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

- [PAGE 指南 112 - 活动后](https://docs.xbox.com/zh-CN/build/game-principles/accessibility/page/page-112-post-event.md)
- [实时活动 (RTA) 服务（目录）](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/rta/live-rta-nav.md)
- [报告广告活动](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/client/advertising/report-ad-activity.md)
- [奖励广告活动](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/client/advertising/reward-ad-activity.md)
- [Game Saves 活动设备变更](https://docs.xbox.com/zh-CN/services/playfab/player-progression/game-saves/activedevicechanges.md)