klass KeywordRecognizer

class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

Typ av identifierare som är specialiserad på att endast hantera nyckelordsaktivering.

Först måste objektet instansieras:

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

(valfritt) Sedan måste händelserna vara kopplade för att kunna ta emot meddelanden:

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

Och slutligen måste erkännandet startas.

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

Medlemmar

Beaktade

Syntax: public EventSignal< const KeywordRecognitionEventArgs & > Recognized;

Signal för händelser som rör igenkänning av nyckelord.

Annullerad

Syntax: public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;

Signal för händelser som rör annullering av en interaktion. Händelsen anger om orsaken är en direkt annullering eller ett fel.

Egenskaper

Syntax: public const PropertyCollection & Properties;

En samling egenskaper och deras värden som definierats för det här KeywordRecognizer.

~KeywordRecognizer

Syntax: public inline ~KeywordRecognizer ( );

Destructor.

RecognizeOnceAsync

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

Startar en nyckelordsigenkänningssession. Den här sessionen kommer att pågå tills det första nyckelordet identifieras. När detta inträffar aktiveras en identifierad händelse och sessionen avslutas. Om du vill väpna nyckelordet igen måste metoden anropas igen efter att händelsen har genererats.

Parameterar

Återlämning

En framtid som löser en KeywordRecognitionResult som löser när ett nyckelord har identifierats.

Observera att om inget nyckelord identifieras i indata löses aktiviteten aldrig (såvida inte StopRecognition anropas.

StopRecognitionAsync

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

Stoppar en aktiv nyckelordsigenkänningssession.

Återlämning

En framtid som löser när den aktiva sessionen (om någon) stoppas.

FromConfig

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

Skapar en KeywordRecognizer från en AudioConfig. Konfigurationen är avsedd att definiera ljudindata som ska användas av identifierarobjektet.

Parameterar

  • audioConfig Definierar ljudindata som ska användas av identifieraren.

Återlämning

En ny KeywordRecognizer som kommer att använda ljud från angivna indata.

Om ingen ljudkonfiguration tillhandahålls motsvarar det samtal med en konfiguration som är konstruerad med AudioConfig::FromDefaultMicrophoneInput