> ## 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.
# PartyOption
> Party 라이브러리 기능을 미세 조정하기 위해 설정할 수 있는 추가 옵션입니다.
Party 라이브러리 기능을 미세 조정하기 위해 설정할 수 있는 추가 옵션입니다.
## Syntax
```cpp theme={null}
enum class PartyOption : uint32_t
{
LocalUdpSocketBindAddress = 0,
LocalDeviceDirectPeerConnectivityOptionsMask = 1,
TextChatFilterLevel = 2,
LocalDeviceMaxDirectPeerConnections = 3,
RegionUpdateConfiguration = 4,
RegionQualityMeasurementConfiguration = 5,
}
```
## Constants
| Constant | Description | | |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| LocalUdpSocketBindAddress | Party 라이브러리가 UDP 소켓에 바인딩하는 방식을 구성하는 데 사용되는 옵션입니다.
이 옵션을 재정의하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 [PartyLocalUdpSocketBindAddressConfiguration](/services/playfab/multiplayer/networking/reference/structs/partylocaludpsocketbindaddressconfiguration) 구조체에 대한 선택적 포인터를 전달하여 [PartyManager::SetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)을 호출하세요. null PartyLocalUdpSocketBindAddressConfiguration 포인터가 제공되면 기본 구성이 복원됩니다.
이 옵션을 쿼리하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 출력 PartyLocalUdpSocketBindAddressConfiguration 구조체에 대한 포인터를 전달하여 [PartyManager::GetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)을 호출하세요.
Party 라이브러리를 초기화하기 전에 이 옵션을 재정의하거나 쿼리하는 것이 안전하며 권장됩니다. 로컬 UDP 소켓 바인딩 주소 구성을 재정의하면 Party 라이브러리가 다음에 초기화될 때 적용됩니다. 이미 초기화된 Party 라이브러리 소켓 바인딩은 수정하지 않습니다. 마찬가지로 쿼리는 이미 초기화된 경우 활발히 사용 중인 값이 아니라 다음 Party 라이브러리 초기화에 사용될 구성을 검색합니다. | | |
| LocalDeviceDirectPeerConnectivityOptionsMask | 이러한 연결 시도를 허용하는 네트워크에서 로컬 디바이스와 다른 디바이스 간의 허용된 직접 피어 연결을 제한하기 위한 옵션입니다.
[PartyDirectPeerConnectivityOptions::None](/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions) 이외의 값으로 설정된 [PartyNetworkConfiguration::directPeerConnectivityOptions](/services/playfab/multiplayer/networking/reference/structs/partynetworkconfiguration) 필드가 있는 네트워크로 초기 로컬 사용자를 성공적으로 인증하거나, 원격 디바이스가 그러한 네트워크로 인증하는 경우 이 로컬 디바이스와 네트워크의 원격 디바이스 간에 직접 피어 연결이 시도될 수 있습니다. 이 옵션으로 구성된 플래그를 사용하여 이러한 시도에 로컬 디바이스를 참여시킬 수 있는 특정 유형의 원격 디바이스를 추가로 제한할 수 있습니다. 모든 플래그는 비트 AND 연산을 사용하여 평가됩니다. 즉, 특정 플래그는 네트워크의 [PartyNetworkConfiguration](/services/playfab/multiplayer/networking/reference/structs/partynetworkconfiguration) 구조체와 *양쪽* 디바이스의 각 로컬 마스크 옵션 세 곳에서 모두 활성화된 경우에만 특정 네트워크의 디바이스 쌍에 대해 실제로 유효합니다. Party 네트워크가 관련 형식의 직접 피어 연결을 허용하더라도, 어느 디바이스든 이 옵션을 재정의할 때 플래그를 활성화하지 않음으로써 IP 주소 공개 및 그들 간의 직접 연결 시도를 일방적으로 옵트아웃할 수 있습니다.
직접 피어 연결은 라이브러리의 Windows, Microsoft Game Core, PlayStation®, Switch, Linux, macOS 버전에서 지원됩니다. 이러한 플랫폼에서, 아직 설정되지 않은 경우 로컬 디바이스 마스크의 기본값은 \`\`\`PartyDirectPeerConnectivityOptions::AnyPlatformType | PartyDirectPeerConnectivityOptions::AnyEntityLoginProvider | PartyDirectPeerConnectivityOptions::OnlyServers`입니다. 이는 이러한 디바이스가 명시적으로 덜 관대하도록 재정의될 때까지 네트워크의 [PartyNetworkConfiguration](/services/playfab/multiplayer/networking/reference/structs/partynetworkconfiguration)에서 허용하는 직접 피어 연결을 제한하지 않음을 의미합니다. 라이브러리의 다른 모든 버전에서 로컬 디바이스 마스크의 기본값은 `PartyDirectPeerConnectivityOptions::None\`\`\`이며 변경할 수 없습니다. [PartyManager::SetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)을 통해 변경하려고 시도하면 실패합니다. 이는 이러한 디바이스가 직접 피어 연결을 절대 시도하지 않음을 의미합니다.
이 옵션을 재정의하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 원하는 모든 옵션 플래그를 포함하는 [PartyDirectPeerConnectivityOptions](/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions) 변수에 대한 선택적 포인터를 전달하여 [PartyManager::SetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)을 호출하세요. null PartyDirectPeerConnectivityOptions 포인터가 제공되면 기본 옵션이 복원됩니다.
이 옵션을 쿼리하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 현재 구성된 옵션 플래그를 기록할 [PartyDirectPeerConnectivityOptions](/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions) 변수에 대한 포인터를 전달하여 [PartyManager::GetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)을 호출하세요.
어떤 네트워크에도 연결되어 있지 않을 때 이 옵션을 재정의하거나 쿼리하는 것이 좋습니다. 구성된 값은 이 디바이스가 다음에 초기 사용자를 새 네트워크에 인증할 때 적용됩니다. 기존 네트워크에 참여하는 데 이미 사용된 설정을 변경하지 않습니다. 마찬가지로 쿼리는 기존 네트워크에서 사용된 값이 아니라 향후 네트워크에서 사용될 현재 구성된 값을 검색합니다.
Party 라이브러리를 초기화하기 전에 이 옵션을 재정의하거나 쿼리하는 것도 안전합니다. |
| TextChatFilterLevel | 채팅 텍스트가 필터링될 수준을 미세 조정하는 옵션입니다.
이 기능은 영어로 감지된 수신 채팅 텍스트에만 적용됩니다. 다른 언어에 대해서는 필터 수준을 변경할 수 없습니다.
필터 수준은 클라이언트의 모든 로컬 채팅 컨트롤에 대한 수신 채팅 텍스트에 적용됩니다. 채팅 텍스트에 영향을 미치려면 하나 이상의 로컬 채팅 컨트롤에 대해 [PartyLocalChatControl::SetTextChatOptions](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions)로 필터링을 활성화해야 합니다.
이 옵션을 재정의하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 원하는 필터 수준을 포함하는 [PartyTextChatFilterLevel](/services/playfab/multiplayer/networking/reference/enums/partytextchatfilterlevel) 변수에 대한 선택적 포인터를 전달하여 [PartyManager::SetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)을 호출하세요. null PartyTextChatFilterLevel 포인터가 제공되면 기본 수준이 복원됩니다.
이 옵션을 쿼리하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 현재 구성된 필터 수준을 기록할 [PartyTextChatFilterLevel](/services/playfab/multiplayer/networking/reference/enums/partytextchatfilterlevel) 변수에 대한 포인터를 전달하여 [PartyManager::GetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)을 호출하세요.
Party 라이브러리를 초기화하기 전을 포함하여 언제든지 이 옵션을 재정의하거나 쿼리하는 것이 안전합니다. 새 값을 설정하면 즉시 적용됩니다. | | |
| LocalDeviceMaxDirectPeerConnections | 이 디바이스가 다른 디바이스에 대해 설정하려고 시도하는 최대 직접 피어 연결 수를 구성하는 옵션입니다.
[PartyDirectPeerConnectivityOptions::None](/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions) 이외의 값으로 설정된 [PartyNetworkConfiguration::directPeerConnectivityOptions](/services/playfab/multiplayer/networking/reference/structs/partynetworkconfiguration) 필드가 있는 네트워크로 초기 로컬 사용자를 성공적으로 인증할 때, 디바이스는 서로 직접 피어 연결을 시도할 수 있습니다. 과도한 리소스 소비를 방지하기 위해 Party 라이브러리는 현재 참여 중인 모든 네트워크에서 특정 디바이스가 이 최댓값보다 더 많은 직접 피어 연결을 설정하려고 시도하는 것을 내부적으로 방지합니다. 이는 더 많은 원격 디바이스가 있는 대규모 또는 여러 네트워크에 참여하는 디바이스의 능력에는 영향을 주지 않으며, 단순히 디바이스 간의 엔드포인트 메시지와 채팅 데이터가 투명 클라우드 릴레이 서버가 아닌 해당 직접 연결을 사용하여 전송될 기회의 수를 정의합니다.
[PartyNetwork::GetDeviceConnectionType()](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_getdeviceconnectiontype)을 호출하여 로컬 디바이스가 네트워크의 특정 원격 디바이스에 실제로 직접 피어 투 피어 연결을 설정했는지 확인할 수 있습니다.
이 옵션의 기본값은 `c_maxDirectPeerConnectionsPerDevice`이지만, 기본 설정을 사용하는 경우 이 값은 PlayFab 엔터티 유형이 `title_player_account`인 로컬 사용자를 인증할 때만 적용됩니다. 대신 기본 옵션 구성으로 PlayFab 엔터티 유형이 `game_server`인 로컬 사용자를 인증하는 경우, 최대 직접 피어 연결 수가 없습니다.
PlayFab 엔터티 유형에 관계없이 이 값을 재정의하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 uint32\_t 변수에 대한 선택적 포인터를 전달하여 [PartyManager::SetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)을 호출하세요. null uint32\_t 포인터가 제공되면 기본값과 동작이 복원됩니다.
이 옵션을 쿼리하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 현재 구성된 값을 기록할 uint32\_t 변수에 대한 포인터를 전달하여 [PartyManager::GetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)을 호출하세요.
Party 라이브러리를 초기화하기 전을 포함하여 언제든지 이 옵션을 재정의하거나 쿼리하는 것이 안전합니다. 새 값을 설정하면 값이 변경된 후 조인된 모든 네트워크에 대해 적용됩니다. | | |
| RegionUpdateConfiguration | Party 라이브러리가 자동 지역 검색 및 연결 품질 측정 업데이트를 수행하는 시기를 구성하는 데 사용되는 옵션입니다.
이 옵션을 재정의하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 [PartyRegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration) 구조체에 대한 선택적 포인터를 전달하여 [PartyManager::SetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)을 호출하세요. null PartyRegionUpdateConfiguration 포인터가 제공되면 기본 구성이 복원됩니다.
이 옵션을 쿼리하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 출력 [PartyRegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration) 구조체에 대한 포인터를 전달하여 [PartyManager::GetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)을 호출하세요.
Party 라이브러리를 초기화하기 전을 포함하여 언제든지 이 옵션을 재정의하거나 쿼리하는 것이 안전합니다. 지역 업데이트 구성을 재정의하면 즉시 적용됩니다. | | |
| RegionQualityMeasurementConfiguration | Party 라이브러리 지역 품질 측정 동작에 대한 세분화된 제어에 사용되는 옵션입니다.
이 옵션을 재정의하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 [PartyRegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration) 구조체에 대한 선택적 포인터를 전달하여 [PartyManager::SetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)을 호출하세요. null PartyRegionQualityMeasurementConfiguration 포인터가 제공되면 기본 구성이 복원됩니다.
이 옵션을 쿼리하려면 object 매개 변수에 null을, option 매개 변수에 이 값을, value에는 출력 [PartyRegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration) 구조체에 대한 포인터를 전달하여 [PartyManager::GetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)을 호출하세요.
Party 라이브러리를 초기화하기 전을 포함하여 언제든지 이 옵션을 재정의하거나 쿼리하는 것이 안전합니다. 지역 품질 측정 구성을 재정의하면 다음 지역 업데이트에 적용됩니다. | | |
## Requirements
**Header:** Party.h
## See also
[Party members](/services/playfab/multiplayer/networking/reference/party_members)\
[PartyManager::SetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)\
[PartyManager::GetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)\
[PartyLocalUdpSocketBindAddressConfiguration](/services/playfab/multiplayer/networking/reference/structs/partylocaludpsocketbindaddressconfiguration)\
[PartyNetworkConfiguration](/services/playfab/multiplayer/networking/reference/structs/partynetworkconfiguration)\
[PartyDirectPeerConnectivityOptions](/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions)\
[PartyRegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration)\
[PartyRegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration)
## Related topics
- [PartyManager::SetOption](/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md)
- [PartyManager::GetOption](/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md)
- [PartyDirectPeerConnectivityOptions](/ko/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions.md)
- [PlayFab Party 릴리스 정보](/ko/services/playfab/multiplayer/networking/release-notes.md)
- [PartyRegionUpdateConfiguration](/ko/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)