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

# XblMultiplayerActivityInfo

> XblMultiplayerActivityInfo

# XblMultiplayerActivityInfo

有关玩家在玩标题时活动的信息。

## 语法

```cpp theme={null}
typedef struct XblMultiplayerActivityInfo {  
    uint64_t xuid;  
    const char* connectionString;  
    XblMultiplayerActivityJoinRestriction joinRestriction;  
    size_t maxPlayers;  
    size_t currentPlayers;  
    const char* groupId;  
    XblMultiplayerActivityPlatform platform;  
} XblMultiplayerActivityInfo  
```

### 成员

*xuid*\
类型：uint64\_t

活动信息所属的 XBOX 用户 ID。

*connectionString*\
类型：const char\*

传递给正在连接的客户端以加入游戏的连接字符串；通常包含诸如服务器 IP 地址之类的信息。查询活动时，仅当活动是公开的或玩家正在关注调用方时，才会填充此字段。

*joinRestriction*\
类型：[XblMultiplayerActivityJoinRestriction](/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction)

指定可以加入玩家当前活动的对象。

*maxPlayers*\
类型：size\_t

可以加入玩家当前活动的最大玩家数。值为 0 表示没有玩家可以加入。

*currentPlayers*\
类型：size\_t

已与该玩家一起在多人游戏活动中游玩的玩家数量。值为 0 表示当前没有其他玩家在游玩。

*groupId*\
类型：const char\*

用于对作为同一活动一部分的所有用户进行分组的唯一标识符。标题在创建活动时设置此标识符。

*platform*\
类型：[XblMultiplayerActivityPlatform](/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform)

活动发生的平台。设置活动时，会自动推断平台；此字段将被忽略。

## 备注

若要了解如何使用此枚举，请参阅[多人游戏活动的示例代码](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to)的[活动](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#activities)部分中的“设置活动”和“获取活动”。

## 参数用途

[XblMultiplayerActivityGetActivityResult](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresult)\
[XblMultiplayerActivitySetActivityAsync](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitysetactivityasync)

## 要求

**头文件：** multiplayer\_activity\_c.h

## 另请参阅

[multiplayer\_activity\_c](/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members)


## Related topics

- [XblMultiplayerActivityPlatform](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform.md)
- [XblMultiplayerActivityJoinRestriction](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction.md)
- [XblMultiplayerActivityGetActivityResult](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresult.md)
- [XblMultiplayerActivitySetActivityAsync](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitysetactivityasync.md)
- [Multiplayer Activity 示例代码](/zh-CN/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)