다음을 통해 공유

PartyOption

  • 아티클

파티 라이브러리 기능을 미세 조정하도록 설정할 수 있는 추가 옵션입니다.

구문

enum class PartyOption  : uint32_t  
{  
    LocalUdpSocketBindAddress = 0,  
    LocalDeviceDirectPeerConnectivityOptionsMask = 1,  
    TextChatFilterLevel = 2,  
    LocalDeviceMaxDirectPeerConnections = 3,  
    RegionUpdateConfiguration = 4,  
    RegionQualityMeasurementConfiguration = 5,  
}

상수

상수 설명
LocalUdpSocketBindAddress 파티 라이브러리를 UDP 소켓에 바인딩하는 방법을 구성하는 데 사용되는 옵션입니다.

이 옵션을 재정의하려면 개체 매개 변수에 null을 전달하고, 옵션 매개 변수에 대해 이 값을 전달하고, PartyLocalUdpSocketBindAddressConfiguration 구조에 대한 선택적 포인터를 값으로 전달하는 PartyManager::SetOption을 호출합니다. null PartyLocalUdpSocketBindAddressConfiguration 포인터가 제공되면 기본 구성이 복원됩니다.

이 옵션을 쿼리하려면 개체 매개 변수에 null을 전달하고, 옵션 매개 변수에 대해 이 값을 전달하고, 출력 PartyLocalUdpSocketBindAddressConfiguration 구조에 대한 선택적 포인터를 값으로 전달하여 PartyManager::GetOption을 호출합니다.

파티 라이브러리를 초기화하기 전에 이 옵션을 재정의하거나 쿼리하는 것이 좋습니다. 로컬 UDP 소켓 바인딩 주소 구성 재정의는 다음에 파티 라이브러리를 초기화할 때 적용됩니다. 이미 초기화된 파티 라이브러리 소켓 바인딩은 수정되지 않습니다. 마찬가지로 쿼리에서는 현재 사용 중인 값(이미 초기화된 경우)이 아니라 다음 파티 라이브러리 초기화에 사용할 구성을 검색합니다.
LocalDeviceDirectPeerConnectivityOptionsMask 로컬 디바이스와 이러한 연결을 시도할 수 있는 네트워크의 다른 디바이스 간에 허용되는 직접 피어 연결을 제한하는 옵션입니다.

PartyNetworkConfiguration::d irectPeerConnectivityOptions 필드가 PartyDirectPeerConnectivityOptions::None이외의 값으로 설정된 네트워크에 초기 로컬 사용자를 인증하는 경우 또는 원격 디바이스가 이러한 네트워크에 인증하는 경우 이 로컬 디바이스와 네트워크의 원격 디바이스 간에 직접 피어 연결을 시도할 수 있습니다. 이 옵션으로 구성된 플래그를 사용하여 이러한 시도에 로컬 디바이스를 포함하도록 허용된 특정 유형의 원격 디바이스를 추가로 제한할 수 있습니다. 모든 플래그는 비트 AND 연산을 사용하여 평가됩니다. 즉, 특정 플래그는 세 위치(네트워크의 PartyNetworkConfiguration 구조와 두 디바이스의 해당 로컬 마스크 옵션)에서 사용하도록 설정된 경우 지정된 네트워크의 디바이스 쌍에만 실제로 적용됩니다. 파티 네트워크에서 관련 양식의 직접 피어 연결을 허용하는 경우에도 디바이스는 이 옵션을 재정의할 때 플래그를 사용하도록 설정하지 않음으로써 상호 간 IP 주소 공개 및 직접 연결 시도를 옵트아웃할 수 있습니다.

직접 피어 연결은 Windows, Microsoft Game Core, PlayStation®, Switch, Linux 및 macOS 버전의 라이브러리에서 지원됩니다. 이러한 플랫폼에서 아직 설정되지 않은 경우 로컬 디바이스 마스크의 기본값은 PartyDirectPeerConnectivityOptions::AnyPlatformType | PartyDirectPeerConnectivityOptions::AnyEntityLoginProvider | PartyDirectPeerConnectivityOptions::OnlyServers입니다. 즉, 디바이스에서는 명시적으로 덜 허용되도록 재정의될 때까지 네트워크의 PartyNetworkConfiguration에 허용된 직접 피어 연결을 제한하지 않습니다. 다른 모든 라이브러리 버전의 경우 로컬 디바이스 마스크의 기본값은 PartyDirectPeerConnectivityOptions::None이고 변경할 수 없습니다. PartyManager::SetOption을 통해 변경하려고 하면 실패합니다. 즉, 디바이스에서 직접 피어 연결을 시도하지 않습니다.

이 옵션을 재정의하려면 개체 매개 변수에 null을 전달하고, 옵션 매개 변수에 대해 이 값을 전달하고, 모든 원하는 옵션 플래그가 포함된 PartyDirectPeerConnectivityOptions 변수에 대한 선택적 포인터를 전달하는 PartyManager::SetOption을 호출합니다. null PartyDirectPeerConnectivityOptions 포인터가 제공되면 기본 옵션이 복원됩니다.

이 옵션을 쿼리하려면 개체 매개 변수에 null을 전달하고, 옵션 매개 변수에 대해 이 값을 전달하고, 현재 구성된 옵션 플래그를 기록할 PartyDirectPeerConnectivityOptions 변수에 대한 포인터를 전달하여 PartyManager::GetOption을 호출합니다.

네트워크에 연결되지 않은 상태에서 이 옵션을 재정의하거나 쿼리하는 것이 좋습니다. 구성된 값은 다음에 이 디바이스에서 초기 사용자를 새 네트워크에 인증할 때 적용됩니다. 기존 네트워크에 참여하는 데 이미 사용 중인 설정은 변경되지 않습니다. 마찬가지로 쿼리는 기존 네트워크에 사용되는 값이 아니라 향후 네트워크에서 사용할 현재 구성된 값을 검색합니다.

파티 라이브러리를 초기화하기 전에 이 옵션을 재정의하거나 쿼리하는 것이 안전합니다.
TextChatFilterLevel 채팅 문자가 필터링되는 수준을 미세 조정하는 옵션입니다.

이 기능은 영어로 검색된 들어오는 채팅 문자에만 적용됩니다. 다른 언어에 대한 필터 수준을 변경할 수 없습니다.

필터 수준은 클라이언트의 모든 로컬 채팅 컨트롤에 대해 들어오는 채팅 문자에 적용됩니다. 이를 채팅 문자에 적용하려면 하나 이상의 로컬 채팅 컨트롤에 대해 PartyLocalChatControl::SetTextChatOptions를 통해 필터링을 사용하도록 설정해야 합니다.

이 옵션을 재정의하려면 개체 매개 변수에 null을 전달하고, 옵션 매개 변수에 대해 이 값을 전달하고, 원하는 필터 수준이 포함된 PartyTextChatFilterLevel 변수에 대한 선택적 포인터를 전달하여 PartyManager::SetOption을 호출합니다. null PartyTextChatFilterLevel 포인터가 제공되면 기본 수준이 복원됩니다.

이 옵션을 쿼리하려면 개체 매개 변수에 null을 전달하고, 옵션 매개 변수에 대해 이 값을 전달하고, 현재 구성된 필터 수준을 기록할 PartyTextChatFilterLevel 변수에 대한 포인터를 전달하여 PartyManager::GetOption을 호출합니다.

파티 라이브러리를 초기화하기 전을 포함하여 언제든지 이 옵션을 재정의하거나 쿼리하는 것이 안전합니다. 새 값을 설정하면 즉시 적용됩니다.
LocalDeviceMaxDirectPeerConnections 이 장치가 다른 장치에 설정하려고 시도하는 최대 직접 피어 연결 수를 구성하는 옵션입니다.

PartyNetworkConfiguration::directPeerConnectivityOptions 필드가 PartyDirectPeerConnectivityOptions::None 이외의 값으로 설정된 네트워크에 초기 로컬 사용자를 성공적으로 인증하면 장치가 서로 직접 피어 연결을 시도할 수 있습니다. 과도한 리소스 소비를 방지하기 위해 파티 라이브러리는 지정된 장치가 현재 참여하고 있는 모든 네트워크에서 이 최대값보다 더 많은 직접 피어 연결을 설정하지 못하도록 내부적으로 방지합니다. 추가 원격 장치가 있는 대규모 또는 다중 네트워크에 참여하는 장치의 기능에 영향을 미치지 않으며, 투명한 클라우드 릴레이 서버를 통하지 않고 이러한 직접 연결을 사용하여 장치 간에 전송될 엔드포인트 메시지 및 채팅 데이터의 기회 수를 정의합니다.

PartyNetwork::GetDeviceConnectionType()을 호출하여 로컬 장치가 실제로 네트워크의 특정 원격 장치에 직접 P2P 연결을 설정했는지 확인할 수 있습니다.

이 옵션의 기본값은 이지만 c_maxDirectPeerConnectionsPerDevice기본 설정을 사용할 때는 의 PlayFab 엔터티 형식 title_player_account으로 로컬 사용자를 인증할 때만 값이 적용됩니다. 대신 기본 옵션 구성을 사용하여 PlayFab 엔터티 형식의 game_server 로컬 사용자를 인증하는 경우 최대 직접 피어 연결 수는 없습니다.

PlayFab 엔터티 형식에 관계없이 이 값을 재정의하려면 개체 매개 변수에 대해 null을 전달하는 PartyManager::SetOption , 옵션 매개 변수에 대한 이 값 및 값에 대한 uint32_t 변수에 대한 선택적 포인터를 호출합니다. null uint32_t 포인터가 제공되면 기본값 및 동작이 복원됩니다.

이 옵션을 쿼리하려면 개체 매개 변수에 null, 옵션 매개 변수에 이 값, 현재 구성된 값이 기록되어야 하는 uint32_t 변수에 대한 포인터를 전달하는 PartyManager::GetOption을 호출합니다.

파티 라이브러리를 초기화하기 전을 포함하여 언제든지 이 옵션을 재정의하거나 쿼리하는 것이 안전합니다. 새 값을 설정하면 값이 변경된 후 연결된 모든 네트워크에 적용됩니다.
RegionUpdateConfiguration 파티 라이브러리가 자동 지역 검색 및 연결 품질 측정 업데이트를 수행할 때 구성하는 데 사용되는 옵션입니다.

이 옵션을 재정의하려면 개체 매개 변수에 null을 전달하고, 옵션 매개 변수에 대해 이 값을 전달하고, PartyRegionUpdateConfiguration 구조에 대한 선택적 포인터를 값으로 전달하는 PartyManager::SetOption을 호출합니다. null PartyRegionUpdateConfiguration 포인터가 제공되면 기본 구성이 복원됩니다.

이 옵션을 쿼리하려면 개체 매개 변수에 null을 전달하고, 옵션 매개 변수에 대해 이 값을 전달하고, 출력 PartyRegionUpdateConfiguration 구조에 대한 선택적 포인터를 값으로 전달하는 PartyManager::GetOption을 호출합니다.

파티 라이브러리를 초기화하기 전을 포함하여 언제든지 이 옵션을 재정의하거나 쿼리하는 것이 안전합니다. 지역 업데이트 구성을 재정의하면 즉시 적용됩니다.
RegionQualityMeasurementConfiguration 파티 라이브러리 지역 품질 측정 동작에 대한 세분화된 제어에 사용되는 옵션입니다.

이 옵션을 재정의하려면 개체 매개 변수에 null을 전달하고, 옵션 매개 변수에 대해 이 값을 전달하고, PartyRegionQualityMeasurementConfiguration 구조에 대한 선택적 포인터를 값으로 전달하는 PartyManager::SetOption을 호출합니다. null PartyRegionQualityMeasurementConfiguration 포인터가 제공되면 기본 구성이 복원됩니다.

이 옵션을 쿼리하려면 개체 매개 변수에 null을 전달하고, 옵션 매개 변수에 대해 이 값을 전달하고, 출력 PartyRegionQualityMeasurementConfiguration 구조에 대한 선택적 포인터를 값으로 전달하는 PartyManager::GetOption을 호출합니다.

파티 라이브러리를 초기화하기 전을 포함하여 언제든지 이 옵션을 재정의하거나 쿼리하는 것이 안전합니다. 지역 품질 측정 구성을 재정의하면 다음 지역 업데이트에 적용됩니다.

요구 사항

헤더: Party.h

참고 항목

파티 멤버
PartyManager::SetOption
PartyManager::GetOption
PartyLocalUdpSocketBindAddressConfiguration
PartyNetworkConfiguration
PartyDirectPeerConnectivityOptions
PartyRegionUpdateConfiguration
PartyRegionQualityMeasurementConfiguration