Skip to main content

XSpeechToTextBeginHypothesisString

Inicia uma hipótese e exibe a cadeia de caracteres dela em uma sobreposição de texto.

Sintaxe

Parâmetros

speakerName   _In_z_
Tipo: char*
O nome do locutor a ser exibido com a cadeia de caracteres da hipótese. content   _In_z_
Tipo: char*
A cadeia de caracteres inicial da hipótese. type   _In_
Tipo: XSpeechToTextType
O tipo de origem da cadeia de caracteres da hipótese. hypothesisId   _Out_
Tipo: uint32_t*
A ID da hipótese.

Valor retornado

Tipo: HRESULT HRESULT de êxito ou código de erro.

Comentários

Uma hipótese é uma estimativa do que um locutor está dizendo, normalmente produzida por um reconhecedor de fala enquanto o locutor está no meio de uma frase. A API de sobreposição de conversão de fala em texto pode exibir uma cadeia de caracteres de hipótese sobre uma superfície do jogo. A API de sobreposição de conversão de fala em texto também dá suporte a texto digitado. O parâmetro type identifica a origem da cadeia de caracteres da hipótese. O aplicativo é responsável por reter o valor de hypothesisId até que a hipótese seja finalizada ou cancelada. Para atualizar uma cadeia de caracteres de hipótese na sobreposição, use XSpeechToTextUpdateHypothesisString. Para cancelar uma hipótese e removê-la da sobreposição, use XSpeechToTextCancelHypothesisString. Para finalizar uma hipótese, use XSpeechToTextFinalizeHypothesisString. Em algumas plataformas, a cadeia de caracteres da hipótese não é exibida até que o aplicativo chame XSpeechToTextFinalizeHypothesisString. A menos que a hipótese seja cancelada, seu aplicativo deve sempre chamar XSpeechToTextFinalizeHypothesisString para garantir que a cadeia de caracteres seja exibida. O exemplo de código a seguir mostra um aplicativo criando uma hipótese, atualizando-a e, em seguida, finalizando-a.
O exemplo de código a seguir mostra um aplicativo criando uma hipótese, atualizando-a e, em seguida, cancelando-a.

Requisitos

Cabeçalho: XAccessibility.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

XAccessibility
Last modified on October 6, 2026