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

# PartyRegionsChangedStateChange

> Informações específicas do tipo de alteração de estado *RegionsChanged*.

Informações específicas do tipo de alteração de estado *RegionsChanged*.

## Sintaxe

```cpp theme={null}
struct PartyRegionsChangedStateChange : PartyStateChange {  
    PartyStateChangeResult result;  
    PartyError errorDetail;  
}  
```

### Membros

**`result`**   [PartyStateChangeResult](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md)

Indica se uma operação em segundo plano para consultar a lista de regiões com suporte e a latência para cada região teve êxito ou fornece o motivo da falha.

Quando o resultado é [PartyStateChangeResult::Succeeded](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md), a lista de regiões fornecida por [PartyManager::GetRegions()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md) é preenchida com os resultados da operação. Em caso de falha, a lista de regiões fornecida por PartyManager::GetRegions() fica vazia. \
\
 Se o resultado for [PartyStateChangeResult::FailedToBindToLocalUdpSocket](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md), a biblioteca não conseguiu se associar ao soquete UDP local especificado na opção [PartyOption::LocalUdpSocketBindAddress](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md). O título deve limpar sua instância da biblioteca, atualizar a opção [PartyOption::LocalUdpSocketBindAddress](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md) para um endereço de associação válido e disponível e reinicializar a biblioteca.

**`errorDetail`**   PartyError

Um valor de diagnóstico que fornece mais informações de solução de problemas sobre qualquer possível condição de erro.

A forma legível deste detalhe de erro pode ser obtida por meio de [PartyManager::GetErrorMessage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

## Comentários

A recuperação da lista de regiões disponíveis e a medição da qualidade da conexão com elas ocorrem automaticamente em segundo plano. Essa operação é iniciada pela primeira vez quando [PartyManager::Initialize()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md) é chamado, a menos que a opção [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md) tenha sido usada para configurar um modo de atualização [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md), caso em que as atualizações de região podem nem acontecer. As atualizações de região adiadas só ocorrem se o aplicativo chamar [PartyManager::CreateNewNetwork()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md) com uma matriz de regiões sem entradas ou se não estiver conectado a uma rede existente, mas chamar [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md), [PartyLocalChatControl::SetTextToSpeechProfile()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile.md) ou [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md) com sinalizadores de opção que incluam [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md). A opção [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md) também pode ser usada para configurar o intervalo após o qual as regiões são atualizadas. \
\
 O tempo necessário para recuperar a lista de regiões disponíveis e medir a qualidade da conexão com elas depende de muitos fatores ambientais ou dinâmicos e de a opção [PartyOption::RegionQualityMeasurementConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md) ter sido usada para modificar as configurações de medição de baixo nível. O campo *totalMeasurementTimeoutInMilliseconds* da estrutura [PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md) é usado para configurar o tempo limite máximo de pior caso antes de considerar todas as medições concluídas e gerar esta alteração de estado.

## 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::GetRegions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)


## Related topics

- [PartyManager::GetRegions](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.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)
- [PartyRegionUpdateMode](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [Medições de QoS do PlayFab Party](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/concepts-regions.md)