Share via

classe KeywordRecognizer

  • Article 
class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

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

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 lancée.

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

Membres

Reconnu

Syntaxe : public EventSignal< constKeywordRecognitionEventArgs & > Recognized;

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

Opération annulée

Syntaxe : public EventSignal< constSpeechRecognitionCanceledEventArgs & > 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 constPropertyCollection & 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 mot clé. Cette session durera jusqu’à ce que la première mot clé soit reconnue. Dans ce cas, 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 après l’émission de l’événement.

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 aucune mot clé n’est détectée dans l’entrée, la tâche ne se résout jamais (sauf si StopRecognition est appelé.

StopRecognitionAsync

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

Arrête une session de reconnaissance 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, cela équivaut à appeler avec une configuration construite avec AudioConfig ::FromDefaultMicrophoneInput