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

타이틀을 플레이하는 동안 플레이어의 활동에 대한 정보입니다.

## Syntax

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

### Members

*xuid*\
Type: uint64\_t

활동 정보가 속한 XBOX 사용자 ID입니다.

*connectionString*\
Type: const char\*

게임에 참여하기 위해 연결하는 클라이언트에 전달되는 연결 문자열입니다. 일반적으로 서버 IP 주소와 같은 정보를 포함합니다. 활동을 쿼리할 때 이 필드는 활동이 공개이거나 플레이어가 호출자를 팔로우하는 경우에만 채워집니다.

*joinRestriction*\
Type: [XblMultiplayerActivityJoinRestriction](/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction)

플레이어의 현재 활동에 참여할 수 있는 사람을 지정합니다.

*maxPlayers*\
Type: size\_t

플레이어의 현재 활동에 참여할 수 있는 최대 플레이어 수입니다. 값이 0이면 플레이어가 참여할 수 없음을 나타냅니다.

*currentPlayers*\
Type: size\_t

멀티플레이어 활동에서 플레이어와 이미 함께 플레이하고 있는 플레이어 수입니다. 값이 0이면 현재 다른 플레이어가 플레이하고 있지 않음을 나타냅니다.

*groupId*\
Type: const char\*

동일한 활동의 일부로 플레이하는 모든 사용자를 그룹화하는 고유 식별자입니다. 타이틀은 활동을 만들 때 이 식별자를 설정합니다.

*platform*\
Type: [XblMultiplayerActivityPlatform](/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform)

활동이 발생하는 플랫폼입니다. 활동을 설정할 때 플랫폼은 자동으로 유추되며 이 필드는 무시됩니다.

## Remarks

이 열거형이 어떻게 사용되는지 보려면 [멀티플레이어 활동 예제 코드](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to)의 [Activities](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#activities) 섹션에서 “Setting an activity” 및 “Getting activities”를 참조하세요.

## Argument of

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

## Requirements

**Header:** multiplayer\_activity\_c.h

## See also

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


## Related topics

- [XblMultiplayerActivityPlatform](/ko/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform.md)
- [XblMultiplayerActivityJoinRestriction](/ko/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction.md)
- [XblMultiplayerActivityGetActivityResult](/ko/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresult.md)
- [XblMultiplayerActivitySetActivityAsync](/ko/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitysetactivityasync.md)
- [Multiplayer Activity에 대한 예제 코드](/ko/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)