Skip to main content

XSpeechToTextBeginHypothesisString

Commence une hypothèse et affiche sa chaîne dans une superposition de texte.

Syntaxe

Paramètres

speakerName   _In_z_
Type : char*
Le nom de l’interlocuteur à afficher avec la chaîne d’hypothèse. content   _In_z_
Type : char*
La chaîne d’hypothèse initiale. type   _In_
Type : XSpeechToTextType
Le type de source de la chaîne d’hypothèse. hypothesisId   _Out_
Type : uint32_t*
L’identificateur de l’hypothèse.

Valeur de retour

Type : HRESULT Code HRESULT de réussite ou d’erreur.

Remarques

Une hypothèse est une estimation de ce que dit un interlocuteur, généralement produite par un module de reconnaissance vocale pendant que l’interlocuteur 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 tapé. Le paramètre type identifie la source de la chaîne d’hypothèse. L’application est responsable 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 retirer 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’appelle pas XSpeechToTextFinalizeHypothesisString. À moins que l’hypothèse ne soit annulée, votre application doit toujours appeler XSpeechToTextFinalizeHypothesisString pour s’assurer que la chaîne est affichée. L’exemple de code suivant montre une application qui crée une hypothèse, la met à jour, puis la finalise.
L’exemple de code suivant montre une application qui crée une hypothèse, la met à jour, puis l’annule.

Configuration requise

En-tête : XAccessibility.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

XAccessibility
Last modified on October 6, 2026