Class KeywordRecognizer
class KeywordRecognizer
: public std::enable_shared_from_this< KeywordRecognizer >
Erkennungstyp, der nur für die Behandlung der Schlüsselwortaktivierung spezialisiert ist.
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 Erkennung gestartet werden.
auto keywordModel = [KeywordRecognitionModel::FromFile](keywordrecognitionmodel.md#fromfile)(modelPath);
auto resultFuture = recognizer->RecognizeKeywordOnceAsync(keywordModel);
resultFuture.wait();
auto result = resultFuture.get();
Elemente
Erkannt
Syntax: public EventSignal< const KeywordRecognitionEventArgs & > Recognized;
Signal für Ereignisse im Zusammenhang mit der Erkennung von Schlüsselwörtern.
Abgesagt
Syntax: public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;
Signal für Ereignisse im Zusammenhang mit der Abbruch einer Interaktion. Das Ereignis gibt an, ob es sich bei dem Grund um einen direkten Abbruch oder einen Fehler handelt.
Eigenschaften
Syntax: public const PropertyCollection & 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üsselworterkennungssitzung. Diese Sitzung dauert, bis das erste Schlüsselwort erkannt wird. In diesem Fall wird ein Erkannten-Ereignis ausgelöst, und die Sitzung wird beendet. Um das Schlüsselwort neu zu erstellen, muss die Methode erneut aufgerufen werden, nachdem das Ereignis ausgegeben wurde.
Die Parameter
-
model
Das KeywordRecognitionModel-, das das schlüsselwort beschreibt, das erkannt werden soll.
Rückgaben
Eine Zukunft, die zu einem KeywordRecognitionResult aufgelöst wird, der aufgelöst wird, sobald ein Schlüsselwort erkannt wird.
Beachten Sie, dass, wenn in der Eingabe kein Schlüsselwort erkannt wird, die Aufgabe niemals aufgelöst wird (es sei denn, StopRecognition wird aufgerufen.
StopRecognitionAsync
Syntax: public inline std::future< void > StopRecognitionAsync ( );
Beendet eine derzeit aktive Schlüsselworterkennungssitzung.
Rückgaben
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.
Die Parameter
-
audioConfig
Definiert die audioeingabe, die von der Erkennung verwendet werden soll.
Rückgaben
Ein neuer KeywordRecognizer, der Audiodaten aus der angegebenen Eingabe nutzt.
Wenn keine Audiokonfiguration angegeben wird, entspricht sie dem Aufrufen einer konfiguration, die mit AudioConfig::FromDefaultMicrophoneInput erstellt wurde.