XSpeechToTextBeginHypothesisString
Commence une hypothèse et affiche sa chaîne dans une superposition de texte.Syntaxe
Paramètres
speakerName _In_z_Type : char* Nom de l’orateur à afficher avec la chaîne d’hypothèse. content _In_z_
Type : char* Chaîne d’hypothèse initiale. type _In_
Type : XSpeechToTextType Type de source de la chaîne d’hypothèse. hypothesisId _Out_
Type : uint32_t* ID de l’hypothèse.
Valeur de retour
Type : HRESULT HRESULT de réussite ou code d’erreur.Remarques
Une hypothèse est une estimation de ce que dit un orateur, généralement produite par un module de reconnaissance vocale pendant que l’orateur est au milieu d’une phrase. L’API de superposition de reconnaissance vocale peut afficher une chaîne d’hypothèse par-dessus une surface de jeu. L’API de superposition de reconnaissance vocale prend également en charge le texte saisi. Le paramètre type identifie la source de la chaîne d’hypothèse. L’application est chargée de conserver la valeur de hypothesisId jusqu’à ce que l’hypothèse soit finalisée ou annulée. Pour mettre à jour une chaîne d’hypothèse dans la superposition, utilisez XSpeechToTextUpdateHypothesisString. Pour annuler une hypothèse et la supprimer de la superposition, utilisez XSpeechToTextCancelHypothesisString. Pour finaliser une hypothèse, utilisez XSpeechToTextFinalizeHypothesisString. Sur certaines plateformes, la chaîne d’hypothèse n’est pas affichée tant que l’application n’a pas appeléXSpeechToTextFinalizeHypothesisString. Sauf si l’hypothèse est annulée, votre application doit toujours appeler XSpeechToTextFinalizeHypothesisString pour garantir l’affichage de la chaîne.
L’exemple de code suivant montre une application qui crée une hypothèse, la met à jour, puis la finalise.
