Pular para o conteúdo principal
A configuração usada pela biblioteca do Party para controlar como ela realiza a descoberta automática de regiões e as atualizações de medição da qualidade da conexão.

Sintaxe

Membros

mode   PartyRegionUpdateMode O modo que controla quando a descoberta de regiões e as atualizações de medição da qualidade da conexão são realizadas. O valor padrão é PartyRegionUpdateMode::Immediate quando PartyOption::RegionUpdateConfiguration não foi configurada. refreshIntervalInSeconds   uint32_t O número de segundos que deve decorrer após a conclusão das medições de qualidade das regiões antes que um novo processo de descoberta de regiões e de medição da qualidade da conexão possa começar. Esse intervalo de atualização é usado sempre que uma PartyRegionsChangedStateChange é fornecida, para determinar quando a próxima medição de qualidade das regiões estará qualificada para começar no modo de atualização definido pelo campo mode.

Tornar-se qualificado para uma atualização não garante que ela comece exatamente nesse momento. Se o campo mode estiver definido como PartyRegionUpdateMode::Deferred, a próxima atualização só acontecerá quando um dos métodos aplicáveis for chamado para disparar uma atualização de região. A biblioteca também aguarda até que o dispositivo local não esteja mais em nenhuma rede do Party e aplica um pequeno atraso aleatório para tentar evitar carga no serviço PlayFab causada por vários dispositivos sincronizados involuntariamente.

O valor padrão é 28800 (8 horas) quando PartyOption::RegionUpdateConfiguration não foi configurada.

Um valor zero faz com que a biblioteca do Party nunca atualize automaticamente as medições no futuro. Caso contrário, o valor mínimo permitido é 30 segundos.

Comentários

Esta estrutura pode ser usada junto com PartyOption::RegionUpdateConfiguration para substituir ou consultar a configuração atual da biblioteca do Party por meio de PartyManager::SetOption() ou PartyManager::GetOption(), respectivamente. Ela configura o comportamento do processo de descoberta de regiões e de medição da qualidade da conexão que produz alterações de estado PartyRegionsChangedStateChange.

Requisitos

Cabeçalho: Party.h

Confira também

Membros do Party
PartyOption::RegionUpdateConfiguration
PartyRegionUpdateMode
PartyRegionsChangedStateChange
PartyManager::SetOption
PartyManager::GetOption
Última modificação em 8 de outubro de 2026