classe KeywordRecognizer

class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

Type de module de reconnaissance spécialisé uniquement pour gérer l’activation de mot clé.

Tout d’abord, l’objet doit être instancié :

auto audioConfig = AudioConfig::FromMicrophoneInput(); // Or an alternative input
auto recognizer = [KeywordRecognizer::FromConfig](#fromconfig)(audioConfig);

(facultatif) Ensuite, les événements doivent être câblés pour recevoir des notifications :

recognizer->Recognized += [](const KeywordRecognitionEventArgs& event)
{
    // Your logic here...
};

Enfin, la reconnaissance doit être démarrée.

auto keywordModel = [KeywordRecognitionModel::FromFile](keywordrecognitionmodel.md#fromfile)(modelPath);
auto resultFuture = recognizer->RecognizeKeywordOnceAsync(keywordModel);
resultFuture.wait();
auto result = resultFuture.get();

Membres

Constaté

Syntaxe : public EventSignal< const KeywordRecognitionEventArgs & > Recognized;

Signal pour les événements liés à la reconnaissance des mots clés.

Annulé

Syntaxe : public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;

Signal pour les événements liés à l’annulation d’une interaction. L’événement indique si la raison est une annulation directe ou une erreur.

Propriétés

Syntaxe : public const PropertyCollection & Properties;

Collection de propriétés et leurs valeurs définies pour ce KeywordRecognizer.

~KeywordRecognizer

Syntaxe : public inline ~KeywordRecognizer ( );

Destructeur.

RecognizeOnceAsync

Syntaxe : public inline std::future< std::shared_ptr< KeywordRecognitionResult > > RecognizeOnceAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Démarre une session de reconnaissance de mot clé. Cette session durera jusqu’à ce que le premier mot clé soit reconnu. Lorsque cela se produit, un événement Reconnu est déclenché et la session se termine. Pour réarmer le mot clé, la méthode doit être appelée à nouveau une fois l’événement émis.

Paramètres

Retours

Un avenir qui se résout en un KeywordRecognitionResult qui se résout une fois qu’un mot clé est détecté.

Notez que si aucun mot clé n’est détecté dans l’entrée, la tâche ne se résout jamais (sauf si StopRecognition est appelée.

StopRecognitionAsync

Syntaxe : public inline std::future< void > StopRecognitionAsync ( );

Arrête une session de reconnaissance de mot clé active.

Retours

Un avenir qui se résout lorsque la session active (le cas échéant) est arrêtée.

FromConfig

Syntaxe : public inline static std::shared_ptr< KeywordRecognizer > FromConfig ( std::shared_ptr< Audio::AudioConfig > audioConfig );

Crée un KeywordRecognizer à partir d’un AudioConfig. La configuration est destinée à définir l’entrée audio à utiliser par l’objet recognizer.

Paramètres

  • audioConfig Définit l’entrée audio à utiliser par le module de reconnaissance.

Retours

Nouveau KeywordRecognizer qui utilisera l’audio à partir de l’entrée spécifiée.

Si aucune configuration audio n’est fournie, elle équivaut à appeler avec une configuration construite avec AudioConfig ::FromDefaultMicrophoneInput

  • Last updated on