Delen via

class KeywordRecognizer

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

Recognizer-type dat is gespecialiseerd om alleen activering van trefwoorden 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

Erkend

Syntaxis: public EventSignal< constKeywordRecognitionEventArgs & > Recognized;

Signaal voor gebeurtenissen met betrekking tot de herkenning van trefwoorden.

Geannuleerd

Syntaxis: public EventSignal< constSpeechRecognitionCanceledEventArgs & > 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 constPropertyCollection & 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 );

Start een sessie voor trefwoordherkenning. 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 gebruiken, moet de methode opnieuw worden aangeroepen nadat de gebeurtenis is verzonden.

Parameters

Retouren

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

Houd er rekening mee dat als er geen trefwoord wordt gedetecteerd in de invoer, de taak nooit wordt opgelost (tenzij StopRecognition wordt aangeroepen).

StopRecognitionAsync

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

Stopt een actieve sessie voor trefwoordherkenning.

Retouren

Een toekomst die wordt opgelost wanneer de actieve sessie (indien van toepassing) 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.

Parameters

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

Retouren

Een nieuwe KeywordRecognizer die audio van de opgegeven invoer verbruikt.

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