classe Intent ::IntentRecognizer
class Intent::IntentRecognizer
: public AsyncRecognizer< IntentRecognitionResult, IntentRecognitionEventArgs, IntentRecognitionCanceledEventArgs >
En plus d’effectuer la reconnaissance vocale, l’objet IntentRecognizer extrait des informations structurées sur l’intention de l’orateur, qui peuvent être utilisées pour générer d’autres actions à l’aide de déclencheurs d’intention dédiés (voir IntentTrigger).
Membres
Propriétés
Syntaxe : public PropertyCollection & Properties;
Collection de propriétés et leurs valeurs définies pour ce IntentRecognizer.
IntentRecognizer
Syntaxe : public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );
Constructeur interne. Crée un instance à l’aide du handle fourni.
Paramètres
hreco
Handle recognizer.
~IntentRecognizer
Syntaxe : public inline ~IntentRecognizer ( );
destructeur
RecognizeOnceAsync
Syntaxe : public inline virtual std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( );
Démarre la reconnaissance de l’intention et retourne une fois qu’un seul énoncé est reconnu. La fin d’un énoncé unique est déterminée par la détection du silence à la fin, ou après que 15 secondes d’audio ont été traitées. La tâche retourne le texte de reconnaissance comme résultat. Remarque : Étant donné que RecognizeOnceAsync() ne retourne qu’un seul énoncé, il ne convient qu’à la reconnaissance d’un seul coup comme une commande ou une requête. Pour la reconnaissance multi-énoncé de longue durée, utilisez à la place StartContinuousRecognitionAsync().
Retours
Valeur de résultat future (pointeur partagé vers IntentRecognitionResult) de la reconnaissance d’intention asynchrone.
RecognizeOnceAsync
Syntaxe : public inline std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( std::string text );
Démarre la reconnaissance des intentions et génère un résultat à partir du texte transmis. Cela est utile pour les tests et d’autres fois où l’entrée vocale n’est pas liée à IntentRecognizer. Remarque : Le service Intention ne prend actuellement pas en charge cette fonctionnalité. Elle est donc uniquement valide pour les intentions de correspondance de modèle hors connexion ou exactes.
Paramètres
text
Texte à évaluer.
Retours
Valeur de résultat future (pointeur partagé vers IntentRecognitionResult) de la reconnaissance d’intention asynchrone.
StartContinuousRecognitionAsync
Syntaxe : public inline virtual std::future< void > StartContinuousRecognitionAsync ( );
Lance de manière asynchrone l’opération de reconnaissance d’intention continue.
Retours
Un avenir vide.
StopContinuousRecognitionAsync
Syntaxe : public inline virtual std::future< void > StopContinuousRecognitionAsync ( );
Met fin de manière asynchrone à l’opération de reconnaissance continue d’intention.
Retours
Un avenir vide.
StartKeywordRecognitionAsync
Syntaxe : public inline virtual std::future< void > StartKeywordRecognitionAsync ( std::shared_ptr< KeywordRecognitionModel > model );
Lance de manière asynchrone mot clé opération de reconnaissance.
Paramètres
model
Spécifie le modèle mot clé à utiliser.
Retours
Un avenir vide.
StopKeywordRecognitionAsync
Syntaxe : public inline virtual std::future< void > StopKeywordRecognitionAsync ( );
Arrête de manière asynchrone mot clé opération de reconnaissance.
Retours
Un avenir vide.
AddIntent
Syntaxe : public inline void AddIntent ( const std::string & simplePhrase );
Ajoute une expression simple qui peut être prononcée par l’utilisateur, indiquant une intention spécifique de l’utilisateur. Cette expression simple peut être un modèle incluant et l’enitité entouré d’accolades. Par exemple, « cliquez sur la case {case à cocherName} ».
Paramètres
simplePhrase
Expression correspondant à l’intention.
Une fois reconnue, la propriété IntentId de IntentRecognitionResult correspondra à la simplePhrase spécifiée ici. Si des entités sont spécifiées et mises en correspondance, elles seront disponibles dans l’appel IntentResult-GetEntities>().
AddIntent
Syntaxe : public inline void AddIntent ( const std::string & simplePhrase , const std::string & intentId );
Ajoute une expression simple qui peut être prononcée par l’utilisateur, indiquant une intention spécifique de l’utilisateur. Cette expression simple peut être un modèle incluant et l’enitité entouré d’accolades. Par exemple, « cliquez sur la case {case à cocherName} ».
Paramètres
simplePhrase
Expression correspondant à l’intention.intentId
Chaîne d’ID personnalisée à retourner dans la propriété IntentId de IntentRecognitionResult.
Une fois reconnu, l’ID d’intention du résultat correspondra à l’ID fourni ici. Si des entités sont spécifiées et mises en correspondance, elles seront disponibles dans l’appel IntentResult-GetEntities>().
AddIntent
Syntaxe : public inline void AddIntent ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentName );
Ajoute une intention unique par nom à partir du modèle Language Understanding spécifié. Pour les types PatternMatchingModel et ConversationalLanguageUnderstandingModel, tous les modèles existants seront effacés avant de les activer. Pour ces types, l’objet intentName est ignoré.
Paramètres
model
Modèle de compréhension du langage contenant l’intention.intentName
Nom de l’intention unique à inclure à partir du modèle de compréhension du langage.
Une fois reconnue, la propriété IntentId de IntentRecognitionResult contiendra le intentName spécifié ici.
AddIntent
Syntaxe : public inline void AddIntent ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentName , const std::string & intentId );
Ajoute une intention unique par nom à partir du modèle Language Understanding spécifié. Pour les types PatternMatchingModel et ConversationalLanguageUnderstandingModel, tous les modèles existants seront effacés avant de les activer. Pour ces types, les intentName et intentId sont ignorés.
Paramètres
model
Modèle de compréhension du langage contenant l’intention.intentName
Nom de l’intention unique à inclure à partir du modèle de compréhension du langage.intentId
Chaîne d’ID personnalisée à retourner dans la propriété IntentId de IntentRecognitionResult.
AddAllIntents
Syntaxe : public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model );
Ajoute toutes les intentions du modèle Language Understanding spécifié. Pour les types PatternMatchingModel et ConversationalLanguageUnderstandingModel, tous les modèles existants seront effacés avant de les activer.
Paramètres
model
Modèle de compréhension du langage contenant les intentions.
Une fois reconnue, la propriété IntentId de IntentRecognitionResult contient le nom de l’intention reconnue.
AddAllIntents
Syntaxe : public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentId );
Ajoute toutes les intentions du modèle Language Understanding spécifié. Pour les types PatternMatchingModel et ConversationalLanguageUnderstandingModel, tous les modèles existants sont effacés avant de les activer.
Paramètres
model
Modèle de compréhension du langage contenant les intentions.intentId
ID de chaîne personnalisé à retourner dans la propriété IntentRecognitionResult.
AddIntent
Syntaxe : public inline void AddIntent ( std::shared_ptr< IntentTrigger > trigger , const std::string & intentId );
Ajoute l’objet IntentTrigger spécifié.
Paramètres
trigger
IntentTrigger correspondant à l’intention.intentId
ID de chaîne personnalisé à retourner dans la propriété IntentRecognitionResult.
SetAuthorizationToken
Syntaxe : public inline void SetAuthorizationToken ( const std::string & token );
Définit le jeton d’autorisation qui sera utilisé pour la connexion au service. Remarque : l’appelant doit s’assurer que le jeton d’autorisation est valide. Avant que le jeton d’autorisation expire, l’appelant doit l’actualiser en appelant cet méthode setter avec un nouveau jeton valide. Sinon, le module de reconnaissance rencontrera des erreurs lors de la reconnaissance.
Paramètres
token
Chaîne qui représente le jeton d’autorisation.
GetAuthorizationToken
Syntaxe : public inline std::string GetAuthorizationToken ( );
Obtient le jeton d’autorisation.
Retours
Jeton d’autorisation
ApplyLanguageModels
Syntaxe : public inline bool ApplyLanguageModels ( const std::vector< std::shared_ptr< LanguageUnderstandingModel > > & collection );
Prend une collection de modèles de compréhension du langage, en fait une copie et les applique au module de reconnaissance. Cette application se produit à différents moments selon le type de modèle de compréhension du langage. Les modèles de langage simple deviendront actifs presque immédiatement, tandis que les modèles de compréhension du langage utilisant LUIS deviendront actifs au prochain tour de reconnaissance vocale. Cela remplace tous les modèles précédemment appliqués.
Paramètres
collection
Vecteur de pointeurs partagés vers LanguageUnderstandingModels.
Retours
True si l’application des modèles prend effet immédiatement. Sinon, false.
FromConfig
Syntaxe : public inline static std::shared_ptr< IntentRecognizer > FromConfig ( std::shared_ptr< SpeechConfig > speechConfig , std::shared_ptr< Audio::AudioConfig > audioInput );
Crée un module de reconnaissance d’intention à partir d’une configuration vocale et d’une configuration audio. Les utilisateurs doivent utiliser cette fonction pour créer un instance d’un module de reconnaissance d’intention.
Paramètres
speechConfig
Configuration vocale.audioInput
Configuration audio.
Retours
Instance du module de reconnaissance d’intention.
FromConfig
Syntaxe : public inline static std::shared_ptr< IntentRecognizer > FromConfig ( std::shared_ptr< EmbeddedSpeechConfig > speechConfig , std::shared_ptr< Audio::AudioConfig > audioInput );
Crée un module de reconnaissance d’intention à partir d’une configuration vocale incorporée et d’une configuration audio. Les utilisateurs doivent utiliser cette fonction pour créer un instance d’un module de reconnaissance d’intention. Ajouté dans la version 1.19.0.
Paramètres
speechConfig
Configuration vocale incorporée.audioInput
Configuration audio.
Retours
Instance du module de reconnaissance d’intention.
BaseType
Syntaxe : typedef BaseType;