Sintaxis
Miembros
result PartyStateChangeResult
Indica si una operación en segundo plano para consultar la lista de regiones compatibles y la latencia hacia cada región se realizó correctamente, o proporciona el motivo por el que falló.
Cuando el resultado es PartyStateChangeResult::Succeeded, la lista de regiones proporcionada por PartyManager::GetRegions() se rellena con los resultados de la operación. Si se produce un error, la lista de regiones proporcionada por PartyManager::GetRegions() está vacía. Si el resultado es PartyStateChangeResult::FailedToBindToLocalUdpSocket, la biblioteca no pudo enlazarse al socket UDP local especificado en la opción PartyOption::LocalUdpSocketBindAddress. El título debe limpiar su instancia de la biblioteca, actualizar la opción PartyOption::LocalUdpSocketBindAddress con una dirección de enlace válida y disponible, y reinicializar la biblioteca.
errorDetail PartyError
Un valor de diagnóstico que proporciona información adicional para la solución de problemas relacionada con cualquier posible condición de error.
La forma legible de este detalle de error se puede recuperar mediante PartyManager::GetErrorMessage().
Comentarios
La recuperación de la lista de regiones disponibles y la medición de la calidad de conexión hacia ellas se producen automáticamente en segundo plano. Esta operación se inicia por primera vez cuando se llama a PartyManager::Initialize(), a menos que la opción PartyOption::RegionUpdateConfiguration se haya usado para configurar un modo de actualización de PartyRegionUpdateMode::Deferred, en cuyo caso es posible que las actualizaciones de regiones no se produzcan en absoluto. Las actualizaciones de regiones diferidas solo se producen si la aplicación llama a PartyManager::CreateNewNetwork() con una matriz de regiones de cero entradas, o no está conectada a una red existente pero 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 actualizan las regiones.La cantidad de tiempo que se tarda en recuperar la lista de regiones disponibles y medir la calidad de conexión hacia ellas depende de muchos factores ambientales o dinámicos, y de si se usó la opción PartyOption::RegionQualityMeasurementConfiguration para modificar la configuración de medición de bajo nivel. El campo totalMeasurementTimeoutInMilliseconds de la estructura PartyRegionQualityMeasurementConfiguration se usa para configurar el tiempo de espera máximo de peor caso antes de considerar completadas todas las mediciones y generar este cambio de estado.
Requisitos
Encabezado: Party.hConsulte también
Miembros de PartyPartyManager::GetRegions