XblMultiplayerSessionProperties
이 세션과 연결된 속성 집합입니다. 모든 플레이어가 이러한 속성을 수정할 수 있습니다.Syntax
Members
KeywordsType: const char** 세션과 연결된 키워드 컬렉션입니다(선택 사항, 비어 있을 수 있음). KeywordCount
Type: size_t 키워드 수입니다. JoinRestriction
Type: XblMultiplayerSessionRestriction “open” 세션에 참여할 수 있는 사용자를 제한합니다. (예약에는 영향을 주지 않으므로 “private” 및 “visible” 세션에는 영향을 미치지 않습니다.) 기본값은 “none”입니다. “local”인 경우 토큰의 DeviceId가 이미 세션에 있고 “active”가 true인 다른 사용자와 일치하는 사용자만 참여할 수 있습니다. “followed”인 경우 로컬 사용자(위에서 정의됨)와 세션의 기존(예약된 것이 아닌) 멤버가 팔로우하는 사용자만 예약 없이 참여할 수 있습니다. ReadRestriction
Type: 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 호스트의 디바이스 토큰입니다. 하나 이상의 멤버의 “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로 설정합니다.