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