Freigeben über


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

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.