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

# XblMultiplayerSessionProperties

> XblMultiplayerSessionProperties

# XblMultiplayerSessionProperties

이 세션과 연결된 속성 집합입니다. 모든 플레이어가 이러한 속성을 수정할 수 있습니다.

## Syntax

```cpp theme={null}
typedef struct XblMultiplayerSessionProperties {  
    const char** Keywords;  
    size_t KeywordCount;  
    XblMultiplayerSessionRestriction JoinRestriction;  
    XblMultiplayerSessionRestriction ReadRestriction;  
    uint32_t* TurnCollection;  
    size_t TurnCollectionCount;  
    const char* MatchmakingTargetSessionConstantsJson;  
    const char* SessionCustomPropertiesJson;  
    const char* MatchmakingServerConnectionString;  
    const char** ServerConnectionStringCandidates;  
    size_t ServerConnectionStringCandidatesCount;  
    uint32_t* SessionOwnerMemberIds;  
    size_t SessionOwnerMemberIdsCount;  
    XblDeviceToken HostDeviceToken;  
    bool Closed;  
    bool Locked;  
    bool AllocateCloudCompute;  
    bool MatchmakingResubmit;  
} XblMultiplayerSessionProperties  
```

### Members

*Keywords*\
Type: const char\*\*

세션과 연결된 키워드 컬렉션입니다(선택 사항, 비어 있을 수 있음).

*KeywordCount*\
Type: size\_t

키워드 수입니다.

*JoinRestriction*\
Type: [XblMultiplayerSessionRestriction](/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionrestriction)

“open” 세션에 참여할 수 있는 사용자를 제한합니다. (예약에는 영향을 주지 않으므로 “private” 및 “visible” 세션에는 영향을 미치지 않습니다.) 기본값은 “none”입니다. “local”인 경우 토큰의 DeviceId가 이미 세션에 있고 “active”가 true인 다른 사용자와 일치하는 사용자만 참여할 수 있습니다. “followed”인 경우 로컬 사용자(위에서 정의됨)와 세션의 기존(예약된 것이 아닌) 멤버가 팔로우하는 사용자만 예약 없이 참여할 수 있습니다.

*ReadRestriction*\
Type: [XblMultiplayerSessionRestriction](/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionrestriction)

“open” 세션을 읽을 수 있는 사용자를 제한합니다. (예약에는 영향을 주지 않으므로 “private” 및 “visible” 세션에는 영향을 미치지 않습니다.) 기본값은 “none”입니다. “local”인 경우 토큰의 DeviceId가 이미 세션에 있고 “active”가 true인 다른 사용자와 일치하는 사용자만 읽을 수 있습니다. “followed”인 경우 로컬 사용자(위에서 정의됨)와 세션의 기존(예약된 것이 아닌) 멤버가 팔로우하는 사용자만 예약 없이 읽을 수 있습니다. 읽기 제한은 “open” 또는 “visible” 표시 유형이 있는 세션에 적용되며 초대 없이 세션을 읽을 수 있는 사용자를 결정합니다. 읽기 제한은 참여 제한만큼은 접근 가능해야 합니다. 즉, ‘readRestriction’도 설정하지 않고서는 ‘joinRestriction’을 “followed”로 설정할 수 없습니다.

*TurnCollection*\
Type: uint32\_t\*

차례가 누구의 것인지를 나타내는 세션 MemberId 컬렉션입니다.

*TurnCollectionCount*\
Type: size\_t

TurnCollection 배열의 항목 수입니다.

*MatchmakingTargetSessionConstantsJson*\
Type: const char\*

대상 세션 상수를 나타내는 JSON 문자열입니다.

*SessionCustomPropertiesJson*\
Type: const char\*

세션의 사용자 지정 속성을 지정하는 JSON 문자열입니다. 언제든지 변경할 수 있습니다. 변경할 때는 multiplayer\_service::write\_session을 호출하여 변경 내용을 서비스에 기록합니다.

*MatchmakingServerConnectionString*\
Type: const char\*

특정 연결 문자열이 사용되도록 강제합니다. 이는 진행 중인 세션 참여 시나리오에서 유용합니다.

*ServerConnectionStringCandidates*\
Type: const char\*\*

세션이 게임 서버에 연결하는 데 사용할 수 있는 연결 문자열의 순서가 지정된 목록입니다. 일반적으로 타이틀은 목록의 첫 번째 항목을 사용해야 하지만 정교한 타이틀은 다른 항목 중 하나를 선택하는 사용자 지정 메커니즘(예: 부하 기반)을 사용할 수 있습니다.

*ServerConnectionStringCandidatesCount*\
Type: size\_t

ServerConnectionStringCandidates 배열의 항목 수입니다.

*SessionOwnerMemberIds*\
Type: uint32\_t\*

세션 소유자의 세션 MemberId입니다.

*SessionOwnerMemberIdsCount*\
Type: size\_t

SessionOwnerMemberIds 배열의 항목 수입니다.

*HostDeviceToken*\
Type: [XblDeviceToken](/reference/live/xsapi-c/multiplayer_c/structs/xbldevicetoken)

호스트의 디바이스 토큰입니다. 하나 이상의 멤버의 “deviceToken”과 일치해야 하며, 그렇지 않으면 이 필드는 삭제됩니다. “peerToHostRequirements”가 설정되고 “host”가 설정된 경우, 측정 단계는 지정된 호스트가 올바른 호스트라고 가정하고 해당 호스트에 대한 메트릭만 측정합니다.

*Closed*\
Type: bool

표시 유형, 참여 제한, 세션의 사용 가능한 공간과 독립적으로 세션이 참여 가능한지 여부를 제어합니다. 예약에는 영향을 주지 않습니다. 기본값은 false입니다.

*Locked*\
Type: bool

true인 경우 세션 멤버를 잠글 수 있어, 사용자가 나가더라도 다시 세션에 들어올 수 있지만 다른 사용자는 그 자리를 차지할 수 없게 됩니다. 기본값은 false입니다.

*AllocateCloudCompute*\
Type: bool

클라이언트가 true로 설정하면 MPSD가 XBOX Live Compute 할당을 시도합니다. 기본값은 false입니다.

*MatchmakingResubmit*\
Type: bool

찾은 매치가 잘 성사되지 않아 다시 제출해야 하는 경우 true입니다. 매치가 성사되었으며 매치메이킹 서비스가 세션을 해제할 수 있음을 알리려면 false로 설정합니다.

## Requirements

**Header:** multiplayer\_c.h

## See also

[multiplayer\_c](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [Multiplayer 세션 고급 항목](/ko/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-details.md)
- [Multiplayer Session Directory 개요](/ko/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [XblMultiplayerSessionSessionProperties](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsessionproperties.md)
- [XblMultiplayerSessionPropertiesSetKeywords](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionpropertiessetkeywords.md)
- [XblMultiplayerSessionDeleteCustomPropertyJson](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessiondeletecustompropertyjson.md)