> ## 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. # XblMultiplayerSessionMember > XblMultiplayerSessionMember # XblMultiplayerSessionMember 멀티플레이어 세션의 멤버에 대한 읽기 전용 참조를 나타냅니다. ## Syntax ```cpp theme={null} typedef struct XblMultiplayerSessionMember { uint32_t MemberId; const char* TeamId; const char* InitialTeam; XblTournamentArbitrationStatus ArbitrationStatus; uint64_t Xuid; const char* CustomConstantsJson; const char* SecureDeviceBaseAddress64; const XblMultiplayerSessionMemberRole* Roles; size_t RolesCount; const char* CustomPropertiesJson; char Gamertag[XBL_GAMERTAG_CHAR_SIZE]; XblMultiplayerSessionMemberStatus Status; bool IsTurnAvailable; bool IsCurrentUser; bool InitializeRequested; const char* MatchmakingResultServerMeasurementsJson; const char* ServerMeasurementsJson; const uint32_t* MembersInGroupIds; size_t MembersInGroupCount; const char* QosMeasurementsJson; XblDeviceToken DeviceToken; XblNetworkAddressTranslationSetting Nat; uint32_t ActiveTitleId; uint32_t InitializationEpisode; time_t JoinTime; XblMultiplayerMeasurementFailure InitializationFailureCause; const char** Groups; size_t GroupsCount; const char** Encounters; size_t EncountersCount; XblMultiplayerSessionReference TournamentTeamSessionReference; void* Internal; } XblMultiplayerSessionMember ``` ### Members *MemberId*\ Type: uint32\_t 이 멤버의 Id입니다. 이 멤버가 속한 세션의 컨텍스트 내에서 고유합니다. *TeamId*\ Type: const char\* 토너먼트에서 이 멤버 팀의 Id입니다. DEPRECATED. 향후 릴리스에서 제거됩니다. *InitialTeam*\ Type: const char\* SmartMatch의 초기 팀 할당입니다. *ArbitrationStatus*\ Type: [XblTournamentArbitrationStatus](/reference/live/xsapi-c/multiplayer_c/enums/xbltournamentarbitrationstatus) 토너먼트에서 멤버의 중재 상태입니다. DEPRECATED. 향후 릴리스에서 제거됩니다. *Xuid*\ Type: uint64\_t 멤버의 XBOX User ID입니다. 멤버가 수락한 경우에만 알 수 있습니다. *CustomConstantsJson*\ Type: const char\* 멤버의 사용자 지정 상수를 지정하는 JSON 문자열입니다. *SecureDeviceBaseAddress64*\ Type: const char\* 멤버의 base64로 인코딩된 보안 장치 주소입니다. (선택 사항) *Roles*\ Type: const [XblMultiplayerSessionMemberRole\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmemberrole) 이 멤버의 역할 배열입니다. (선택 사항) *RolesCount*\ Type: size\_t Roles 배열의 항목 수입니다. *CustomPropertiesJson*\ Type: const char\* 멤버의 사용자 지정 속성을 지정하는 JSON 문자열입니다. *Gamertag*\ Type: char\[XBL\_GAMERTAG\_CHAR\_SIZE] 멤버의 Gamertag입니다. (선택 사항) 멤버가 수락한 경우에만 알 수 있습니다. *Status*\ Type: [XblMultiplayerSessionMemberStatus](/reference/live/xsapi-c/multiplayer_c/enums/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](/reference/live/xsapi-c/multiplayer_c/structs/xbldevicetoken) 멤버가 보안 장치 주소를 업로드할 때 설정됩니다. 상등 비교에 사용할 수 있는 대/소문자를 구분하지 않는 문자열입니다. *Nat*\ Type: [XblNetworkAddressTranslationSetting](/reference/live/xsapi-c/multiplayer_c/enums/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](/reference/live/xsapi-c/multiplayer_c/enums/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](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference) 토너먼트 팀 세션 참조입니다. DEPRECATED. 향후 릴리스에서 제거됩니다. *Internal*\ Type: void\* 내부용으로만 사용됩니다. ## Requirements **Header:** multiplayer\_c.h ## See also [multiplayer\_c](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members) ## Related topics - [XblMultiplayerSessionMembers](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionmembers.md) - [XblMultiplayerSessionMemberStatus](/ko/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionmemberstatus.md) - [XblMultiplayerMeasurementFailure](/ko/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayermeasurementfailure.md) - [XblTournamentArbitrationStatus](/ko/reference/live/xsapi-c/multiplayer_c/enums/xbltournamentarbitrationstatus.md) - [XblNetworkAddressTranslationSetting](/ko/reference/live/xsapi-c/multiplayer_c/enums/xblnetworkaddresstranslationsetting.md)