Sintaxis
Parámetros
regionCount uint32_t*salida El número de salida de regiones proporcionadas en
regions.
regions PartyRegion**matriz de salida asignada por la biblioteca de tamaño
*regionCount
Una matriz de salida asignada por la biblioteca que contiene el conjunto de regiones.
Valor devuelto
PartyErrorc_partyErrorSuccess si la llamada se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante GetErrorMessage().
Comentarios
La matriz proporcionada por este método no se rellena hasta que se proporciona el primer PartyRegionsChangedStateChange. Cada PartyRegionsChangedStateChange posterior indica una actualización de este conjunto de regiones. Las operaciones en segundo plano que rellenan este conjunto comienzan cuando se llama a Initialize(), a menos que la opción PartyOption::RegionUpdateConfiguration se haya usado para configurar un modo de actualización de PartyRegionUpdateMode::Deferred. El modo diferido significa que la recuperación de regiones y la medición de la calidad de la conexión no comienzan hasta que la aplicación llama a CreateNewNetwork() con una matriz de regiones de cero entradas, o no está conectada a ninguna red y llama a PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles(), PartyLocalChatControl::SetTextToSpeechProfile() o PartyLocalChatControl::SetTranscriptionOptions() con marcas de opción que incluyan PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState. La opción PartyOption::RegionUpdateConfiguration también se puede usar para configurar el intervalo tras el cual se actualizará la matriz de regiones.La matriz devuelta se ordena en orden de latencia creciente. La latencia de una región se define como el tiempo de un extremo a otro que se tarda en enviar un datagrama UDP a la baliza de calidad de servicio de PlayFab de la región y recibir una respuesta. La biblioteca mide la latencia de cada región varias veces para calcular resultados de alta fidelidad. Las aplicaciones pueden modificar aspectos de bajo nivel de este procedimiento de medición de la calidad de la conexión mediante la opción PartyOption::RegionQualityMeasurementConfiguration.
Una latencia equivalente a UINT32_MAX indica que la región es compatible, pero la información de latencia no se pudo determinar, ya sea debido a errores internos de la biblioteca o porque se alcanzó un tiempo de espera sin recibir respuesta de la baliza. Esto se puede usar con fines de diagnóstico (una latencia de UINT32_MAX en todas las regiones probablemente indica un problema de configuración local) o para filtrar regiones que probablemente no sean viables durante la selección de regiones.
Los nombres devueltos en las estructuras PartyRegion no están localizados al idioma del usuario actual, y no se recomienda mostrar las cadenas directamente en la interfaz de usuario fuera de las tareas de solución de problemas.
No dé por hecho que el conjunto de regiones devuelto seguirá siendo el mismo durante la vida del título. La biblioteca de PlayFab Party aprovechará automáticamente las adiciones y los cambios en las regiones disponibles a lo largo del tiempo para mejorar continuamente la experiencia de los usuarios finales.
Requisitos
Encabezado: Party.hConsulte también
PartyManagerPartyRegionsChangedStateChange
PartyManager::CreateNewNetwork