> ## 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 使用者識別碼。

*connectionString*\
類型：const char\*

傳遞給連線用戶端以加入遊戲的連接字串；通常包含伺服器 IP 位址等資訊。查詢活動時，只有在活動為公開或玩家正在追蹤呼叫端時，才會填入此欄位。

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

指定可加入玩家目前活動的對象。

*maxPlayers*\
類型：size\_t

可加入玩家目前活動的最大玩家人數。值為 0 表示沒有玩家可以加入。

*currentPlayers*\
類型：size\_t

已在多人遊戲活動中與該玩家一起遊玩的玩家人數。值為 0 表示目前沒有其他玩家在遊玩。

*groupId*\
類型：const char\*

將屬於同一活動的所有遊玩使用者分組的唯一識別碼。遊戲會在建立活動時設定此識別碼。

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

進行活動的平台。設定活動時，會自動推斷平台；此欄位會被忽略。

## 備註

若要了解此列舉的使用方式，請參閱[多人遊戲活動的範例程式碼](/zh-TW/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to)中[活動](/zh-TW/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#activities)一節的「設定活動」和「取得活動」。

## 作為下列項目的引數

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

## 需求

**標頭：** multiplayer\_activity\_c.h

## 另請參閱

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


## Related topics

- [XblMultiplayerActivityInfo](/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)
- [XblMultiplayerActivityPlatform](/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform.md)