Skip to main content

XSpeechToTextBeginHypothesisString

Inicia una hipótesis y muestra su cadena en una superposición de texto.

Sintaxis

Parámetros

speakerName   _In_z_
Tipo: char*
El nombre del hablante que se mostrará con la cadena de hipótesis. content   _In_z_
Tipo: char*
La cadena de hipótesis inicial. type   _In_
Tipo: XSpeechToTextType
El tipo de origen de la cadena de hipótesis. hypothesisId   _Out_
Tipo: uint32_t*
El identificador de la hipótesis.

Valor devuelto

Tipo: HRESULT HRESULT de operación correcta o código de error.

Comentarios

Una hipótesis es una suposición de lo que está diciendo un hablante, generalmente producida por un reconocedor de voz mientras el hablante está a mitad de frase. La API de superposición de voz a texto puede mostrar una cadena de hipótesis sobre una superficie del juego. La API de superposición de voz a texto también admite texto escrito. El parámetro type identifica el origen de la cadena de hipótesis. La aplicación es responsable de conservar el valor de hypothesisId hasta que la hipótesis se finalice o se cancele. Para actualizar una cadena de hipótesis en la superposición, use XSpeechToTextUpdateHypothesisString. Para cancelar una hipótesis y quitarla de la superposición, use XSpeechToTextCancelHypothesisString. Para finalizar una hipótesis, use XSpeechToTextFinalizeHypothesisString. En algunas plataformas, la cadena de hipótesis no se muestra hasta que la aplicación llama a XSpeechToTextFinalizeHypothesisString. A menos que la hipótesis se cancele, la aplicación siempre debe llamar a XSpeechToTextFinalizeHypothesisString para asegurarse de que la cadena se muestre. En el ejemplo de código siguiente se muestra una aplicación que crea una hipótesis, la actualiza y luego la finaliza.
En el ejemplo de código siguiente se muestra una aplicación que crea una hipótesis, la actualiza y luego la cancela.

Requisitos

Encabezado: XAccessibility.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

XAccessibility
Última modificación el 28 de agosto de 2026