Skip to main content

XblMultiplayerSessionMember

멀티플레이어 세션의 멤버에 대한 읽기 전용 참조를 나타냅니다.

Syntax

Members

MemberId
Type: uint32_t
이 멤버의 Id입니다. 이 멤버가 속한 세션의 컨텍스트 내에서 고유합니다. TeamId
Type: const char*
토너먼트에서 이 멤버 팀의 Id입니다. DEPRECATED. 향후 릴리스에서 제거됩니다. InitialTeam
Type: const char*
SmartMatch의 초기 팀 할당입니다. ArbitrationStatus
Type: XblTournamentArbitrationStatus
토너먼트에서 멤버의 중재 상태입니다. DEPRECATED. 향후 릴리스에서 제거됩니다. Xuid
Type: uint64_t
멤버의 XBOX User ID입니다. 멤버가 수락한 경우에만 알 수 있습니다. CustomConstantsJson
Type: const char*
멤버의 사용자 지정 상수를 지정하는 JSON 문자열입니다. SecureDeviceBaseAddress64
Type: const char*
멤버의 base64로 인코딩된 보안 장치 주소입니다. (선택 사항) Roles
Type: const XblMultiplayerSessionMemberRole*
이 멤버의 역할 배열입니다. (선택 사항) RolesCount
Type: size_t
Roles 배열의 항목 수입니다. CustomPropertiesJson
Type: const char*
멤버의 사용자 지정 속성을 지정하는 JSON 문자열입니다. Gamertag
Type: char[XBL_GAMERTAG_CHAR_SIZE]
멤버의 Gamertag입니다. (선택 사항) 멤버가 수락한 경우에만 알 수 있습니다. Status
Type: XblMultiplayerSessionMemberStatus
이 멤버의 상태입니다. IsTurnAvailable
Type: bool
이 멤버가 자기 차례를 준비한 경우에만 true입니다. IsCurrentUser
Type: bool
이 MultiplayerSessionMember가 현재 사용자에 대한 것인지 여부를 나타냅니다. InitializeRequested
Type: bool
이 사용자에 대해 QoS 초기화를 실행하도록 지시합니다. 기본값은 false입니다. 세션에 “memberInitialization” 섹션이 없는 경우 무시됩니다. MatchmakingResultServerMeasurementsJson
Type: const char*
매치가 세션에 사용자를 추가하면 사용자가 세션에 매치된 방법과 이유에 대한 컨텍스트를 제공할 수 있습니다. 이는 매치메이킹 세션에서 사용자의 serverMeasurements 사본입니다. ServerMeasurementsJson
Type: const char*
게임 서버 연결 문자열에 대한 QoS 측정값입니다. 모든 필드와 마찬가지로 “serverMeasurements”는 전체로 업데이트되어야 하므로 측정이 완료된 후 한 번만 설정해야 합니다. 비어 있으면 “serverMeasurementTimeout” 내에 아무 측정도 완료되지 않았음을 의미합니다. MembersInGroupIds
Type: const uint32_t*
내 그룹에 있는 memberIds의 컬렉션입니다. “initializationGroup” 목록이 설정된 경우, 멤버 자신의 인덱스는 아직 있지 않은 한 항상 추가됩니다. 관리형 초기화 중에 목록의 멤버 중 하나라도 실패하면 이 멤버도 실패합니다. MembersInGroupCount
Type: size_t
MembersInGroupIds 배열의 항목 수입니다. QosMeasurementsJson
Type: const char*
보안 장치 주소별 QoS 측정값입니다. 모든 필드와 마찬가지로 “measurements”는 전체로 업데이트되어야 합니다. 이는 증분식이 아니라 측정이 완료된 후 한 번 설정되어야 합니다. “measurements” 개체가 설정된 경우 멤버 자신의 주소에 대한 항목을 포함할 수 없습니다. DeviceToken
Type: XblDeviceToken
멤버가 보안 장치 주소를 업로드할 때 설정됩니다. 상등 비교에 사용할 수 있는 대/소문자를 구분하지 않는 문자열입니다. Nat
Type: XblNetworkAddressTranslationSetting
멤버가 보안 장치 주소를 업로드할 때의 장치 NAT 설정입니다. ActiveTitleId
Type: uint32_t
멤버가 활성 상태인 경우, 활성 상태인 타이틀 ID입니다. InitializationEpisode
Type: uint32_t
이 값은 타이틀이 자체 QoS를 수동으로 관리할 때만 읽기에 유용합니다. “memberInitialization” 섹션이 설정되고 멤버가 “initialize”:true로 추가된 경우 멤버가 참여할 초기화 에피소드로 설정되며, 그렇지 않은 경우 0입니다. 사용자는 일괄로 세션에 참여합니다. 초기화 에피소드 번호는 QoS를 수행해야 하는 사용자 집합을 나타냅니다. 초기화 에피소드 1은 생성 시 새 세션에 추가된 멤버에 사용되는 특수 값입니다. JoinTime
Type: time_t
사용자가 세션에 참여한 시간입니다. “reserved”가 true인 경우 이는 예약이 이루어진 시간입니다. InitializationFailureCause
Type: XblMultiplayerMeasurementFailure
초기화가 실패한 이유이거나, 실패가 없는 경우 XblMultiplayerMeasurementFailure::None입니다. 이 멤버가 통과하지 못하면 “joining” 또는 “measuring” 단계를 벗어날 때 설정됩니다. Groups
Type: const char**
현재 사용자가 멀티플레이어 세션 중에 어떤 그룹의 일부였는지를 나타내는 그룹 이름의 배열입니다. GroupsCount
Type: size_t
Groups 배열의 항목 수입니다. Encounters
Type: const char**
현재 사용자가 멀티플레이어 세션 중에 어떤 그룹을 만났는지를 나타내는 그룹 이름 목록을 가져옵니다. EncountersCount
Type: size_t
Groups 배열의 항목 수입니다. TournamentTeamSessionReference
Type: XblMultiplayerSessionReference
토너먼트 팀 세션 참조입니다. DEPRECATED. 향후 릴리스에서 제거됩니다. Internal
Type: void*
내부용으로만 사용됩니다.

Requirements

Header: multiplayer_c.h

See also

multiplayer_c
마지막 수정일 2026년 8월 24일