> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyOption

> Opções adicionais que podem ser definidas para ajustar a funcionalidade da biblioteca do Party.

Opções adicionais que podem ser definidas para ajustar a funcionalidade da biblioteca do Party.

## Sintaxe

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

## Constantes

| Constante | Descrição |
| - | - |
| LocalUdpSocketBindAddress | Uma opção usada para configurar como a biblioteca do Party se associa a um soquete UDP.  Para substituir esta opção, chame [PartyManager::SetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro opcional para [PartyLocalUdpSocketBindAddressConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partylocaludpsocketbindaddressconfiguration.md) como valor. Se for fornecido um ponteiro PartyLocalUdpSocketBindAddressConfiguration nulo, a configuração padrão será restaurada.   Para consultar esta opção, chame [PartyManager::GetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro para uma saída PartyLocalUdpSocketBindAddressConfiguration como valor.     É seguro e recomendável substituir ou consultar esta opção antes de inicializar a biblioteca do Party. A substituição da configuração do endereço de associação do soquete UDP local entrará em vigor na próxima vez que a biblioteca do Party for inicializada. Ela não modifica nenhuma associação de soquete da biblioteca do Party que já tenha sido inicializada. Da mesma forma, a consulta recupera a configuração que será usada na próxima inicialização da biblioteca do Party, e não o valor em uso, se ela já estiver inicializada. |
| LocalDeviceDirectPeerConnectivityOptionsMask | Uma opção para restringir a conectividade ponto a ponto direta permitida entre o dispositivo local e outros dispositivos em redes que permitem tentar essas conexões.  Ao autenticar com êxito um usuário local inicial em uma rede com [PartyNetworkConfiguration::directPeerConnectivityOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partynetworkconfiguration.md) definido como um valor diferente de [PartyDirectPeerConnectivityOptions::None](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions.md), ou quando um dispositivo remoto se autentica em uma rede desse tipo, pode ser tentada a conectividade ponto a ponto direta entre este dispositivo local e os dispositivos remotos da rede. Os sinalizadores configurados por esta opção podem ser usados para restringir ainda mais os tipos específicos de dispositivos remotos que têm permissão para envolver o dispositivo local nessas tentativas. Todos os sinalizadores são avaliados usando uma operação AND bit a bit. Ou seja, um determinado sinalizador só entra realmente em vigor para um par de dispositivos de uma rede se estiver habilitado em três lugares: na estrutura [PartyNetworkConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partynetworkconfiguration.md) da rede e nas respectivas opções de máscara local de *ambos* os dispositivos. Mesmo que a rede do Party permita a conectividade ponto a ponto direta da forma relevante, qualquer um dos dispositivos pode recusar unilateralmente a divulgação do endereço IP e as tentativas de conexão direta entre eles não habilitando o sinalizador ao substituir esta opção.   A conectividade ponto a ponto direta tem suporte nas versões da biblioteca para Windows, Microsoft Game Core, PlayStation®, Switch, Linux e macOS. Nessas plataformas, o valor padrão da máscara do dispositivo local, quando ainda não definida, é `PartyDirectPeerConnectivityOptions::AnyPlatformType \| PartyDirectPeerConnectivityOptions::AnyEntityLoginProvider \| PartyDirectPeerConnectivityOptions::OnlyServers`. Isso significa que esses dispositivos não restringem nenhuma conectividade ponto a ponto direta permitida pela [PartyNetworkConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partynetworkconfiguration.md) de uma rede, até que o valor seja substituído explicitamente para ser menos permissivo. Em todas as outras versões da biblioteca, o valor padrão da máscara do dispositivo local é `PartyDirectPeerConnectivityOptions::None` e não pode ser alterado; tentar alterá-lo por meio de [PartyManager::SetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) falhará. Isso significa que esses dispositivos nunca tentarão a conectividade ponto a ponto direta.     Para substituir esta opção, chame [PartyManager::SetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro opcional para [PartyDirectPeerConnectivityOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions.md) que contenha todos os sinalizadores de opção desejados. Se for fornecido um ponteiro PartyDirectPeerConnectivityOptions nulo, as opções padrão serão restauradas.     Para consultar esta opção, chame [PartyManager::GetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro para [PartyDirectPeerConnectivityOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions.md) na qual os sinalizadores de opção configurados no momento devem ser gravados.     É recomendável substituir ou consultar esta opção quando não houver conexão com nenhuma rede. O valor configurado entra em vigor na próxima vez que este dispositivo autenticar um usuário inicial em uma nova rede. Ele não altera as configurações já em uso para participar de redes existentes. Da mesma forma, a consulta recupera o valor configurado no momento que será usado com redes futuras, e não os valores usados com as redes existentes.     Também é seguro substituir ou consultar esta opção antes de inicializar a biblioteca do Party. |
| TextChatFilterLevel | Uma opção para ajustar o nível em que o texto do chat será filtrado.  Este recurso só se aplica ao texto de chat recebido detectado como inglês. O nível de filtro não pode ser alterado para outros idiomas.   O nível de filtro se aplicará ao texto de chat recebido de todos os controles de chat locais do cliente. A filtragem deve ser habilitada com [PartyLocalChatControl::SetTextChatOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md) para pelo menos um controle de chat local para que isso tenha efeito no texto do chat.     Para substituir esta opção, chame [PartyManager::SetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro opcional para [PartyTextChatFilterLevel](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partytextchatfilterlevel.md) que contenha o nível de filtro desejado. Se for fornecido um ponteiro PartyTextChatFilterLevel nulo, o nível padrão será restaurado.     Para consultar esta opção, chame [PartyManager::GetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro para [PartyTextChatFilterLevel](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partytextchatfilterlevel.md) na qual o nível de filtro configurado no momento deve ser gravado.     É seguro substituir ou consultar esta opção a qualquer momento, inclusive antes de inicializar a biblioteca do Party. A definição de um novo valor entra em vigor imediatamente. |
| LocalDeviceMaxDirectPeerConnections | Uma opção para configurar o número máximo de conexões ponto a ponto diretas que este dispositivo tenta estabelecer com outros dispositivos.  Ao autenticar com êxito um usuário local inicial em uma rede com [PartyNetworkConfiguration::directPeerConnectivityOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partynetworkconfiguration.md) definido como um valor diferente de [PartyDirectPeerConnectivityOptions::None](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions.md), os dispositivos podem tentar a conectividade ponto a ponto direta entre si. Para evitar o consumo excessivo de recursos, a biblioteca do Party impedirá internamente que qualquer dispositivo tente estabelecer mais conexões ponto a ponto diretas do que este máximo em todas as redes das quais participa no momento. Isso não afeta a capacidade do dispositivo de participar de redes grandes ou de várias redes com dispositivos remotos adicionais; apenas define o número de oportunidades para que as mensagens de ponto de extremidade e os dados de chat entre os dispositivos sejam transmitidos usando essas conexões diretas, em vez de servidores transparentes de retransmissão na nuvem.   Você pode determinar se o dispositivo local realmente estabeleceu uma conexão ponto a ponto direta com um dispositivo remoto específico em uma rede chamando [PartyNetwork::GetDeviceConnectionType()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_getdeviceconnectiontype.md).     O valor padrão desta opção é `c_maxDirectPeerConnectionsPerDevice`; no entanto, ao usar as configurações padrão, o valor só se aplica ao autenticar um usuário local com o tipo de entidade do PlayFab `title_player_account`. Ao autenticar um usuário local com o tipo de entidade do PlayFab `game_server` usando a configuração de opção padrão, não há número máximo de conexões ponto a ponto diretas.     Para substituir este valor independentemente do tipo de entidade do PlayFab, chame [PartyManager::SetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro opcional para uma variável uint32\_t como valor. Se for fornecido um ponteiro uint32\_t nulo, o valor e o comportamento padrão serão restaurados.     Para consultar esta opção, chame [PartyManager::GetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro para uma variável uint32\_t na qual o valor configurado no momento deve ser gravado.     É seguro substituir ou consultar esta opção a qualquer momento, inclusive antes de inicializar a biblioteca do Party. A definição de um novo valor entra em vigor para todas as redes nas quais o dispositivo ingressar depois que o valor for alterado. |
| RegionUpdateConfiguration | Uma opção usada para configurar quando a biblioteca do Party realiza a descoberta automática de regiões e as atualizações de medição da qualidade da conexão.  Para substituir esta opção, chame [PartyManager::SetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro opcional para [PartyRegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) como valor. Se for fornecido um ponteiro PartyRegionUpdateConfiguration nulo, a configuração padrão será restaurada.   Para consultar esta opção, chame [PartyManager::GetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro para uma saída [PartyRegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md) como valor.     É seguro substituir ou consultar esta opção a qualquer momento, inclusive antes de inicializar a biblioteca do Party. A substituição da configuração de atualização de regiões entra em vigor imediatamente. |
| RegionQualityMeasurementConfiguration | Uma opção usada para um controle refinado do comportamento de medição da qualidade das regiões da biblioteca do Party.  Para substituir esta opção, chame [PartyManager::SetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro opcional para [PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md) como valor. Se for fornecido um ponteiro PartyRegionQualityMeasurementConfiguration nulo, a configuração padrão será restaurada.   Para consultar esta opção, chame [PartyManager::GetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md) passando nulo para o parâmetro de objeto, este valor para o parâmetro de opção e um ponteiro para uma saída [PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md) como valor.     É seguro substituir ou consultar esta opção a qualquer momento, inclusive antes de inicializar a biblioteca do Party. A substituição da configuração de medição da qualidade das regiões entrará em vigor na próxima atualização de regiões. |

## Requisitos

**Cabeçalho:** Party.h

## Confira também

[Membros do Party](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/party_members.md)\
[PartyManager::SetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md)\
[PartyManager::GetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md)\
[PartyLocalUdpSocketBindAddressConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partylocaludpsocketbindaddressconfiguration.md)\
[PartyNetworkConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partynetworkconfiguration.md)\
[PartyDirectPeerConnectivityOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions.md)\
[PartyRegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)\
[PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md)


## Related topics

- [PartyManager::SetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption.md)
- [PartyManager::GetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md)
- [PartyDirectPeerConnectivityOptions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions.md)
- [Notas de versão do PlayFab Party](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/release-notes.md)
- [PartyRegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)