Sintaxis
Parámetros
options PartyVoiceChatTranscriptionOptions
Opciones asociadas a la transcripción del chat de voz, como qué controles de chat deben generar transcripciones para el control de chat local y si esas transcripciones deben traducirse al idioma del control de chat local.
asyncIdentifier void*opcional Un valor de contexto opcional del tamaño de un puntero, definido por la aplicación, que se puede usar para asociar el cambio de estado de finalización con esta llamada.
Valor devuelto
PartyErrorc_partyErrorSuccess si la operación asincrónica para establecer las opciones de transcripción comenzó, o un código de error en caso contrario. Si este método produce un error, no se generará ningún cambio de estado relacionado. La forma legible del código de error se puede recuperar mediante PartyManager::GetErrorMessage().
Comentarios
La transcripción es el proceso de generar cadenas que representan las frases habladas en el chat de voz. Las opciones especificadas medianteoptions indican los controles de chat que deben generar estas cadenas de transcripción, que posteriormente se proporcionan al control de chat local mediante los PartyVoiceChatTranscriptionReceivedStateChange. Solo los controles de chat configurados para usar un idioma que admita la transcripción, mediante PartyLocalDevice::CreateChatControl(), proporcionarán transcripciones.
La funcionalidad de transcripción de voz a texto usa internamente las estimaciones disponibles de región y de medición de latencia para optimizar el uso del servicio. Si la opción PartyOption::RegionUpdateConfiguration se usó para configurar un modo de actualización de PartyRegionUpdateMode::Deferred, es posible que la recuperación del conjunto de regiones disponibles y la medición de la calidad de la conexión a estas aún no hayan comenzado, o que la última actualización haya superado la antigüedad del intervalo de actualización configurado. Si el dispositivo local no se está conectando actualmente ni está conectado a ninguna red, y la aplicación especifica marcas de opción que incluyen PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState, entonces SetTranscriptionOptions() garantiza que cualquier actualización de región diferida haya comenzado y que el PartyRegionsChangedStateChange asociado se proporcione antes de la finalización del PartySetTranscriptionOptionsCompletedStateChange de esta llamada.