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 chameXSpeechToTextFinalizeHypothesisString. 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.
