Sintaxe
Parâmetros
regionCount uint32_t*saída O número de saída de regiões fornecidas em
regions.
regions PartyRegion**matriz de saída alocada pela biblioteca de tamanho
*regionCount
Uma matriz de saída alocada pela biblioteca que contém o conjunto de regiões.
Valor retornado
PartyErrorc_partyErrorSuccess se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de GetErrorMessage().
Comentários
A matriz fornecida por este método só é preenchida quando o primeiro PartyRegionsChangedStateChange é fornecido. Cada PartyRegionsChangedStateChange subsequente indica uma atualização desse conjunto de regiões. As operações em segundo plano que preenchem esse conjunto começam quando Initialize() é chamado, a menos que a opção PartyOption::RegionUpdateConfiguration tenha sido usada para configurar um modo de atualização PartyRegionUpdateMode::Deferred. O modo adiado significa que a recuperação das regiões e a medição da qualidade da conexão só começam quando o aplicativo chama CreateNewNetwork() com uma matriz de regiões sem entradas ou quando não está conectado a nenhuma rede e chama PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles(), PartyLocalChatControl::SetTextToSpeechProfile(), or PartyLocalChatControl::SetTranscriptionOptions() com sinalizadores de opção que incluem PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState. A opção PartyOption::RegionUpdateConfiguration também pode ser usada para configurar o intervalo após o qual a matriz de regiões deve ser atualizada.A matriz retornada é ordenada por latência crescente. A latência de uma região é definida como o tempo de ponta a ponta necessário para enviar um datagrama UDP ao beacon de Qualidade de Serviço do PlayFab da região e receber uma resposta. A biblioteca mede a latência de cada região várias vezes para calcular resultados de alta fidelidade. Os aplicativos podem alterar aspectos de baixo nível desse procedimento de medição da qualidade da conexão usando a opção PartyOption::RegionQualityMeasurementConfiguration.
Uma latência equivalente a UINT32_MAX indica que a região tem suporte, mas não foi possível determinar as informações de latência, seja devido a falhas internas da biblioteca, seja porque um tempo limite foi atingido sem receber resposta do beacon. Isso pode ser usado para fins de diagnóstico (uma latência UINT32_MAX para todas as regiões provavelmente indica um problema de configuração local) ou para filtrar regiões que provavelmente não serão viáveis durante a seleção de região.
Os nomes retornados nas estruturas PartyRegion não são localizados para o idioma do usuário atual, e não é recomendável exibir as cadeias de caracteres diretamente na interface do usuário fora da solução de problemas.
Não presuma que o conjunto de regiões retornado permanecerá o mesmo durante a vida útil do seu título. A biblioteca do PlayFab Party aproveitará automaticamente as adições e alterações nas regiões disponíveis ao longo do tempo para melhorar continuamente a experiência dos usuários finais.
Requisitos
Cabeçalho: Party.hConfira também
PartyManagerPartyRegionsChangedStateChange
PartyManager::CreateNewNetwork