klasse KeywordRecognizer

class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

Recognizer-type dat is gespecialiseerd om alleen trefwoordactivering af te handelen.

Eerst moet het object worden geïnstantieerd:

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

(optioneel) Vervolgens moeten de gebeurtenissen worden bekabeld om meldingen te ontvangen:

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

En ten slotte moet de herkenning worden gestart.

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

Leden

Toegerekend

Syntaxis: public EventSignal< const KeywordRecognitionEventArgs & > Recognized;

Signaal voor gebeurtenissen met betrekking tot de herkenning van trefwoorden.

Geannuleerd

Syntaxis: public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;

Signaal voor gebeurtenissen met betrekking tot de annulering van een interactie. De gebeurtenis geeft aan of de reden een directe annulering of een fout is.

Eigenschappen

Syntaxis: public const PropertyCollection & Properties;

Een verzameling eigenschappen en de bijbehorende waarden die zijn gedefinieerd voor deze KeywordRecognizer.

~KeywordRecognizer

Syntaxis: public inline ~KeywordRecognizer ( );

Destructor.

RecognizeOnceAsync

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

Hiermee start u een sessie voor het herkennen van trefwoorden. Deze sessie duurt totdat het eerste trefwoord wordt herkend. Wanneer dit gebeurt, wordt er een herkende gebeurtenis gegenereerd en wordt de sessie beëindigd. Als u het trefwoord opnieuw wilt maken, moet de methode opnieuw worden aangeroepen nadat de gebeurtenis is verzonden.

Parameterwaarden

Retouren

Een toekomst die wordt omgezet in een KeywordRecognitionResult- die wordt omgezet zodra een trefwoord is gedetecteerd.

Als er geen trefwoord wordt gedetecteerd in de invoer, wordt de taak nooit omgezet (tenzij StopRecognition wordt aangeroepen.

StopRecognitionAsync

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

Hiermee wordt een momenteel actieve sessie voor het herkennen van trefwoorden gestopt.

Retouren

Een toekomst die wordt opgelost wanneer de actieve sessie (indien aanwezig) wordt gestopt.

FromConfig

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

Hiermee maakt u een KeywordRecognizer op basis van een AudioConfig. De configuratie is bedoeld om de audio-invoer te definiëren die moet worden gebruikt door het recognizer-object.

Parameterwaarden

  • audioConfig Definieert de audio-invoer die moet worden gebruikt door de recognizer.

Retouren

Een nieuwe KeywordRecognizer die audio van de opgegeven invoer verbruikt.

Als er geen audioconfiguratie is opgegeven, is deze gelijk aan het bellen met een configuratie die is samengesteld met AudioConfig::FromDefaultMicrophoneInput