Syntax
Members
totalMeasurementTimeoutInMilliseconds uint32_t
호스트 이름 확인 및 로컬 디바이스와 PlayFab Quality of Service 비컨 서버 간의 네트워킹 조건 측정 시도에 허용되는 최대 밀리초 수입니다.
이 값은 사용 가능한 모든 지역의 PlayFab Quality of Service 비컨 서버 호스트 이름을 확인하고 이들에 대한 연결 품질을 측정하기 위해 경량 메시지를 보내는 데 Party 라이브러리에 허용되는 최대 시간(밀리초)을 제어합니다. 환경적 문제로 인해 일부 지역의 이름 확인이 느리거나 지연 시간/패킷 손실이 크다면, 이 시간 제한 내에 최소 한 번은 성공적으로 연락된 지역만 PartyRegionsChangedStateChange 결과에 보고됩니다. 이 값은 Party 라이브러리가 PlayFab 서비스에서 사용 가능한 지역 목록을 검색하는 데 걸리는 시간을 포함하거나 이에 영향을 주지 않습니다.
애플리케이션은 일반적으로 기술적 가정에 기반한 어떤 숫자를 도출하려 하기보다는 사용자 경험 목표/최악의 경우 측면에서 이 시간 제한을 정의해야 합니다. 특정 지역 하나 또는 모든 지역을 측정하는 데 필요한 정확한 시간은 사용 가능한 지역 수, 현재 네트워킹 환경 조건, 관찰된 지연 시간에 따라 동적으로 조정된 Party 라이브러리의 시간 제한 등과 같은 요인에 따라 크게 달라질 수 있습니다.
이 값은 사실상 완전 또는 부분 실패를 경험하는 디바이스의 최악의 경우 시간 제한입니다. 이는 일반적인 성공 사례에 대한 실제 관찰과 비교하는 데 유용할 수 있습니다. 기본 PartyRegionQualityMeasurementConfiguration 값, 지역 가용성, 플레이어 사용 패턴을 사용할 때, Party 라이브러리는 현재 전 세계 대부분의 디바이스가 전체 측정 프로세스를 2.3초 이하로 성공적으로 완료하며, 97%의 디바이스가 6초 미만으로 성공적으로 완료함을 관찰하고 있습니다. 이 기간은 더 많은 지역이 도입됨에 따라 시간이 지남에 따라 약간 증가할 것으로 예상됩니다.
PartyOption::RegionQualityMeasurementConfiguration이 구성되지 않은 경우 기본값은 15000(15초)입니다.
값이 0이면 시간 제한이 없으므로, 지역이 성공하거나 실패하는 데 걸리는 시간에 관계없이 모든 측정이 완료될 수 있습니다. 그렇지 않으면 최솟값은 50밀리초입니다.
highLatencyHintInMilliseconds uint16_t
애플리케이션이 지역의 지연 시간이 너무 커서 상세 측정에 시간을 더 소비하지 않도록 판단하는 최대 지연 시간 임계값(밀리초)을 나타내는 힌트입니다.
이 대상 값은 지역 지연 시간에 대한 소프트 상한을 나타냅니다. 측정된 지연 시간이 더 높은 지역을 포함하는 것을 직접적으로 방지하지는 않지만, Party 라이브러리가 이 숫자보다 지연 시간이 적은 지역에 최적화된 시간 제한 및 재시도 값을 선택하도록 합니다. 최소 응답 수(minRequiredSuccessfulResponses 필드에 구성)를 받은 후 각 지역에 대해서도 검사됩니다. 지역의 측정된 지연 시간의 중앙값이 이 대상보다 크면, 이상적인 응답 수(idealNumberOfSuccessfulResponses 필드에 구성)가 사용되지 않고 더 이상 측정 시도가 전송되지 않습니다. 이 값은 0일 수 없습니다.
PartyOption::RegionQualityMeasurementConfiguration이 구성되지 않은 경우 기본값은 200입니다.
minRequiredSuccessfulResponses uint16_t
기본 평가를 위해 각 지역에 필요한 성공적인 측정 메시지 응답의 최소 수입니다.
품질 측정 경량 메시지 교환 중에 결과가 highLatencyHintInMilliseconds 필드 대상 지연 시간과 비교하여 평가할 만큼 정확한 것으로 간주되기 전에, 측정할 잠재적 지역은 최소 이만큼 성공적으로 응답할 것으로 예상됩니다. 더 큰 최소 요구 사항을 설정하면 더 많은 측정 샘플이 확보되어 이상치 패킷 변동에도 더 큰 일관성과 정확성을 얻지만, 완료하는 데 더 많은 시간이 걸립니다. 충분한 성공적인 응답이 없더라도, 특정 지역 측정은 다음 중 하나가 발생하면 완료된 것으로 간주됩니다. 성공적인 응답이 전혀 도착하지 않고 시도 횟수가 maxRetriesWithNoResponse 필드에 구성된 값을 초과한 경우, 하나 이상의 응답이 도착했고 시도 횟수가 maxTimeoutsAfterResponse 필드에 구성된 값을 초과한 경우, 또는 totalMeasurementTimeoutInMilliseconds 필드에 구성된 모든 지역의 전체 시간 제한이 경과한 경우입니다.
이 값은 0일 수 없습니다.
PartyOption::RegionQualityMeasurementConfiguration이 구성되지 않은 경우 기본값은 3입니다.
idealNumberOfSuccessfulResponses uint16_t
철저한 평가를 달성하기 위해 각 지역에 대해 원하는 성공적인 측정 메시지 응답의 수입니다.
이 값은 관심 지역에 대한 지연 시간 측정에서 원하는 정확도를 달성하기 위해 선호되는 총 성공 응답 수를 나타냅니다. 이 값은 minRequiredSuccessfulResponses 필드의 최솟값과 같거나 더 커야 합니다. Party 라이브러리는 지역이 highLatencyHintInMilliseconds 필드에 구성된 임계값 이하의 중앙값 지연 시간을 갖는 것으로 이미 측정된 경우에만 해당 지역에 대해 최솟값과 이 이상적인 값의 차이에 해당하는 추가 응답 수를 얻으려고 시도합니다. 이 필드의 이상적인 응답 수는 지연 시간이 더 높은 지역에 대해서는 그 추가 시간을 소비하지 않고 로컬 디바이스에 더 큰 가치가 있을 가능성이 있는 지역에 대한 측정 정확도를 계속해서 개선할 수 있게 합니다. 지역에 대한 최소 응답 수를 얻지 못한 경우, 이 추가 이상적 대상은 시도되지 않습니다. 그렇지 않으면, 지역에 대한 maxTimeoutsAfterResponse 제한에 도달하거나 모든 지역에 대한 전체 totalMeasurementTimeoutInMilliseconds 필드 시간 제한이 경과하면, 이 이상적인 성공 응답 수를 받지 못하더라도 해당 지역 측정이 완료된 것으로 간주됩니다.
PartyOption::RegionQualityMeasurementConfiguration이 구성되지 않은 경우 기본값은 4입니다.
maxRetriesWithNoResponse uint16_t
지역을 도달할 수 없는 것으로 간주하기 전에 응답 없이 지역에 초기 측정 메시지를 다시 보내는 추가 최대 횟수입니다.
이 값은 지역을 사용할 수 없는 것으로 간주하기 전에 지역에 대한 첫 번째 품질 측정 경량 메시지를 재시도할 때 Party 라이브러리가 첫 번째를 넘어 수행하는 추가 시도의 총 횟수를 구성합니다. 지역의 Quality of Service 비컨 서버로부터 하나 이상의 성공적인 응답을 받은 경우, 이 최댓값은 더 이상 사용되지 않으며 대신 maxTimeoutsAfterResponse 필드가 시간 초과가 허용되는 시도 횟수를 관리합니다. 더 큰 최대 재시도 값은 패킷 손실과 같은 일시적인 환경 문제에 더 관대하지만, 도달할 수 없는 지역을 포기하는 데 더 오래 걸립니다. 모든 지역 측정에 허용되는 절대 최대 시간은 별도의 totalMeasurementTimeoutInMilliseconds 필드 값에 의해 제한됩니다.
PartyOption::RegionQualityMeasurementConfiguration이 구성되지 않은 경우 기본값은 3입니다.
maxTimeoutsAfterResponse uint16_t
네트워킹 경로가 계속 측정하기에 너무 신뢰할 수 없다고 간주하기 전에 이전에 응답한 지역에 대해 시간 초과가 허용되는 측정 메시지 시도의 최대 횟수입니다.
지역의 Quality of Service 비컨 서버로부터 최소 하나 이상의 성공적인 응답을 받은 경우, 이 값은 해당 지역에 대해 minRequiredSuccessfulResponses 및 idealNumberOfSuccessfulResponses 측정 결과를 얻으려고 시도하는 동안 Party 라이브러리가 허용할 시간 초과된 시도의 총 횟수를 결정합니다. 더 큰 최대 시간 초과 값은 패킷 손실과 같은 일시적인 환경 문제에 더 관대하지만, 품질이 낮은 특성을 가진 지역 측정을 완료하는 데 잠재적으로 더 오래 걸릴 수 있습니다. 모든 지역 측정에 허용되는 절대 최대 시간은 별도의 totalMeasurementTimeoutInMilliseconds 필드 값에 의해 제한됩니다.
PartyOption::RegionQualityMeasurementConfiguration이 구성되지 않은 경우 기본값은 3입니다.
Remarks
이 구조체는 PartyOption::RegionQualityMeasurementConfiguration과 함께 사용하여 Party 라이브러리의 현재 구성을 각각 PartyManager::SetOption() 또는 PartyManager::GetOption()을 통해 재정의하거나 쿼리할 수 있습니다. PartyRegionsChangedStateChange 상태 변경과 관련된 지역 품질 측정 프로세스의 저수준 동작을 구성합니다.Requirements
Header: Party.h함께 보기
Party membersPartyOption::RegionQualityMeasurementConfiguration
PartyRegionsChangedStateChange
PartyManager::SetOption
PartyManager::GetOption