> ## 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.

# PartyRegionQualityMeasurementConfiguration

> Party 라이브러리가 지역 품질 측정 동작을 제어하는 데 사용하는 구성입니다.

Party 라이브러리가 지역 품질 측정 동작을 제어하는 데 사용하는 구성입니다.

## Syntax

```cpp theme={null}
struct PartyRegionQualityMeasurementConfiguration {  
    uint32_t totalMeasurementTimeoutInMilliseconds;  
    uint16_t highLatencyHintInMilliseconds;  
    uint16_t minRequiredSuccessfulResponses;  
    uint16_t idealNumberOfSuccessfulResponses;  
    uint16_t maxRetriesWithNoResponse;  
    uint16_t maxTimeoutsAfterResponse;  
}  
```

### Members

**`totalMeasurementTimeoutInMilliseconds`**   uint32\_t

호스트 이름 확인 및 로컬 디바이스와 PlayFab Quality of Service 비컨 서버 간의 네트워킹 조건 측정 시도에 허용되는 최대 밀리초 수입니다.

이 값은 사용 가능한 모든 지역의 PlayFab Quality of Service 비컨 서버 호스트 이름을 확인하고 이들에 대한 연결 품질을 측정하기 위해 경량 메시지를 보내는 데 Party 라이브러리에 허용되는 최대 시간(밀리초)을 제어합니다. 환경적 문제로 인해 일부 지역의 이름 확인이 느리거나 지연 시간/패킷 손실이 크다면, 이 시간 제한 내에 최소 한 번은 성공적으로 연락된 지역만 [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) 결과에 보고됩니다. <br /><br /> 이 값은 Party 라이브러리가 PlayFab 서비스에서 사용 가능한 지역 목록을 검색하는 데 걸리는 시간을 포함하거나 이에 영향을 주지 않습니다.   <br /><br /> 애플리케이션은 일반적으로 기술적 가정에 기반한 어떤 숫자를 도출하려 하기보다는 사용자 경험 목표/최악의 경우 측면에서 이 시간 제한을 정의해야 합니다. 특정 지역 하나 또는 모든 지역을 측정하는 데 필요한 정확한 시간은 사용 가능한 지역 수, 현재 네트워킹 환경 조건, 관찰된 지연 시간에 따라 동적으로 조정된 Party 라이브러리의 시간 제한 등과 같은 요인에 따라 크게 달라질 수 있습니다.   <br /><br /> 이 값은 사실상 완전 또는 부분 실패를 경험하는 디바이스의 최악의 경우 시간 제한입니다. 이는 일반적인 성공 사례에 대한 실제 관찰과 비교하는 데 유용할 수 있습니다. 기본 PartyRegionQualityMeasurementConfiguration 값, 지역 가용성, 플레이어 사용 패턴을 사용할 때, Party 라이브러리는 현재 전 세계 대부분의 디바이스가 전체 측정 프로세스를 2.3초 이하로 성공적으로 완료하며, 97%의 디바이스가 6초 미만으로 성공적으로 완료함을 관찰하고 있습니다. 이 기간은 더 많은 지역이 도입됨에 따라 시간이 지남에 따라 약간 증가할 것으로 예상됩니다.   <br /><br /> [PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)이 구성되지 않은 경우 기본값은 15000(15초)입니다.   <br /><br /> 값이 0이면 시간 제한이 없으므로, 지역이 성공하거나 실패하는 데 걸리는 시간에 관계없이 모든 측정이 완료될 수 있습니다. 그렇지 않으면 최솟값은 50밀리초입니다.

**`highLatencyHintInMilliseconds`**   uint16\_t

애플리케이션이 지역의 지연 시간이 너무 커서 상세 측정에 시간을 더 소비하지 않도록 판단하는 최대 지연 시간 임계값(밀리초)을 나타내는 힌트입니다.

이 대상 값은 지역 지연 시간에 대한 소프트 상한을 나타냅니다. 측정된 지연 시간이 더 높은 지역을 포함하는 것을 직접적으로 방지하지는 않지만, Party 라이브러리가 이 숫자보다 지연 시간이 적은 지역에 최적화된 시간 제한 및 재시도 값을 선택하도록 합니다. 최소 응답 수(*minRequiredSuccessfulResponses* 필드에 구성)를 받은 후 각 지역에 대해서도 검사됩니다. 지역의 측정된 지연 시간의 중앙값이 이 대상보다 크면, 이상적인 응답 수(*idealNumberOfSuccessfulResponses* 필드에 구성)가 사용되지 않고 더 이상 측정 시도가 전송되지 않습니다. <br /><br /> 이 값은 0일 수 없습니다.   <br /><br /> [PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)이 구성되지 않은 경우 기본값은 200입니다.

**`minRequiredSuccessfulResponses`**   uint16\_t

기본 평가를 위해 각 지역에 필요한 성공적인 측정 메시지 응답의 최소 수입니다.

품질 측정 경량 메시지 교환 중에 결과가 *highLatencyHintInMilliseconds* 필드 대상 지연 시간과 비교하여 평가할 만큼 정확한 것으로 간주되기 전에, 측정할 잠재적 지역은 최소 이만큼 성공적으로 응답할 것으로 예상됩니다. 더 큰 최소 요구 사항을 설정하면 더 많은 측정 샘플이 확보되어 이상치 패킷 변동에도 더 큰 일관성과 정확성을 얻지만, 완료하는 데 더 많은 시간이 걸립니다. <br /><br /> 충분한 성공적인 응답이 없더라도, 특정 지역 측정은 다음 중 하나가 발생하면 완료된 것으로 간주됩니다. 성공적인 응답이 전혀 도착하지 않고 시도 횟수가 *maxRetriesWithNoResponse* 필드에 구성된 값을 초과한 경우, 하나 이상의 응답이 도착했고 시도 횟수가 *maxTimeoutsAfterResponse* 필드에 구성된 값을 초과한 경우, 또는 *totalMeasurementTimeoutInMilliseconds* 필드에 구성된 모든 지역의 전체 시간 제한이 경과한 경우입니다.   <br /><br /> 이 값은 0일 수 없습니다.   <br /><br /> [PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)이 구성되지 않은 경우 기본값은 3입니다.   <br />
**`idealNumberOfSuccessfulResponses`**   uint16\_t

철저한 평가를 달성하기 위해 각 지역에 대해 원하는 성공적인 측정 메시지 응답의 수입니다.

이 값은 관심 지역에 대한 지연 시간 측정에서 원하는 정확도를 달성하기 위해 선호되는 총 성공 응답 수를 나타냅니다. 이 값은 *minRequiredSuccessfulResponses* 필드의 최솟값과 같거나 더 커야 합니다. Party 라이브러리는 지역이 *highLatencyHintInMilliseconds* 필드에 구성된 임계값 이하의 중앙값 지연 시간을 갖는 것으로 이미 측정된 경우에만 해당 지역에 대해 최솟값과 이 이상적인 값의 차이에 해당하는 추가 응답 수를 얻으려고 시도합니다. 이 필드의 이상적인 응답 수는 지연 시간이 더 높은 지역에 대해서는 그 추가 시간을 소비하지 않고 로컬 디바이스에 더 큰 가치가 있을 가능성이 있는 지역에 대한 측정 정확도를 계속해서 개선할 수 있게 합니다. <br /><br /> 지역에 대한 최소 응답 수를 얻지 못한 경우, 이 추가 이상적 대상은 시도되지 않습니다. 그렇지 않으면, 지역에 대한 *maxTimeoutsAfterResponse* 제한에 도달하거나 모든 지역에 대한 전체 *totalMeasurementTimeoutInMilliseconds* 필드 시간 제한이 경과하면, 이 이상적인 성공 응답 수를 받지 못하더라도 해당 지역 측정이 완료된 것으로 간주됩니다.   <br /><br /> [PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)이 구성되지 않은 경우 기본값은 4입니다.

**`maxRetriesWithNoResponse`**   uint16\_t

지역을 도달할 수 없는 것으로 간주하기 전에 응답 없이 지역에 초기 측정 메시지를 다시 보내는 추가 최대 횟수입니다.

이 값은 지역을 사용할 수 없는 것으로 간주하기 전에 지역에 대한 첫 번째 품질 측정 경량 메시지를 재시도할 때 Party 라이브러리가 첫 번째를 넘어 수행하는 추가 시도의 총 횟수를 구성합니다. 지역의 Quality of Service 비컨 서버로부터 하나 이상의 성공적인 응답을 받은 경우, 이 최댓값은 더 이상 사용되지 않으며 대신 *maxTimeoutsAfterResponse* 필드가 시간 초과가 허용되는 시도 횟수를 관리합니다. <br /><br /> 더 큰 최대 재시도 값은 패킷 손실과 같은 일시적인 환경 문제에 더 관대하지만, 도달할 수 없는 지역을 포기하는 데 더 오래 걸립니다. 모든 지역 측정에 허용되는 절대 최대 시간은 별도의 *totalMeasurementTimeoutInMilliseconds* 필드 값에 의해 제한됩니다.   <br /><br /> [PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)이 구성되지 않은 경우 기본값은 3입니다.

**`maxTimeoutsAfterResponse`**   uint16\_t

네트워킹 경로가 계속 측정하기에 너무 신뢰할 수 없다고 간주하기 전에 이전에 응답한 지역에 대해 시간 초과가 허용되는 측정 메시지 시도의 최대 횟수입니다.

지역의 Quality of Service 비컨 서버로부터 최소 하나 이상의 성공적인 응답을 받은 경우, 이 값은 해당 지역에 대해 *minRequiredSuccessfulResponses* 및 *idealNumberOfSuccessfulResponses* 측정 결과를 얻으려고 시도하는 동안 Party 라이브러리가 허용할 시간 초과된 시도의 총 횟수를 결정합니다. <br /><br /> 더 큰 최대 시간 초과 값은 패킷 손실과 같은 일시적인 환경 문제에 더 관대하지만, 품질이 낮은 특성을 가진 지역 측정을 완료하는 데 잠재적으로 더 오래 걸릴 수 있습니다. 모든 지역 측정에 허용되는 절대 최대 시간은 별도의 *totalMeasurementTimeoutInMilliseconds* 필드 값에 의해 제한됩니다.   <br /><br /> [PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)이 구성되지 않은 경우 기본값은 3입니다.

## Remarks

이 구조체는 [PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)과 함께 사용하여 Party 라이브러리의 현재 구성을 각각 [PartyManager::SetOption()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption) 또는 [PartyManager::GetOption()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)을 통해 재정의하거나 쿼리할 수 있습니다. [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) 상태 변경과 관련된 지역 품질 측정 프로세스의 저수준 동작을 구성합니다.

## Requirements

**Header:** Party.h

## 함께 보기

[Party members](/services/playfab/multiplayer/networking/reference/party_members)\
[PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)\
[PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)\
[PartyManager::SetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)\
[PartyManager::GetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)


## Related topics

- [PartyOption](/ko/services/playfab/multiplayer/networking/reference/enums/partyoption.md)
- [PartyRegionsChangedStateChange](/ko/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)
- [Party C/C++ API 개요](/ko/services/playfab/multiplayer/networking/reference/party_members.md)
- [PlayFab Party 릴리스 정보](/ko/services/playfab/multiplayer/networking/release-notes.md)
- [PartyManager::GetRegions](/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)