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

# PartyRegionUpdateMode

> Modos de configuração que representam como a biblioteca do Party realiza a descoberta automática de regiões e a medição da qualidade da conexão como parte da estrutura.

Modos de configuração que representam como a biblioteca do Party realiza a descoberta automática de regiões e a medição da qualidade da conexão como parte da estrutura [PartyRegionUpdateConfiguration](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration).

## Sintaxe

```cpp theme={null}
enum class PartyRegionUpdateMode    
{  
    Immediate = 0,  
    Deferred = 1,  
}  
```

## Constantes

| Constante | Descrição |
| - | - |
| Immediate | Começa automaticamente a recuperar a lista de regiões disponíveis e a medir a qualidade da conexão com elas o mais rápido possível.<br /><br /> A biblioteca do Party descobre automaticamente as regiões disponíveis e mede a qualidade da conexão com elas quando PartyManager::Initialize() é invocado pela primeira vez. <br /><br /> A biblioteca do Party também atualiza periodicamente a lista e as medições de qualidade até que PartyManager::Cleanup() seja chamado. Se já houver conexão ou um processo de conexão em andamento com uma rede do Party existente, a atualização será adiada até a desconexão de todas as redes do Party. O intervalo de atualização periódica pode ser configurado usando o campo *refreshIntervalInSeconds* da estrutura [PartyRegionUpdateConfiguration](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration) que o contém.   <br /><br /> O aplicativo recebe automaticamente um [PartyRegionsChangedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) indicando as regiões disponíveis ou o [PartyStateChangeResult](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult) de falha sempre que uma operação de medição é concluída.   <br /><br /> Este modo é o valor padrão quando [PartyOption::RegionUpdateConfiguration](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption) não tiver sido configurado. |
| Deferred | Adia a recuperação da lista de regiões disponíveis e a medição da qualidade da conexão com elas até a criação de uma nova rede do Party ou o uso de determinadas funcionalidades de conversão de texto em fala ou de fala em texto.<br /><br /> A biblioteca do Party não descobre automaticamente as regiões disponíveis nem mede a qualidade da conexão com elas, a menos que o aplicativo chame [PartyManager::CreateNewNetwork()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork) com uma matriz de lista de regiões sem entradas ou não esteja conectado a uma rede existente, mas chame [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles), [PartyLocalChatControl::SetTextToSpeechProfile()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile), or [PartyLocalChatControl::SetTranscriptionOptions()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions) com sinalizadores de opção que incluem [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions). Depois que a descoberta adiada de regiões e a medição de qualidade começarem, um [PartyRegionsChangedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) indicando as regiões disponíveis ou o [PartyStateChangeResult](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult) de falha será fornecido antes da alteração de estado de conclusão [PartyCreateNewNetworkCompletedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange), [PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange), [PartySetTextToSpeechProfileCompletedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange), or [PartySetTranscriptionOptionsCompletedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange) da operação desencadeadora. <br /><br /> Nas chamadas subsequentes às funções acima com os parâmetros descritos, a lista de regiões será recuperada e medida novamente se o intervalo de atualização tiver decorrido desde que as últimas medições foram realizadas com êxito. Se já houver conexão ou um processo de conexão em andamento com uma rede do Party existente, a atualização será adiada até a desconexão de todas as redes do Party. O intervalo de atualização pode ser configurado usando o campo *refreshIntervalInSeconds* da estrutura [PartyRegionUpdateConfiguration](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration) que o contém.   <br /><br /> Os controles de chat usam internamente as estimativas de latência de região do dispositivo local para otimizar o uso do serviço na síntese de texto em fala, na transcrição de fala em texto e na tradução. Usar PartyRegionUpdateMode::Deferred pode fazer com que esses recursos tenham latência maior. |

## Requisitos

**Cabeçalho:** Party.h

## Confira também

[Membros do Party](/pt-BR/services/playfab/multiplayer/networking/reference/party_members)\
[PartyOption::RegionUpdateConfiguration](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption)\
[PartyRegionUpdateConfiguration](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration)\
[PartyRegionsChangedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)\
[PartyCreateNewNetworkCompletedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partycreatenewnetworkcompletedstatechange)\
[PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange)\
[PartySetTextToSpeechProfileCompletedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange)\
[PartySetTranscriptionOptionsCompletedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange)\
[PartyManager::Initialize](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize)\
[PartyManager::CreateNewNetwork](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)\
[PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles)\
[PartyLocalChatControl::SetTextToSpeechProfile](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile)\
[PartyLocalChatControl::SetTranscriptionOptions](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions)


## Related topics

- [PartyRegionUpdateConfiguration](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)
- [PartyRegionsChangedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)
- [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)
- [PartyManager::GetRegions](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)
- [PartyLocalChatControl::SetTranscriptionOptions](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)