Dela via

class KeywordRecognizer

  • Artikel
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 kabelanslutna 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

Erkända

Syntax: public EventSignal< constKeywordRecognitionEventArgs & > Recognized;

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

Avbrutna

Syntax: public EventSignal< constSpeechRecognitionCanceledEventArgs & > 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 constPropertyCollection & Properties;

En samling egenskaper och deras värden som definierats för den 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 session för nyckelordsigenkänning. Den här sessionen varar tills det första nyckelordet identifieras. När detta inträffar aktiveras en identifierad händelse och sessionen avslutas. Om du vill rusta om nyckelordet måste metoden anropas igen efter att händelsen har genererats.

Parametrar

Returer

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

Observera att om inget nyckelord identifieras i indata kommer uppgiften aldrig att matcha (såvida inte StopRecognition anropas.

StopRecognitionAsync

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

Stoppar en aktiv session för nyckelordsigenkänning.

Returer

En framtid som löser när den aktiva sessionen (om sådan finns) 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 de ljudindata som ska användas av identifierarobjektet.

Parametrar

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

Returer

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

Om ingen ljudkonfiguration har angetts motsvarar den anropet med en config konstruerad med AudioConfig::FromDefaultMicrophoneInput