Freigeben über

Klasse KeywordRecognizer

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

Erkennungstyp, der darauf spezialisiert ist, nur Schlüsselwort (keyword) Aktivierung zu verarbeiten.

Zunächst muss das Objekt instanziiert werden:

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

(optional) Anschließend müssen die Ereignisse verkabelt werden, um Benachrichtigungen zu erhalten:

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

Und schließlich muss die Anerkennung gestartet werden.

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

Member

Erkannt

Syntax: public EventSignal< constKeywordRecognitionEventArgs & > Recognized;

Signal für Ereignisse im Zusammenhang mit der Erkennung von Schlüsselwörtern.

Canceled

Syntax: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

Signal für Ereignisse im Zusammenhang mit dem Abbruch einer Interaktion. Das Ereignis gibt an, ob der Grund ein direkter Abbruch oder ein Fehler ist.

Eigenschaften

Syntax: public constPropertyCollection & Properties;

Eine Auflistung von Eigenschaften und deren Werten, die für dieses KeywordRecognizer definiert sind.

~KeywordRecognizer

Syntax: public inline ~KeywordRecognizer ( );

Destruktor.

RecognizeOnceAsync

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

Startet eine Schlüsselwort (keyword) Erkennungssitzung. Diese Sitzung dauert, bis die erste Schlüsselwort (keyword) erkannt wird. In diesem Fall wird ein Recognized-Ereignis ausgelöst, und die Sitzung wird beendet. Um die Schlüsselwort (keyword) umzugestalten, muss die -Methode erneut aufgerufen werden, nachdem das Ereignis ausgegeben wurde.

Parameter

Gibt zurück

Eine Zukunft, die in ein KeywordRecognitionResult aufgelöst wird, das aufgelöst wird, sobald ein Schlüsselwort (keyword) erkannt wird.

Beachten Sie, dass, wenn in der Eingabe kein Schlüsselwort (keyword) erkannt wird, die Aufgabe nie aufgelöst wird (es sei denn, StopRecognition wird aufgerufen.

StopRecognitionAsync

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

Beendet eine derzeit aktive Schlüsselwort (keyword) Erkennungssitzung.

Gibt zurück

Eine Zukunft, die aufgelöst wird, wenn die aktive Sitzung (falls vorhanden) beendet wird.

FromConfig

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

Erstellt ein KeywordRecognizer aus einer AudioConfig. Die Konfiguration dient zum Definieren der Audioeingabe, die vom Erkennungsobjekt verwendet werden soll.

Parameter

  • audioConfig Definiert die Audioeingabe, die von der Erkennung verwendet werden soll.

Gibt zurück

Ein neues KeywordRecognizer, das Audiodaten aus der angegebenen Eingabe nutzt.

Wenn keine Audiokonfiguration bereitgestellt wird, entspricht dies dem Aufrufen mit einer Konfiguration, die mit AudioConfig::FromDefaultMicrophoneInput erstellt wurde.