XblMultiplayerSessionConstants
멀티 플레이 세션에 대한 상수를 나타냅니다.
구문
typedef struct XblMultiplayerSessionConstants {
uint32_t MaxMembersInSession;
XblMultiplayerSessionVisibility Visibility;
uint64_t* InitiatorXuids;
size_t InitiatorXuidsCount;
const char* CustomJson;
const char* SessionCloudComputePackageConstantsJson;
uint64_t MemberReservedTimeout;
uint64_t MemberInactiveTimeout;
uint64_t MemberReadyTimeout;
uint64_t SessionEmptyTimeout;
uint64_t ArbitrationTimeout;
uint64_t ForfeitTimeout;
bool EnableMetricsLatency;
bool EnableMetricsBandwidthDown;
bool EnableMetricsBandwidthUp;
bool EnableMetricsCustom;
XblMultiplayerMemberInitialization* MemberInitialization;
XblMultiplayerPeerToPeerRequirements PeerToPeerRequirements;
XblMultiplayerPeerToHostRequirements PeerToHostRequirements;
const char* MeasurementServerAddressesJson;
bool ClientMatchmakingCapable;
XblMultiplayerSessionCapabilities SessionCapabilities;
} XblMultiplayerSessionConstants
멤버
MaxMembersInSession
형식: uint32_t
이 세션의 최대 멤버 수입니다.
가시성
형식: XblMultiplayerSessionVisibility
이 세션의 가시성입니다.
InitiatorXuids
형식: uint64_t*
세션을 시작한 사람을 나타내는 Xbox 사용자 ID의 컬렉션입니다. (선택 사항)
InitiatorXuidsCount
형식: size_t
InitiatorXuids 배열에 포함된 항목 수입니다.
CustomJson
형식: const char*
JSON 문자열에 지정된 세션에 대한 모든 사용자 지정 상수입니다. 세션을 만든 후에는 이러한 상수는 변경할 수 없습니다. (선택 사항)
SessionCloudComputePackageConstantsJson
형식: const char*
세션의 클라우드 컴퓨팅 패키지 상수로, JSON 문자열에 지정됩니다. 세션을 만든 후에는 이러한 상수는 변경할 수 없습니다. (선택 사항)
MemberReservedTimeout
형식: uint64_t
예약이 있는 멤버가 세션에 가입하는 최대 시간(밀리초)입니다. 회원이 이 시간 내에 참가하지 않으면 예약이 제거됩니다.
MemberInactiveTimeout
형식: uint64_t
비활성 멤버가 활성화되는 최대 시간(밀리초)입니다. 비활성 구성원이 이 시간 내에 활성화되지 않으면 멤버가 세션에서 제거됩니다.
MemberReadyTimeout
형식: uint64_t
활성 상태로 표시된 구성원의 최대 시간(밀리초)입니다. 멀티 플레이 게임을 시작하기 위해 셸이 타이틀을 실행할 때, 멤버가 준비 상태로 표시됩니다. 준비된 것으로 표시된 멤버가 이 시간 내에 활성화되지 않으면 해당 멤버가 비활성화됩니다.
SessionEmptyTimeout
형식: uint64_t
세션이 비어 있을 수 있는 최대 시간(밀리초)입니다. 이 시간 내에 세션에 참가하는 멤버가 없으면 세션이 삭제됩니다.
ArbitrationTimeout
형식: uint64_t
결과가 완료된 시간을 나타내는 시작 시간부터의 델타(밀리초)입니다. 현재 보고한 사용자(클라이언트 또는 서버)가 없는 경우 일치 결과가 불완전하다고 선언합니다. DEPRECATED. 이 멤버는 향후 릴리스에서 제거될 예정입니다.
ForfeitTimeout
형식: uint64_t
세션에 활성 사용자가 없는 경우 일치 항목이 취소되는 시간을 나타내는 시작 시간(밀리초)부터 델타입니다. DEPRECATED. 이 멤버는 향후 릴리스에서 제거될 예정입니다.
EnableMetricsLatency
형식: bool
True이면 제목에 연결 여부를 결정하는 데 도움이 되도록 측정된 지연 시간이 필요함을 나타냅니다. true가 되려면 capabilities.connectivity이(가) 필요합니다.
EnableMetricsBandwidthDown
형식: bool
true이면 제목에서 다운스트림(호스트-투-피어) 대역폭을 측정하여 연결을 확인함을 나타냅니다. true가 되려면 capabilities.connectivity이(가) 필요합니다.
EnableMetricsBandwidthUp
형식: bool
true이면 제목에서 업스트림(피어 투 호스트) 대역폭을 측정하여 연결을 확인함을 나타냅니다. true가 되려면 capabilities.connectivity이(가) 필요합니다.
EnableMetricsCustom
형식: bool
True이면 제목에 연결을 결정하는 데 도움이 되는 사용자 지정 측정이 필요함을 나타냅니다. true가 되려면 capabilities.connectivity이(가) 필요합니다.
MemberInitialization
형식: XblMultiplayerMemberInitialization*
설정된 경우 세션은 세션 생성 후 클라이언트 시스템 또는 제목이 초기화를 수행할 것으로 예상합니다. 시간 초과 및 초기화 단계는 메트릭이 설정된 경우 초기 QoS(서비스 품질) 측정을 포함하여 세션에 의해 자동으로 추적됩니다.
PeerToPeerRequirements
형식: XblMultiplayerPeerToPeerRequirements
세션 멤버 간 연결의 QoS 요구 사항을 나타냅니다.
PeerToHostRequirements
형식: XblMultiplayerPeerToHostRequirements
호스트 후보와 세션 구성원 간의 연결을 위한 QoS 요구 사항입니다.
MeasurementServerAddressesJson
형식: const char*
평가해야 하는 잠재적 서버 연결 문자열 집합입니다.
ClientMatchmakingCapable
형식: bool
매치 메이킹 상태 필드를 기록할 수 있는지 여부를 나타냅니다.
SessionCapabilities
형식: XblMultiplayerSessionCapabilities
세션의 기능입니다.
비고
세션 상수는 세션을 작성할 때만 작성자 또는 세션 템플릿에 의해 설정됩니다.
요구 사항
헤더: multiplayer_c.h