Sintaxe
Membros
result PartyStateChangeResult
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, a lista de regiões fornecida por PartyManager::GetRegions() é 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, a biblioteca não conseguiu se associar ao soquete UDP local especificado na opção PartyOption::LocalUdpSocketBindAddress. O título deve limpar sua instância da biblioteca, atualizar a opção PartyOption::LocalUdpSocketBindAddress 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().
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() é chamado, a menos que a opção PartyOption::RegionUpdateConfiguration tenha sido usada para configurar um modo de atualização PartyRegionUpdateMode::Deferred, 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() com uma matriz de regiões sem entradas ou se não estiver conectado a uma rede existente, mas chamar PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles(), PartyLocalChatControl::SetTextToSpeechProfile() ou PartyLocalChatControl::SetTranscriptionOptions() com sinalizadores de opção que incluam PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState. A opção PartyOption::RegionUpdateConfiguration 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 ter sido usada para modificar as configurações de medição de baixo nível. O campo totalMeasurementTimeoutInMilliseconds da estrutura PartyRegionQualityMeasurementConfiguration é 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.hConfira também
Membros do PartyPartyManager::GetRegions